每個改動都走 5 階段:Brainstorm → Plan → Implement → Verify → Ship。
每兩階段之間有「不通過就不能往下」的檢查點(gate)。Gate 由 Claude Code 的 hook 系統自動守門 — 試圖跳過 spec 就直接編程式碼?hook 會把命令擋下,逼你回去寫 spec。這套機制讓「紀律」不靠人記憶,而是內建在工具流裡。
任何程式碼產出都受這 4 條約束。偏向謹慎而非速度,瑣碎任務可自行判斷。
不假設、不藏疑問、列出 trade-off。多種解讀就一起列出,不要默默挑一個;不清楚就停下來問。
解決問題的最小程式碼,不寫沒被要求的功能 / 抽象 / 彈性。200 行能寫成 50 行就重寫。
只動該動的,不「順便改」周邊程式碼、註解、格式。改動的每一行都要能追溯回需求。
訂可驗證的成功條件,跑迴圈直到通過。「修 bug」→「寫一個重現 bug 的測試,再讓它通過」。
每個程式修改都走 4 階段,由 hook 強制執行。任何階段跳過會被系統擋下。
AI 把需求寫成 spec,內容包含:
給使用者看 5 個關鍵點摘要(不是整份 spec),方便快速判斷。使用者可直接編輯 spec 檔案,AI 重新摘要。
使用者說「OK / 同意 / 開始」→ 系統檢查 spec 存在、修改時間 < 1 小時 → 解鎖 staging 環境的修改權限。
不同改動有不同的執行門檻:
| 等級 | 典型範例 | 執行方式 |
|---|---|---|
| 綠燈 | 加欄位、新報表、view 排序、server action、新 menu | AI 自動執行,事後通知 |
| 黃燈 | 改現有欄位、computed field、workflow、ir.cron、權限變更 | 通知人工確認後執行 |
| 紅燈 | account / stock / mrp 核心、SQL 直寫、unlink 大量資料、sudo() 提權 | 人工介入,AI 不擅自動 |
| 場景 | 使用工具 |
|---|---|
| 需求不清 / 新 feature | brainstorm 引導對話 |
| 多步驟複雜任務 | planner agent (Opus) |
| 想被狠狠挑戰 plan | grill-me / grill-with-docs |
| 系統架構設計 | architect agent (Opus) |
| 場景 | 使用工具 |
|---|---|
| 新 feature / bugfix | TDD workflow(先寫測試) |
| 多個獨立任務 | 平行 subagent dispatch |
| 找 bug | diagnose 結構化迴圈 |
| 系統性除錯 | systematic-debugging |
| 深入重構 | improve-codebase-architecture |
| 場景 | 使用工具 |
|---|---|
| 程式 review | code-reviewer agent (Sonnet) |
| 安全檢查 | security-reviewer agent (Opus) |
| 確認可交付 | verification-before-completion |
| 完工提交 | 自動化文件更新 + git push |
不同任務用不同 LLM 等級,省成本又精準。
| 任務 | 模型 | 原因 |
|---|---|---|
| 找檔案 / 跑指令 / codebase 探索 | Haiku | 便宜快,足夠用 |
| 寫程式 / 修 bug / code review | Sonnet | 性價比最佳 |
| 規劃 / 安全審查 / 架構決策 | Opus | 深度推理不可省 |
| ✅ 適用 | ⚠️ 不適用 |
|---|---|
| Odoo ERP 模組開發 / 客製 | 大型 architecture 重構(要人主導) |
| LINE LIFF / Bot 整合 | 涉及實體硬體的整合 |
| React Web / React Native | 沒驗證流程的「快速 hack」 |
| 資料遷移 / 部署自動化 | 高度創意性的 UI/UX 設計 |
| 報表 / 工作流程客製 | 法務 / 合約類文件自動生成 |