mcpField
G
git-guardrails-claude-code

git-guardrails-claude-code

github.com/vinvcnエージェントワークフロー5.4k5.5k 回インストール1 日前に更新
リポジトリ

git-guardrails-claude-code について

git-guardrails-claude-codeは、PreToolUseフックで指定された危険なコマンドを遮断する、Claude Code向けGitガードレールの設定スキルです。プロジェクト単位または全体に導入でき、遮断パターンも変更できます。

主な機能

  1. 01指定された危険なGitコマンドの遮断
  2. 02プロジェクト単位または全体への導入
  3. 03既存フック設定との統合
  4. 04コマンド遮断リストのカスタマイズ
  5. 05フックスクリプトのテスト

活用シーン

  1. 01Claudeによる強制プッシュの防止
  2. 02ハードリセットやファイル削除の阻止
  3. 03複数プロジェクトへのGitガード設定

インストール

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

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

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

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

README（原文）English

プロジェクトの README より

この README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。

设置 Git Guardrails

设置一个 PreToolUse hook，在 Claude 执行危险 git commands 前拦截并阻止它们。

会被阻止的命令

  • git push（包括 --force 在内的所有 variants）
  • git reset --hard
  • git clean -f / git clean -fd
  • git branch -D
  • git checkout . / git restore .

被阻止时，Claude 会看到一条 message，说明它无权访问这些 commands。

步骤

1. 询问安装范围

询问用户：只为当前 project 安装（.claude/settings.json），还是为所有 projects 安装（~/.claude/settings.json）？

2. 复制 hook 脚本

bundled script 位于：scripts/block-dangerous-git.sh

根据 scope 复制到目标位置：

  • Project: .claude/hooks/block-dangerous-git.sh
  • Global: ~/.claude/hooks/block-dangerous-git.sh

用 chmod +x 让它可执行。

3. 把 hook 加入 settings

添加到对应 settings file：

Project (.claude/settings.json):

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

Global (~/.claude/settings.json):

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

如果 settings file 已存在，把 hook merge 到现有 hooks.PreToolUse array 中，不要覆盖其他 settings。

4. 询问是否定制

询问用户是否要在 blocked list 中添加或移除 patterns。相应编辑复制后的 script。

5. 验证

运行快速测试：

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

应以 code 2 退出，并向 stderr 打印 BLOCKED message。

コメント

Markdown 対応