SuperAPI AI 工具集

git-guardrails-claude-code

编程与开发

查看项目

更新于 11-07 16:46

技能介绍

用途

该技能为 Claude Code 安装一套 Git 防护栏:通过 PreToolUse 钩子拦截并阻止危险 Git 命令,避免其在 Claude 执行前真正运行。拦截发生时,Claude 会看到提示,告知其无权访问这些命令。

主要能力

可阻止的危险命令包括:

  • git push(所有变体,包括 --force)
  • git reset --hard
  • git clean -f / git clean -fd
  • git branch -D
  • git checkout . / git restore .

使用方式

  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. 添加钩子到设置:项目设置写入 matcher 为 Bash 的 PreToolUse 钩子,命令为 "$CLAUDE_PROJECT_DIR"/.claude/hooks/block-dangerous-git.sh;全局设置命令为 ~/.claude/hooks/block-dangerous-git.sh。若设置文件已存在,应合并到现有 hooks.PreToolUse 数组中,不要覆盖其他设置。
  4. 询问自定义:询问用户是否需要增删拦截列表中的模式,并相应编辑复制后的脚本。
  5. 验证:运行 echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>,应退出码为 2,并向 stderr 打印 BLOCKED 消息。

适用场景

适用于希望在使用 Claude Code 时防止误执行破坏性 Git 操作的开发者,可按项目或全局范围统一配置。

限制

资料仅说明上述命令模式的拦截与配置流程;其他命令覆盖范围、跨平台兼容性及脚本内部实现细节暂未提供。