mcpField
G
git-guardrails-claude-code

git-guardrails-claude-code

github.com/devcxlエージェントワークフロー51566 回インストール今日更新
リポジトリ

git-guardrails-claude-code について

git-guardrails-claude-code は、Claude Code 用の Git ガードを設定し、危険なコマンドの実行前に検知してブロックします。プロジェクト単位またはグローバルに導入でき、既存設定との統合やブロック対象パターンの変更にも対応します。

主な機能

  1. 01危険な Git コマンドの検知とブロック
  2. 02プロジェクト単位または全体への導入
  3. 03PreToolUse フックの設定
  4. 04既存フック設定の維持と統合
  5. 05ブロックするコマンドパターンの変更

活用シーン

  1. 01Claude による git push のブロック
  2. 02ハードリセットや強制クリーンの防止
  3. 03単一または全プロジェクトへのガード設定

インストール

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

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

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

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

詳細

プロジェクトの README より

设置 Git 护栏

设置一个 PreToolUse 钩子，在 Claude 执行危险 Git 命令之前拦截并阻止它们。

会被阻止的命令

  • 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，并向 stderr 打印一条 BLOCKED 消息。

コメント

Markdown 対応