mcpField
G
git-guardrails-claude-code

git-guardrails-claude-code

github.com/mattpocock開発305.7k513.0k 回インストール1 日前に更新
リポジトリ

git-guardrails-claude-code について

git-guardrails-claude-code は、Claude が危険な git コマンドを実行する前に遮断する PreToolUse フックを設定するスキルです。単一プロジェクトまたはグローバルに導入でき、既存の設定とマージします。破壊的な git 操作を制限したい利用者に向いています。

主な機能

  1. 01--force を含む git push を遮断
  2. 02git reset --hard と git clean -f を遮断
  3. 03git branch -D と変更破棄の checkout・restore を遮断
  4. 04プロジェクト単位またはグローバルに導入
  5. 05既存の設定を上書きせずにマージ

活用シーン

  1. 01コーディングエージェントによるリモートへの push を防止
  2. 02Claude による破壊的な git クリーンアップの制限
  3. 03チームプロジェクトへの git 安全フックの適用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mattpocock/skills --skill git-guardrails-claude-code

インストール後、Claude Code で/git-guardrails-claude-codeを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlscripts/block-dangerous-git.sh

詳細

Git ガードレールを設定する

Claude が危険な git コマンドを実行する前にインターセプトしてブロックする、PreToolUse フックを設定します。

ブロックされるコマンド

  • git push（--force を含むすべてのバリエーション）
  • git reset --hard
  • git clean -f / git clean -fd
  • git branch -D
  • git checkout . / git restore .

ブロックされると、Claude にはこれらのコマンドにアクセスする権限がないことを伝えるメッセージが表示されます。

手順

1. 適用範囲を確認する

ユーザーに、このプロジェクトのみ（.claude/settings.json）にインストールするか、すべてのプロジェクト（~/.claude/settings.json）にインストールするかを尋ねます。

2. フックスクリプトをコピーする

同梱のスクリプトは次の場所にあります：scripts/block-dangerous-git.sh

適用範囲に応じて、コピー先にスクリプトをコピーします。

  • プロジェクト：.claude/hooks/block-dangerous-git.sh
  • グローバル：~/.claude/hooks/block-dangerous-git.sh

chmod +x を使って実行可能にします。

3. フックを設定に追加する

該当する設定ファイルに追加します。

プロジェクト（.claude/settings.json）：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh"
          }
        ]
      }
    ]
  }
}

グローバル（~/.claude/settings.json）：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/block-dangerous-git.sh"
          }
        ]
      }
    ]
  }
}

設定ファイルがすでに存在する場合は、既存の hooks.PreToolUse 配列にフックを統合します。他の設定を上書きしないでください。

4. カスタマイズするか確認する

ブロック対象の一覧にパターンを追加または削除するか、ユーザーに尋ねます。必要に応じてコピーしたスクリプトを編集します。

5. 動作を確認する

簡単なテストを実行します。

echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>

終了コード 2 で終了し、標準エラー出力に BLOCKED メッセージが表示されるはずです。

コメント

Markdown 対応