git-guardrails-claude-code 是什麼、怎麼用：給 Claude Code 裝上攔截危險 git 命令的 Hook

本文根據 mattpocock/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 45.1 萬次；所在倉庫 mattpocock/skills 在 GitHub 約 28.4 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

放手讓 Claude Code 自動執行命令，最怕的就是它一條 git reset --hard 把沒提交的工作抹掉，或者擅自 git push。git-guardrails-claude-code 用 Claude Code 的 Hook 機制加一道硬攔截。description：設定 Claude Code 的 Hook，在危險的 git 命令執行之前將其阻止；用戶想防止破壞性的 git 操作、添加 git 安全 Hook，或在 Claude Code 裏禁止 push / reset 時使用。

它設定的是一個 PreToolUse Hook——在工具調用真正發生之前運行。被攔截的命令清單是：

• git push（所有變體，包括 --force）；
• git reset --hard；
• git clean -f / git clean -fd；
• git branch -D；
• git checkout . / git restore .。

命令被攔下時，Claude 會收到一條消息，告訴它沒有權限使用這些命令。

安裝過程是技能帶着你做的五步：問你裝到當前項目（.claude/settings.json）還是所有項目（~/.claude/settings.json）→ 把目錄裏自帶的 block-dangerous-git.sh 複製到對應的 hooks 目錄並加上可執行權限 → 在設定文件裏登記這個 Hook → 問你要不要增減攔截規則 → 驗證是否生效。

怎麼安裝

git-guardrails-claude-code 隨 mattpocock/skills 整套安裝。Claude Code 用插件（命令來自倉庫 README）：

text
claude plugin install mattpocock-skills@claude-plugins-official

Codex 先 codex plugin marketplace add mattpocock/skills 再 codex plugin add mattpocock-skills@mattpocock；Cursor、OpenCode 等用 npx skills@latest add mattpocock/skills，在列表裏勾選需要的技能。README 提醒兩點：插件和 skills.sh 兩種方式每個工具只選一種，否則每個技能會出現兩份；勾選時帶上 setup-matt-pocock-skills，並在每個倉庫裏先運行一次，它會問你用哪個 issue 跟蹤器、分診用哪些標籤、文檔存在哪裏——庫裏不少技能依賴這份配置，也會互相調用。

倉庫整體介紹和其他安裝方式，詳見本站《mattpocock/skills 是什麼、怎麼安裝：Matt Pocock 的工程師 Skills（grill-me、tdd、to-spec）》。

怎麼用

• 對 Claude Code 說「幫我設定 git guardrails」，按提問選擇作用範圍。
• 「把 git commit --amend 也加進攔截清單」——第四步支持自定義。
• 裝好後可以故意讓它執行一次 git push 試試，應當被拒絕並說明原因。

適合誰 / 侷限

適合開着自動批准模式、或經常讓 Claude Code 長時間自主運行的人，也適合給團隊倉庫統一加一層保護。它只對 Claude Code 生效，其他智能體有各自的權限機制；攔截基於命令文本匹配，屬於防誤操作的護欄，不是安全邊界——別指望它擋住所有繞行寫法。你自己需要推送時，在終端裏手動執行即可。

注意事項

• 許可：MIT。
• 會修改 Claude Code 的設定文件並放置一個 shell 腳本：腳本很短，建議裝之前讀一遍。
• Hook 是一個 shell 腳本，Windows 用戶要確認 Claude Code 所在環境能運行它（例如通過 Git Bash 或 WSL）。
• 這是庫裏可以由模型自動觸發的技能。