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
- 参考文档agents/openai.yaml109 B
- 脚本scripts/block-dangerous-git.sh494 B
03 SKILL.md 正文
设置 Git 防护措施
设置一个 PreToolUse 钩子,在 Claude 执行危险的 git 命令前将其拦截并阻止。
会阻止哪些命令
git push(包括--force在内的所有变体)git reset --hardgit clean -f/git clean -fdgit branch -Dgit 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
writing-great-skills
出色编写和编辑技能的参考资料——让技能具备可预测性的词汇与原则。
teach
在此工作区内向用户教授新的技能或概念。
handoff
将当前对话压缩成交接文档,以便另一个智能体接手。
grilling
围绕计划、决策或想法对用户进行不留情面的深度追问。当用户想对自己的思路进行压力测试,或使用任何“深度追问”触发措辞时使用。
grill-me
通过不留情面的深度追问打磨计划或设计。
obsidian-vault
使用 wikilink 和索引笔记搜索、创建和管理 Obsidian 仓库中的笔记。当用户想要在 Obsidian 中查找、创建或整理笔记时使用。