不知道什麼時候該升級？本文提供 5 個判斷升級時機的具體場景，幫助你決定何時使用 Hook、Skill 或 Custom Agent。
場景 1：規則被重複違反 → 升級為 Hook
🟡 症狀：同一規則被違反超過 3 次
- 你已經在 CLAUDE.md 寫過「不要修改 .env 檔」3 次
- Claude 每週還是會誤讀或嘗試修改它
- 你在 code review 中頻繁說「改回來」
升級判斷：如果同一條規則在過去 2 週內被違反 > 3 次，→ 升級為 PreToolUse Hook。
為什麼：文本警告（CLAUDE.md）對某些安全規則不夠有效。需要在工具層面強制執行。
場景 2：複雜工作流重複執行 → 升級為 Skill
🟠 症狀：工作流有 5+ 個步驟且每週執行 > 1 次
- 每次做 WordPress 發佈時，都要重複說「驗證 API → 發現類別 → SEO 優化」
- CLAUDE.md 中已有 800+ token 用於工作流說明
- 你發現自己複製貼上同樣的指令給不同專案
升級判斷：工作流步驟 > 5 且每週執行 > 2 次，→ 升級為 Skill。
為什麼：Skill 只在需要時載入，不佔用基礎 context。CLAUDE.md 可簡化為一句話。
場景 3：跨任務的相同角色 → 升級為 Custom Agent
🟣 症狀：為同一角色創建 3+ 個 Skills
- 你有「代碼審查員」的人設，涉及檢查風格、性能、安全性、測試
- 這個人設需要在多個上下文中使用（PR 審查、重構驗證、新功能驗證）
- 你發現自己重複設定「作為高級工程師，檢查以下方面…」
升級判斷：為同一角色建立 3+ 個 Skills 或重複定義人設，→ 升級為 Custom Agent。
為什麼：Custom Agent 將角色、工具、記憶綁定在一起。一致性更高，學習能力更強。
場景 4：CLAUDE.md 超長 → 整體升級
🔴 症狀：CLAUDE.md > 50 行
- CLAUDE.md 現在有 60+ 行，包含 15+ 條規則
- 最後 5 條規則被違反的頻率明顯更高
- 懷疑 Claude 沒有充分「讀」後面的規則（context decay）
升級判斷：CLAUDE.md > 50 行時，將後面 5-7 條規則分流到 Hooks/Skills/Agents。
為什麼：上下文衰減。CLAUDE.md 越長，Claude 注意力越分散。將成熟規則升級出去能保持「高信噪比」。
場景 5：成功率低於 80% → 添加 Stop Hook
🔵 症狀：某工作流成功率 < 80% 且每週 > 1 次
- 「生成 API 文檔」的工作流有 5 步，但只有 70% 機率全部成功
- 每次都需要你手動檢查並要求 Claude 重做某些步驟
- 平均每個工作流需要 1.5 次嘗試才能通過
升級判斷：成功率 < 80% 且每週執行 > 1 次，→ 添加 Stop Hook with Validator。
為什麼：驗證器 + 迭代會指數級提高成功率。即使單步 70%，經過驗證後整體可達 99%。
決策速查表
| 場景 | 升級目標 | 關鍵指標 |
|---|---|---|
| 🟡 規則違反 | Hook | 同規則被違反 > 3 次 |
| 🟠 工作流重複 | Skill | 5+ 步，每週 > 1 次 |
| 🟣 角色跨任務 | Agent | 3+ 個相同角色 |
| 🔴 配置過長 | 整體升級 | CLAUDE.md > 50 行 |
| 🔵 成功率低 | Stop Hook | < 80% 且每週 > 1 次 |
下一步：
決定了你的升級目標？
→ 文章 2：Hook 操作指南（5 分鐘快速實施）
發佈留言