AI 驅動開發方法論

Spec-First · 風險分級 · 驗證為本
Claude Code Odoo ERP Spec-First Workflow Hook-Enforced Gates
v1.0.0 · 2026-05-03

整體流程:5 階段 · 4 道閘門

PHASE 1
釐清需求
Brainstorm
PHASE 2
規劃
Plan / Risk Tier
PHASE 3
實作
TDD / Subagents
PHASE 4
驗證
Review / Verify
PHASE 5
上線
Staging → Prod
每兩階段之間有閘門(gate)。Gate 由 hook 自動守門 — 跳過會被擋下,不靠人記。

目錄

1 流程總覽 2 編碼 4 原則 3 Spec-First 工作流 4 風險三級制 5 三階段工具對照 6 AI 工具箱 7 模型選用口訣 8 對客戶的承諾 9 適用範圍
1

流程總覽

每個改動都走 5 階段:Brainstorm → Plan → Implement → Verify → Ship

每兩階段之間有「不通過就不能往下」的檢查點(gate)。Gate 由 Claude Code 的 hook 系統自動守門 — 試圖跳過 spec 就直接編程式碼?hook 會把命令擋下,逼你回去寫 spec。這套機制讓「紀律」不靠人記憶,而是內建在工具流裡。

💡
為什麼要這麼嚴?因為 LLM 的長處是「跑迴圈把事做完」,弱點是「不問就動」。Spec-First 是用流程紀律補 LLM 的弱點。
2

編碼 4 原則(Karpathy)

任何程式碼產出都受這 4 條約束。偏向謹慎而非速度,瑣碎任務可自行判斷。

1

動手前先思考

不假設、不藏疑問、列出 trade-off。多種解讀就一起列出,不要默默挑一個;不清楚就停下來問。

2

簡單優先

解決問題的最小程式碼,不寫沒被要求的功能 / 抽象 / 彈性。200 行能寫成 50 行就重寫。

3

外科式修改

只動該動的,不「順便改」周邊程式碼、註解、格式。改動的每一行都要能追溯回需求。

4

目標驅動執行

訂可驗證的成功條件,跑迴圈直到通過。「修 bug」→「寫一個重現 bug 的測試,再讓它通過」。

3

Spec-First 強制工作流

每個程式修改都走 4 階段,由 hook 強制執行。任何階段跳過會被系統擋下。

1

Phase 1 · 規格起草(Spec-Draft)

AI 把需求寫成 spec,內容包含:

  • 影響的檔案 / 資料模型 / UI / API
  • 風險等級(綠 / 黃 / 紅)
  • 測試計畫與驗證指令
  • Rollback 步驟

給使用者看 5 個關鍵點摘要(不是整份 spec),方便快速判斷。使用者可直接編輯 spec 檔案,AI 重新摘要。

2

Phase 2 · 規格確認(Confirm-Analysis)

使用者說「OK / 同意 / 開始」→ 系統檢查 spec 存在、修改時間 < 1 小時 → 解鎖 staging 環境的修改權限。

3

Phase 3 · 測試環境執行(Staging)

  • 改動同步到 staging container
  • Upgrade module、跑驗證、查 log
  • 失敗就退回 Phase 1,不容繞道
4

Phase 4 · 確認上正式(Confirm-Staging → Prod-Release)

  • staging 跑一輪後使用者確認
  • 部署到正式環境
  • Health check + 結果回報給使用者
📌
例外:純讀取問題(「這個欄位是什麼」「這個報表怎麼跑」「解釋這段程式」)不需要 spec,AI 直接答即可。
4

風險三級制

不同改動有不同的執行門檻:

等級典型範例執行方式
綠燈 加欄位、新報表、view 排序、server action、新 menu AI 自動執行,事後通知
黃燈 改現有欄位、computed field、workflow、ir.cron、權限變更 通知人工確認後執行
紅燈 account / stock / mrp 核心、SQL 直寫、unlink 大量資料、sudo() 提權 人工介入,AI 不擅自動
5

三階段該用什麼工具

📋 規劃階段(不寫程式)

場景使用工具
需求不清 / 新 featurebrainstorm 引導對話
多步驟複雜任務planner agent (Opus)
想被狠狠挑戰 plangrill-me / grill-with-docs
系統架構設計architect agent (Opus)

⚙️ 實作階段

場景使用工具
新 feature / bugfixTDD workflow(先寫測試)
多個獨立任務平行 subagent dispatch
找 bugdiagnose 結構化迴圈
系統性除錯systematic-debugging
深入重構improve-codebase-architecture

✅ 收尾階段

場景使用工具
程式 reviewcode-reviewer agent (Sonnet)
安全檢查security-reviewer agent (Opus)
確認可交付verification-before-completion
完工提交自動化文件更新 + git push
6

AI 工具箱

基礎

Claude Code
Anthropic 官方終端 AI 開發工具,55k⭐

核心框架

Superpowers
174k⭐ skills 框架,含 brainstorming / TDD / verification 流程

工程紀律

mattpocock skills
40.5k⭐ — diagnose / grill-with-docs / triage 等實戰技能

子代理庫

wshobson agents
25k⭐ — 184 個專業 subagents,依任務動態派遣

執行紀律

Spec-First Hooks
自製 4 階段守門系統,hook 強制流程不可繞

效率工具

Caveman 模式
超壓縮對話模式,省 75% token 同時保技術精度
7

模型選用口訣

不同任務用不同 LLM 等級,省成本又精準。

任務模型原因
找檔案 / 跑指令 / codebase 探索 Haiku 便宜快,足夠用
寫程式 / 修 bug / code review Sonnet 性價比最佳
規劃 / 安全審查 / 架構決策 Opus 深度推理不可省
8

我們對客戶的承諾

  • 客戶不需要學任何指令 — Discord / LINE 對話即可開單
  • 每個改動都有 spec,可審查、可 rollback
  • 上正式前必過 staging 驗證
  • 風險高的動作自動暫停等人核可
  • 24 小時可達 — 客戶 VM 上有自主 AI(systemd 常駐)
  • 完成後文件自動更新到客戶專屬 portal
9

適用範圍

✅ 適用⚠️ 不適用
Odoo ERP 模組開發 / 客製大型 architecture 重構(要人主導)
LINE LIFF / Bot 整合涉及實體硬體的整合
React Web / React Native沒驗證流程的「快速 hack」
資料遷移 / 部署自動化高度創意性的 UI/UX 設計
報表 / 工作流程客製法務 / 合約類文件自動生成