用途
该技能为 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 .
使用方式
- 选择范围:询问用户是仅为本项目安装(.claude/settings.json),还是为所有项目安装(~/.claude/settings.json)。
- 复制钩子脚本:脚本位于 scripts/block-dangerous-git.sh,按范围复制到 .claude/hooks/block-dangerous-git.sh(项目)或 ~/.claude/hooks/block-dangerous-git.sh(全局),并用 chmod +x 赋予可执行权限。
- 添加钩子到设置:项目设置写入 matcher 为 Bash 的 PreToolUse 钩子,命令为 "$CLAUDE_PROJECT_DIR"/.claude/hooks/block-dangerous-git.sh;全局设置命令为 ~/.claude/hooks/block-dangerous-git.sh。若设置文件已存在,应合并到现有 hooks.PreToolUse 数组中,不要覆盖其他设置。
- 询问自定义:询问用户是否需要增删拦截列表中的模式,并相应编辑复制后的脚本。
- 验证:运行 echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>,应退出码为 2,并向 stderr 打印 BLOCKED 消息。
适用场景
适用于希望在使用 Claude Code 时防止误执行破坏性 Git 操作的开发者,可按项目或全局范围统一配置。
限制
资料仅说明上述命令模式的拦截与配置流程;其他命令覆盖范围、跨平台兼容性及脚本内部实现细节暂未提供。