AGENT SKILL

git-guardrails-claude-code

设置 Claude Code 钩子,在危险的 git 命令(push、reset --hard、clean、branch -D 等)执行前将其阻止。当用户想要防止破坏性 git 操作、添加 git 安全钩子,或在 Claude Code 中阻止 git push/reset 时使用。

License 许可
MIT
最近更新
2026-07-23
Stars
★ 1
Forks
0

01 前言 Front Matter

name
git-guardrails-claude-code
description
设置 Claude Code 钩子,在危险的 git 命令(push、reset --hard、clean、branch -D 等)执行前将其阻止。当用户想要防止破坏性 git 操作、添加 git 安全钩子,或在 Claude Code 中阻止 git push/reset 时使用。

02 资源文件 2

03 SKILL.md 正文

设置 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 消息。

04 同仓库更多 Skills