SuperAPI AI 工具集

git-guardrails-claude-code

编程与开发

查看项目

更新于 10-15 10:24

技能介绍

用途

git-guardrails-claude-code 用于为 Claude Code 设置 git 安全护栏。它通过配置一个 PreToolUse 钩子,在 Claude 执行命令之前进行拦截,阻止危险的 git 命令运行。适用场景是用户希望防止(Claude)执行破坏性或高风险的 git 操作。

主要能力:被阻止的命令

该技能会阻止以下 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 消息。

限制

资料中未提供该技能的价格、平台支持、更多拦截规则细节或其它限制说明,相关内容暂未提供。