作者 shanraisshan · shanraisshan/claude-code-best-practice
從臨時提示到工程級 Claude 使用方式的實用手冊——計劃、驗證、鉤子、事後回顧。
claude-code-best-practice 是一套讓 Claude Code 在實際工作中可靠的精選實踐和模板。先規劃再執行的提示方式、驗證鉤子、事後回顧格式、重構檢查清單。與其說是「魔法自動技能」，不如說是一套紀律套件——選擇加入、遵循步驟、信任輸出。
何時使用： 變更涉及超過 3 個檔案，或範圍不明確。
結果： 因為有充分思考，重構乾淨落地。
何時使用： 出了問題，你必須寫一份報告。
結果： 有助於下次的事後報告，而非追究責任。
何時使用： 遷移跨越多個檔案；你不想遺漏任何步驟。
結果： 遷移後沒有「我們忘了更新 X」的意外。
結合兩個有主見的套件——最佳實踐提示 + 研究優先預設
將計劃和事後報告與程式碼一起持久化
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| make_plan | task description | 任何非平凡變更之前 | token |
| critique_plan | plan | 規劃後、執行前 | token |
| postmortem_draft | logs, commits, summary | 事故後 | token |
事後回顧用的日誌／提交讀取存取計劃太通用提供具體的 repo 上下文；技能會錨定在你提供的內容上
與團隊現有流程衝突選擇性採用——單獨使用事後回顧模板就很有價值
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| everything-claude-code-skill | 你想要更完整的套件（記憶、安全性、直覺） | 需要學習的表面積更大 |
| 手工撰寫的 CLAUDE.md 規則 | 高度客製化的工作流程 | 維護工作量更大 |