
코딩 에이전트(Claude Code, Codex, Cursor, Copilot)에서 저장소가 코드를 실행할 수 있게 하는 요소를 검사하는 읽기 전용 스캐너: git 설정, 훅, 그리고 커밋된 MCP 서버 정의 및 에이전트 설정. SARIF 출력. 의존성 없음, 네트워크 없음, 텔레메트리 없음.
저장소를 열기만 해도 코딩 에이전트가 코드를 실행하게 만들 수 있습니다. GuardSkill은 당신이 그렇게 하기 전에 이를 검사합니다.
npx guardskill .
읽기 전용입니다. 네트워크 호출, 텔레메트리, 구성, 계정, 의존성이 없습니다. git 구성과 훅 스크립트를 읽고, 발견한 내용을 출력한 뒤 종료합니다.
코딩 에이전트는 프로젝트를 열자마자 git status, git diff 같은 평범한 git 명령을 실행하여 컨텍스트를 수집합니다. Git은 저장소 자체의 .git/config에서 설정을 읽으며, 그중 대략 24개 정도의 설정은 git이 실행할 프로그램을 지정합니다. core.fsmonitor에 명령을 넣으면, 사용자가 아무것도 입력하기 전에, 샌드박스 밖에서, 사용자의 권한으로 실행됩니다.
이를 구체적으로 보여주는 공개 연구 두 가지가 있습니다:
.git/config는 복제 시 전송되지 않기 때문입니다. 저장소는 .git 디렉터리가 이미 포함된 파일 형태로 도착해야 합니다 — zip, 공유 드라이브, 동기화 폴더, USB 스틱, 아카이브를 푸는 에이전트 등. (Manifold Security, The Hacker News)@github/copilot 1.0.43에서 safe.bareRepository=explicit을 강제하여 수정되었습니다. (GitHub Advisory)두 보고서에서 권장하는 사용자 측 완화책은 동일합니다: 에이전트로 디렉터리를 열기 전에 git 구성을 검사하십시오. 트리 전체에 걸쳐 이를 수작업으로 하는 것은 번거롭습니다. 이 도구는 1초 만에 처리합니다.
git 벡터에는 한 가지 구제책이 있습니다: 복제는 .git/config를 전달하지 않으므로 저장소가 파일 형태로 도착해야 한다는 점입니다. 에이전트 설정에는 그런 요구 사항이 없습니다. .mcp.json, .claude/settings.json, .vscode/mcp.json은 평범한 추적 파일입니다 — 다른 파일과 마찬가지로 git clone과 함께 도착합니다 — 그리고 코딩 에이전트는 프로젝트를 열 때 이를 읽습니다. MCP 서버 항목은 프로그램을 지정하고 에이전트가 이를 시작합니다; 훅은 명령을 지정하고 에이전트가 이벤트 발생 시 이를 실행합니다; 권한 설정은 에이전트가 먼저 사용자에게 묻는 단계를 끌 수 있습니다.
실제로 이것들이 얼마나 신중하게 구성되는지는 외부 수치 하나로 알 수 있습니다. Bloomberry는 2026년 2월에 회사가 호스팅하는 MCP 서버 1,412개를 측정했고, 38.7%가 인증이 전혀 없음을 발견했습니다. 이는 6개월 전의 425개 서버에서 증가한 수치입니다. 이는 저장소 내의 서버 정의가 아니라 공개 엔드포인트로, 다른 모집단이지만 같은 생태계이며, 이러한 구성이 얼마나 주의를 받는지에 대해 시사하는 바가 있습니다. (Bloomberry)
숫자를 붙이지 않고 분명히 말할 만한 점이 하나 더 있습니다: "누군가 이것을 발견하는 것"과 "누군가 이것을 사용하는 것" 사이의 간격이 좁아지고 있습니다. 발견과 사용이 점점 동일한 자동화 기계에 의해 이루어지기 때문입니다. 이는 특정 보고서의 특정 줄에 대해 당황할 이유가 아니라, 디렉터리를 열기 전에 살펴볼 이유입니다 — 이것이 GuardSkill이 개별 발견 사항에 익스플로잇까지 걸리는 시간(time-to-exploit) 주장을 붙이지 않는 이유입니다. 알 수 없기 때문입니다.
에이전트가 가져올 수 있는 모든 git 구성이며, 명백한 것만이 아닙니다: 프로젝트 자체의 .git, 콘텐츠로 도착한 중첩된 .git, 하위 디렉터리에 숨겨진 베어 저장소, 서브모듈이나 연결된 워크트리가 남기는 .git 파일, config.worktree, 모든 .git/modules/<name>/config, 그리고 트리 내부에 있는 include.path를 통해 끌어온 모든 파일.
그리고 저장소가 제공할 수 있는 에이전트 설정 파일들: 트리 어디에든 있는 .mcp.json, .claude/settings.json과 settings.local.json, .vscode/mcp.json, .cursor/mcp.json, .gemini/settings.json, .windsurf/mcp.json. 두 부류 모두 디렉터리 트리를 한 번 순회할 때 발견되며, 두 번째 부류는 추가 비용이 들지 않습니다.
각 항목에 대한 출처와 커버리지 상태를 포함한 전체 목록은 키별로 rules/git-exec-keys-inventory.md에 있습니다. 해당 인벤토리와 규칙 집합이 어긋나면 테스트가 실패하므로, 이 목록은 희망 사항이 아니라 감사 가능한 것입니다. 요약하면 다음과 같습니다:
| 분류 | 검사 항목 |
|---|---|
| 일반 명령에서 실행됨 | core.fsmonitor, core.pager, pager.<cmd>, core.editor, sequence.editor, diff.external, core.askPass, core.alternateRefsCommand |
| 네트워크 작업에서 실행됨 | core.sshCommand, core.gitProxy, remote.<n>.uploadPack / receivePack, uploadpack.packObjectsHook |
.gitattributes를 통해 실행됨 | filter.<d>.clean / .smudge / .process, diff.<d>.textconv, merge.<d>.driver |
| 요청 시 실행됨 | mergetool / difftool / browser / guitool / man .cmd, credential.helper, gpg.program, trailer.<t>.command, 셸을 호출하거나 -c로 git을 다시 진입시키는 모든 alias.* |
| 나중에 설정을 도입함 | include.path, includeIf.*.path (따라가서 검사함), init.templateDir |
| 실행하는 전송 방식 | protocol.allow, ext::를 사용하는 원격 및 서브모듈 URL |
| 훅 | core.hooksPath, .git/hooks의 활성 스크립트, 코드를 다운로드하거나 디코딩하는 훅 스크립트, 심볼릭 링크인 훅 스크립트 |
| 구조 | 트리 내의 베어 저장소, 등록된 서브모듈이 아닌 중첩된 .git 디렉터리, 다른 대소문자로 명명된 .git 디렉터리 |
네 개의 키는 인벤토리에 각각의 이유와 함께 의도적으로 범위 밖입니다: sendemail.smtpServer, instaweb.httpd, ssh.variant, 그리고 HTTP 프록시 설정. 이것이 바로 이 README가 전체 취약점 클래스를 다룬다고 주장하는 대신 검사 항목을 나열하는 이유입니다 — 그 주장은 해당 열이 비어 있을 때만 참이 될 것입니다.
두 번째 부류로, rules/agent-settings-inventory.md에 자체 인벤토리가 있으며 동일한 드리프트 테스트가 뒷받침합니다.
| 검사 항목 | 심각도 |
|---|---|
PATH에서 시작되는 MCP 서버 (npx, uvx, node, docker) | 낮음 — 정보성. 대부분의 MCP 서버가 이렇게 구성됨 |
| 명령이 트리 내부의 경로이거나, 인자가 트리 내부의 파일을 지목함 | 높음 |
명령이 셸이거나, 코드를 다운로드하여 실행하거나, /tmp 또는 숨겨진 디렉터리에 위치함 | 치명적 |
headers 또는 env에 자격 증명 자료 없이 선언된 원격 서버 | 중간 |
| 에이전트 이벤트에서 명령을 실행하는 훅 | 위와 동일한 사다리 — npx prettier --write는 정보성, 트리에서 온 스크립트는 높음, 셸 파이프라인은 치명적 |
승인 단계를 건너뛰라는 요청 (bypassPermissions) | 높음, 발견 사항에 클라이언트가 실제로 이를 어떻게 처리하는지 명시 |
| 스캐너가 인식하지 못하는 형태의 서버 항목 | 중간 — 이해하지 못한 것은 없는 것과 다름 |
permissions.allow의 와일드카드 | 높음 |
| 자격 증명 형태의 값 | 높음 |
자체 프로젝트가 자체 MCP 서버를 제공하는 경우, 해당 항목은 높음으로 보고됩니다 — GuardSkill은 당신이 작성한 저장소와 넘겨받은 저장소를 구별할 수 없습니다. --fail-on critical을 사용하거나 해당 경로를 --exclude하십시오.
그리고 반대의 경우도 있습니다: 넘겨받은 트리는 --fail-on low로 스캔하십시오. npx -y @attacker/mcp-helper로 시작되는 서버는 설계상 정보성입니다 — 명령은 평범하고 패키지 이름이 공격의 전부이며, 패키지를 이름으로 판단하는 것은 네트워크가 필요한 레지스트리 평판 문제입니다. 기본 임계값은 이에 대해 실패하지 않습니다. 그 기본값은 CI에서의 자체 저장소에 맞춰 조정된 것이며, 전달받은 디렉터리는 다른 문제이므로 더 낮은 임계값과 목록 검토가 필요합니다.
acceptEdits와 plan은 보고되지 않습니다. 문서에는 acceptEdits가 허용하는 범위가 명확히 나와 있습니다. 즉 읽기, 파일 편집, 일반적인 파일시스템 명령이며, Bash와 네트워크는 여전히 프롬프트를 띄웁니다. 따라서 이를 승인 우회라고 부르는 것은 사실에 비추어 틀린 것이며, 이는 가장 많이 사용되는 설정 중 하나입니다.
의도적으로 확인하지 않는 것: 원격 MCP 서버가 실제로 인증을 요구하는지 여부입니다. 이는 해당 서버에 연결해야만 알 수 있으며, 이 도구는 네트워크 연결을 전혀 하지 않습니다. mcp-remote-no-auth 발견 항목은 파일이 선언한 내용을 보고하며, 그 사실을 자체 텍스트에 명시합니다.
npx guardskill . # scan the current project
npx guardskill ~/code/some-project # scan a specific path
npx guardskill . --json # machine-readable
npx guardskill . --out report.md # also write a Markdown report
npx guardskill . --fail-on critical # only fail the build on critical findings
npx guardskill . --allow-incomplete # accept a partial walk
npx guardskill . --exclude test/fixtures
npx guardskill . --sarif-out results.sarif # for GitHub code scanning
또는 한 번만 설치하세요: npm install -g guardskill, 그다음 guardskill ..
클론에서 진입점은 node bin/guardskill.js입니다. src/는 라이브러리이므로 실행해도
아무 일도 일어나지 않으며, 이는 의도된 것입니다. 첫 번째 릴리스 후보에 포함되었던 버그는
자신의 실행을 가드하는 CLI였는데 npm의 bin 심볼릭 링크 때문에 그 가드를 잃었습니다.
이제 게시된 바이너리만이 스캔을 시작하며, 패키징 테스트가 세 플랫폼 모두에서 이를 구동합니다.
이 둘은 서로 다른 답이며 도구는 둘 다 보고합니다. JSON의 status는 무엇이 발견되었는지를 나타냅니다. 종료 코드는 설정한 임계값에 비추어 그것이 실패로 처리할 만큼 심각한지를 나타냅니다.
status | 의미 |
|---|---|
CLEAN | 발견 사항이 없고, 전체 트리가 검사됨 |
FINDINGS | 임계값 미만인 것을 포함하여, 어떤 심각도든 최소 하나의 발견 사항이 있음 |
INCOMPLETE | 발견 사항은 없지만, 트리의 일부가 검사되지 않음 |
ERROR | 스캔이 실행되지 않음 |
| 코드 | 의미 |
|---|---|
0 | --fail-on 이상인 항목이 없고, 전체 트리가 검사됨 |
1 | --fail-on(기본값: high) 이상의 발견 사항이 있음 |
2 | 스캔을 실행할 수 없음: 잘못된 경로, 잘못된 옵션, 유효하지 않은 규칙 집합 |
3 | 트리의 일부가 검사되지 않음 — 잘린 순회, 거부된 심볼릭 링크, 트리 외부의 include |
따라서 medium 발견 사항 하나와 기본 임계값을 가진 저장소는 status: FINDINGS를 보고하고 0으로 종료합니다. 이 조합은 의도된 것입니다. 종료 코드 0은 정책에 대한 답이며, JSON을 읽는 소비자는 결정을 내리기 전에 무엇이 발견되었는지 여전히 볼 수 있어야 합니다. CLEAN은 발견 사항이 0개이고 그 외에는 아무것도 아님을 의미합니다.
--fail-on은 심각도 임계값만 이동시키며 그 외에는 아무것도 하지 않습니다 — 보고서에서 발견 사항을 제거하지는 않습니다. 완전성은 또 다른 별개의 축입니다. 불완전한 스캔은 --allow-incomplete를 전달하지 않는 한 실패합니다. 왜냐하면 "우리가 그곳을 보지 않았다"는 "그곳에 아무것도 없다"와 같지 않기 때문입니다.
--json을 사용하면 실패도 JSON으로 응답합니다. 동일한 필드를 가진 오류 문서로, status: "ERROR", scanned: false, 그리고 reason에 사유가 담기므로, 파서로 파이프하는 소비자는 파싱 오류 대신 진단을 받습니다. 사람이 읽을 수 있는 사유도 stderr로 출력됩니다.
CI에서: