工程開發
Writing Hookify Rules avatar

Writing Hookify Rules

建立並設定 Hookify 規則,以監控檔案、Bash 指令或使用者提示中的特定模式。

簡介

Hookify Rules 是一項專業工具,用於定義 Claude Code 內的防護機制與自動化回應。開發者可以建立包含 YAML 前言的 Markdown 檔案,即時監控 bash 指令執行、檔案編輯寫入,以及代理程式的生命週期事件(如停止或提示提交)。此工具對於落實特定儲存庫的程式碼規範、防止危險程式碼模式,或在開發流程中提供情境引導至關重要。

  • 使用 Python 正規表達式語法定義規則模式,針對指令、檔案路徑或內容片段進行細緻比對。

  • 支援多種事件類型:bash、file、stop、prompt 及 all,提供靈活的觸發條件設定。

  • 透過多條件欄位提供進階設定,包含 regex_match、contains、equals、not_contains、starts_with 及 ends_with。

  • 透過明確的動作模式實現反應式自動化:使用 'warn' 進行提示,或使用 'block' 阻止不安全的操作 (PreToolUse)。

  • 與 Claude Code 檔案系統整合,設定檔儲存於 .claude/hookify.{rule-name}.local.md,便於版本控制並透過 enabled 布林值旗標開關規則。

  • 規則非常適合捕獲常見隱患,例如 .env 檔案中硬編碼的 API 金鑰、危險的 bash 指令如 rm -rf,或生產環境中不適當的 console.log。

  • 透過在 Markdown 中定義自訂訊息,為代理程式提供具體且有幫助的反饋,解釋問題並建議最佳實踐。

  • 使用工具提供的 Python 測試技巧在正式部署規則前驗證正規表達式。

  • 非常適合需要強制執行專案安全政策與編碼規範,但不想從頭開發外掛的團隊負責人與基礎架構工程師。

  • 請注意,進階設定中的所有條件必須同時成立才會觸發規則,這允許進行高度精確的安全強制執行。

倉庫統計

Star 數
119,460
Fork 數
19,809
Open Issue 數
10,822
主要語言
Shell
預設分支
main
同步狀態
閒置
最近同步時間
2026年4月30日 下午04:06
在 GitHub 查看