Spec Coding 方法論
適用場景
- 商業產品和客戶專案（需要產品級品質）
- 長期維護的 WordPress 外掛
- 團隊有開發經驗、能撰寫規格文件的專案
不適用場景
- 快速原型驗證（用 [[Vibe Coding]] 更快）
- 需求高度不明確的探索性專案
- 一次性腳本或自用小工具
步驟
第一階段：規劃
- 在 ChatGPT/Gemini 討論功能流程，釐清需求
- 從功能流程中拆解所需的資料結構欄位
- 使用規劃 Agent（
/plan 指令）自動拆解子功能
- 規劃 Agent 掃描既有程式碼，避免規劃出重複功能
- 產出結構化的待辦文件（存放於
spec 資料夾）
第二階段：後端實作（資料結構優先）
- 設計資料庫版本升級策略
- 建立單一職責的資料表 CRUD 類別（先規劃 → 確認 → 再實作）
- 建立 API 或 Ajax 專用類別，強制使用 CRUD 類別
- 實際執行驗證資料操作正確性
第三階段：前端實作
- 前端使用假資料先確保操作流程與顯示正確
- 區塊開發：先研讀官方文件，準備好 Skill 再給 AI 參考
- 整合後端 API
第四階段：審核與迭代
- 每份子功能文件審核通過後才進入下一個
- 執行 Agent 在開發前掃描資料夾結構確保一致性
- 迭代循環直到品質達標
關鍵原則
- 永遠先規劃再實作，別讓 AI 自由發揮
- 後端先行：資料結構決定一切
- 每一步都是先規劃、確認、再實作
工具組合
- IDE：PhpStorm（WordPress 支援度最佳）
- AI：Claude Code MAX 方案
- 輔助：ChatGPT/Gemini（討論階段）、多終端機分頁同時執行
關聯概念
- [[Spec Coding]]
- [[規格先行開發]]
- [[AI 開發規劃 Agent]]
- [[AI 開發四層級]]
![]()