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 是一个用于设置 PreToolUse 钩子的技能，可在 Claude 执行前阻止危险的 git 命令。它可安装到单个项目或全局范围，适合希望限制破坏性 git 操作的用户。

主要功能

  1. 01阻止 git push 及其变体（包括 --force）
  2. 02阻止 git reset --hard 与 git clean -f
  3. 03阻止 git branch -D 与丢弃全部改动的 checkout 或 restore
  4. 04支持项目级或全局级安装
  5. 05合并已有的 settings.json 配置而不覆盖

适用场景

  1. 01防止编码 Agent 误推送代码到远程仓库
  2. 02限制 Claude 执行破坏性的 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 防护

设置一个 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