Skip to content

SKILL.md

Latest commit

 

History

History
95 lines (69 loc) · 2.23 KB

SKILL.md

File metadata and controls

95 lines (69 loc) · 2.23 KB
Raw
name git-guardrails-claude-code
description 设置 Claude Code 钩子以在执行之前阻止危险的 git 命令（push、reset --hard、clean、branch -D 等）。当用户想要防止破坏性 git 操作、添加 git 安全钩子或在 Claude Code 中阻止 git push/reset 时使用。

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