リポジトリは、フォルダを開いた瞬間にコーディングエージェントにコードを実行させることができます。GuardSkill は、あなたが開く前にそれをチェックします。
npx guardskill .
読み取り専用。ネットワーク呼び出し、テレメトリ、設定、アカウント、依存関係は一切なし。git の設定とフックスクリプトを読み取り、見つかった内容を出力して終了します。
コーディングエージェントは、プロジェクトを開くとすぐに git status や git diff といった通常の git コマンドを実行してコンテキストを収集します。git はリポジトリ自身の .git/config から設定を読み込み、そのうち約20数個の設定は git が実行するプログラムを指定するものです。core.fsmonitor にコマンドを仕込めば、あなたが何も入力する前に、あなたの権限で、あらゆるサンドボックスの外側で実行されます。
この点を具体的に示す公開研究が2件あります。
.git/config はクローンでは転送されないからです。リポジトリは、.git ディレクトリをすでに内包したファイル群として届く必要があります — zip、共有ドライブ、同期フォルダ、USB メモリ、アーカイブを展開するエージェントなどです。(Manifold Security、The Hacker News)@github/copilot 1.0.43 で safe.bareRepository=explicit を強制することで修正されました。(GitHub Advisory)両方の記事で推奨されているユーザー側の緩和策は同じです。エージェントでディレクトリを開く前に git の設定を検査すること。 ツリー全体にわたって手作業で行うのは面倒です。このツールはそれを1秒で行います。
git の攻撃ベクトルには1つ救いがあります。クローンは .git/config を運ばないため、リポジトリはファイルとして届く必要があるのです。エージェントの設定にはそのような要件はありません。.mcp.json、.claude/settings.json、.vscode/mcp.json は通常の追跡対象ファイルであり、他のファイルと同様に git clone で届きます。そしてコーディングエージェントはプロジェクトを開くときにそれを読み込みます。MCP サーバーのエントリはプログラムを指定し、エージェントはそれを起動します。フックはコマンドを指定し、エージェントはイベント発生時にそれを実行します。権限設定は、エージェントが最初にあなたに確認するステップを無効にできます。
これらが実際にどれほど慎重に設定されているかは、1つの外部の数字が示しています。Bloomberry は2026年2月に企業がホストする MCP サーバー1,412台を測定し、38.7% が認証を一切備えていないことを発見しました(半年前の425台から増加)。これらはあなたのリポジトリ内のサーバー定義ではなく公開エンドポイントであり、別の母集団ですが、同じエコシステムであり、これらの設定がどれほど注意を払われているかを物語っています。(Bloomberry)
数字を出さずに率直に言うべきもう1点があります。「誰かがこれを見つける」から「誰かがこれを悪用する」までの隔たりは縮まっています。なぜなら、発見と悪用がますます同じ自動化された仕組みによって行われるようになっているからです。これは、ディレクトリを開く前に確認すべき理由であって、レポートの特定の行について慌てる理由ではありません。だからこそ GuardSkill は個々の知見に悪用までの時間に関する主張を付けません。知りようがないからです。
エージェントが拾い得るあらゆる 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。どちらのクラスもディレクトリツリーの1回の走査で見つかり、2つ目には追加コストがかかりません。
キーごとの完全なリストは、それぞれのソースとカバレッジ状況とともに 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 という名前のディレクトリ |
4つのキーは意図的にスコープ外とされており、それぞれの理由はインベントリに記載されています: sendemail.smtpServer、instaweb.httpd、ssh.variant、および HTTP プロキシ設定です。だからこそこの README は、脆弱性クラス全体をカバーしていると主張するのではなく、チェック内容を列挙しているのです — その主張が真になるのは、その列が空になったときだけです。
2つ目のクラスは、rules/agent-settings-inventory.md に独自のインベントリを持ち、同じドリフトテストに支えられています。
| チェック | 重大度 |
|---|---|
PATH から起動される MCP サーバー(npx、uvx、node、docker) | low — 情報提供。ほとんどの MCP サーバーはこのように設定されています |
| コマンドがツリー内のパスである、または引数がツリー内のファイルを指している | high |
コマンドがシェルである、コードをダウンロードして実行する、または /tmp や隠しディレクトリに存在する | critical |
headers または env に認証情報が含まれていない状態で宣言されたリモートサーバー | medium |
| エージェントイベントでコマンドを実行するフック | 上記と同じ段階 — npx prettier --write は情報提供、ツリー内のスクリプトは high、シェルパイプラインは critical |
承認ステップをスキップする要求(bypassPermissions) | high、検出結果にはクライアントが実際にそれをどう扱うかが記載されます |
| スキャナが認識しない形式のサーバーエントリ | medium — 理解されていないことは、存在しないこととは異なります |
permissions.allow 内のワイルドカード | high |
| 認証情報の形をした値 | high |
あなた自身のプロジェクトが独自の MCP サーバーを同梱している場合、そのエントリは high で報告されます — 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 シンボリックリンクによってそのガードを失うというものでした。公開されているバイナリだけがスキャンを開始できるようになり、パッケージングテストが3つのプラットフォームすべてでそれを検証しています。
これらは2つの異なる答えであり、ツールは両方を報告します。JSON 内の status は何が見つかったかを示します。終了コード は、設定したしきい値に照らして、それが失敗とするのに十分に深刻かどうかを示します。
status | 意味 |
|---|---|
CLEAN | 検出結果がゼロで、ツリー全体が検査された |
FINDINGS | しきい値を下回るものを含め、いずれかの重大度で少なくとも1件の検出結果がある |
INCOMPLETE | 検出結果はないが、ツリーの一部が検査されなかった |
ERROR | スキャンが実行されなかった |
| コード | 意味 |
|---|---|
0 | --fail-on 以上に該当するものがなく、ツリー全体が検査された |
1 | --fail-on(デフォルト: high)以上の検出結果がある |
2 | スキャンを実行できなかった: 不正なパス、不正なオプション、無効なルールセット |
3 | ツリーの一部が検査されなかった — 切り詰められた走査、拒否されたシンボリックリンク、ツリー外のインクルード |
つまり、中程度の検出結果が1件あり、デフォルトのしきい値を使用しているリポジトリは、status: FINDINGS を報告し、0 で終了します。この組み合わせは意図的なものです。終了コード 0 はポリシー上の答えであり、JSON を読む利用者は判断する前に何が見つかったかを確認できなければなりません。CLEAN は検出結果がゼロで、それ以外に何もないことを意味します。
--fail-on は重大度のしきい値を変更するだけで、それ以外には何も影響しません — レポートから検出結果を削除することは決してありません。完全性はまた別の軸です。不完全なスキャンは、--allow-incomplete を渡さない限り失敗します。なぜなら「そこを調べなかった」ことは「そこに何もない」こととは同じではないからです。
--json を指定した場合、失敗も JSON で応答します。同じフィールドを持つエラードキュメントで、status: "ERROR"、scanned: false、そして理由が reason に含まれるため、パーサーにパイプする利用者はパースエラーではなく診断情報を得られます。人間が読める形式の理由も stderr に出力されます。
CI では:
- name: Check for git execution vectors
run: npx guardskill . --fail-on high
または、バージョンを固定してくれるアクションとしても使えます: