git-guardrails-claude-code
设置 Claude Code hooks,在危险的 git 命令(push、reset --hard、clean、branch -D 等)执行前拦截它们。当用户想防止破坏性 git 操作、添加 git 安全 hook,或在 Claude Code 中阻止 git push/reset 时使用。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- git-guardrails-claude-code
- description
- 设置 Claude Code hooks,在危险的 git 命令(push、reset --hard、clean、branch -D 等)执行前拦截它们。当用户想防止破坏性 git 操作、添加 git 安全 hook,或在 Claude Code 中阻止 git push/reset 时使用。
- commit_version
- 321658273cb1d20b76026717d027d505790106d4
02 资源文件 2
- 参考文档agents/openai.yaml110 B
- 脚本scripts/block-dangerous-git.sh507 B
03 SKILL.md 正文
设置 Git 护栏
设置一个 PreToolUse hook,在 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. 复制 hook 脚本
随附脚本位于:scripts/block-dangerous-git.sh
按范围复制到目标位置:
- 项目:
.claude/hooks/block-dangerous-git.sh - 全局:
~/.claude/hooks/block-dangerous-git.sh
用 chmod +x 赋予可执行权限。
3. 把 hook 加入 settings
添加到对应的 settings 文件:
项目(.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"
}
]
}
]
}
}
如果 settings 文件已存在,把 hook 合并进现有的 hooks.PreToolUse 数组。不要覆盖其他设置。
4. 询问定制需求
问用户是否想在阻止列表中增加或移除任何模式。相应编辑复制后的脚本。
5. 验证
跑一个快速测试:
echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>
应以退出码 2 退出,并向 stderr 打印一条 BLOCKED 消息。
04 同仓库更多 Skills
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。