CLAUDE.md 寫了老半天，結果 AI 還是照樣忘記跑測試，看到這句我整個點頭如搗蒜。原來問題不是我不會寫指令，是根本用錯工具！這支影片把 Hooks 講得超白話，用便利商店自動門比喻，連三層架構都拆成三個問題，看完終於搞懂怎麼讓 AI 乖乖聽話。

1. 00:00上一支影片教的 CLAUDE.md 只是提醒紙條，AI 不一定會遵守
2. 02:23真正的 Hook 設定檔長什麼樣子，用 JSON 格式寫在 settings.json
3. 04:00介紹 Event 啟動時機，總共三十一種，先抓十個核心的來講
4. 09:00理解 Event 之後，接著看 Matcher 怎麼篩選要攔截的動作
5. 09:33Matcher 挑出目標後，輪到 Handler 決定實際要做什麼
6. 11:55把需求講給 AI 聽，讓它幫你建立第一個 Hooks
7. 13:45實際測試 Git Commit 檢查，有敏感資料就擋下提交
8. 14:01第二個例子，用 Stop Hook 檢查文章有沒有 AI 腔
9. 17:44比較 Claude Code 和 Codex 的 Event 與 Handler 差異
10. 18:56總結 Hooks 核心邏輯，從一個小問題開始建立

CLAUDE.md 跟 Hooks 的差別

CLAUDE.md 像是給 AI 的提醒紙條，它會盡力遵守但不保證每次照做。Hooks 則是完全不同的機制，由 Claude Code 這套軟體在背後強制掌控，時間點一到就直接介入執行，不靠 AI 自己判斷。如果只是專案通用規則寫 CLAUDE.md 就好，但特定時機必須嚴格執行的動作，就適合做成 Hook。

三層架構：Event、Matcher、Handler

Event 決定什麼時候啟動，Matcher 決定攔截哪個操作，Handler 決定最後做什麼。用語法檢查當例子，Event 設成 PostToolUse 在工具用完瞬間啟動，Matcher 鎖定修改程式碼的動作，Handler 呼叫語法檢查腳本抓錯誤。理解這三個問題，Hook 的運作邏輯就通了。

四個階段的關鍵 Event

系統啟動階段有 SessionStart 和 UserPromptSubmit，分別確保載入技能和帶上記憶。工具執行前用 PreToolUse 做安全防呆，擋掉危險 Git 指令。工具執行後用 PostToolUse 做快速驗收，檢查 UI 錯誤。最後 Stop 階段做深度總體檢，還有 Notification、Subagent 系列和 PreCompact 處理特殊狀況。

實際建立 Hook 的兩個案例

第一個用 PreToolUse 檢查 Git Commit 有沒有夾帶 ENV 檔案或 API 金鑰，有就擋下並指出問題檔案。第二個用 Stop 檢查文章有沒有 AI 腔，透過 Agent 呼叫 Humanizer Skill 審查，沒通過就退回修改。建立時只要講清楚啟動時機和要做什麼，完成後再確認觸發範圍夠不夠精確，以及 Stop Hook 有沒有設定結束條件。

值得下載嗎

值得。如果你用 Claude Code 或 Codex，這支影片把 Hooks 的架構、Event 種類和實際案例都講得很完整，還附上可以直接複製的 Prompt，看完就能馬上動手建立第一個 Hook。