AI常用方法論比較教學手冊 版本:v1.1|日期:2026-07-24|適用對象:架構師、Tech Lead、AI 導入決策者、資深工程師 v1.1 更新重點:依 8 套方法論官方 Repository 最新狀態逐章查證修正,包含 GSD 生態系組織遷移沿革(見 2.5、2.6、附錄 C.2)、五工具整合覆蓋度多處更新(spec-kit/BMAD-METHOD/Superpowers/gstack)、gstack 技能規模與指令管線更新、mattpocock/skills 技能清單改版、AGENTS.md 創始會員名單補正,並新增附錄 D.4 版本快照表 涵蓋方法論:spec-kit、OpenSpec、Superpowers、BMAD-METHOD、GSD(get-shit-done)、gsd-pi(GSD-2)、gstack、mattpocock/skills 涵蓋 AI 工具:Claude Code、OpenAI Codex、GitHub Copilot、Gemini、Grok 涵蓋情境:Web Application 開發、逆向工程(Reverse Engineering)、軟體框架升級(Framework Upgrade) 適用產業:銀行、金融業、保險業等高治理需求產業,亦適用一般企業 IT 團隊 重要更新:本文件為跨方法論比較與企業選型指南,非取代任何單一方法論的完整教學;各方法論詳細操作請參閱本目錄下對應手冊(見各章節連結與附錄 D)
📋 目錄 前言 第 1 章:AI 輔助軟體開發方法論全景與參考座標 1.1 為何企業需要跨方法論比較 1.2 方法論分類框架(機制軸) 1.3 八大方法論定位圖 1.4 五大 AI 工具總覽 1.5 三大應用情境定義與成功標準 1.6 AGENTS.md:跨工具互通基礎設施 1.7 其他外部參考座標(非完整檔案,僅作校準用) 1.8 實務落地建議 第 2 章:八大方法論濃縮檔案 2.1 spec-kit 2.2 OpenSpec 2.3 Superpowers 2.4 BMAD-METHOD 2.5 GSD(get-shit-done) 2.6 gsd-pi(GSD-2) 2.7 gstack 2.8 mattpocock/skills 2.9 實務落地建議 第 3 章:跨方法論比較框架與矩陣 3.1 比較維度定義 3.2 總覽比較矩陣 3.3 安裝複雜度與五工具整合覆蓋度矩陣 3.4 團隊規模與組織適配 3.5 治理與維運負擔比較 3.6 學習曲線與導入時間比較 3.7 機制光譜圖 3.8 弱點與風險總表 3.9 實務落地建議 第 4 章:企業選型決策框架 4.1 選型決策樹 4.2 評分量表(可直接套用) 4.3 方法論導入成熟度模型(Level 1–5) 4.4 試點到擴大導入路線圖 4.5 決策情境範例 4.6 實務落地建議 第 5 章:混合與共存導入指南 5.1 為何要混合方法論 5.2 相容性矩陣 5.3 分層組合模型 5.4 安裝順序與設定合併建議 5.5 已知衝突與注意事項 5.6 實務落地建議 第 6 章:三大情境實戰案例(銀行業) 6.1 情境一:Web Application 開發 6.2 情境二:逆向工程 6.3 情境三:框架升級 6.4 三情境 × 八方法論適配打分表 6.5 實務落地建議 第 7 章:方法論組合的維護與升級治理 7.1 為何需要「方法論組合」層級的治理 7.2 日常維運:版本釘選與相容性檢查 7.3 Prompt/Spec 版本控制與變更追蹤 7.4 治理委員會結構與 RACI 7.5 何時該汰換或升級方法論 7.6 法規遵循與稽核追溯(銀行/金融特別考量) 7.7 監控指標與健康度儀表板 7.8 實務落地建議 第 8 章:AI Agent 跨方法論協作範例 8.1 為何需要跨方法論/跨工具協作範例 8.2 範例一:Claude Code + Codex 共用 AGENTS.md 8.3 範例二:Copilot + Gemini/Grok 以 OpenSpec 仲裁 8.4 協作失敗模式與修復 8.5 實務落地建議 第 9 章:方法論選型與整合 Prompt Library 9.1 團隊 AI 成熟度現況評估 Prompt 9.2 方法論選型建議 Prompt 9.3 兩方法論相容性檢查 Prompt 9.4 治理文件骨架生成 Prompt 9.5 情境對應方法論組合 Prompt 9.6 方法論汰換/遷移評估 Prompt 9.7 實務落地建議 第 10 章:常見問題(FAQ) 附錄 A:快速選型與導入檢查清單 附錄 B:八方法論/五工具/三情境速查表 附錄 C:名詞釋義與命名辨正 附錄 D:參考資源與延伸閱讀 附錄 E:八大方法論安裝教學速查 前言 為什麼需要這份手冊 過去兩年間,「用 AI 寫程式」已經從個人的 Prompt 技巧,演化成一整套可被治理、可被複製、可被稽核的方法論(Methodology)。截至本文件撰寫時,僅在本專案的 .github\教學\AI開發\ 目錄下,就已經累積了 spec-kit、OpenSpec、Superpowers、BMAD-METHOD、GSD、gsd-pi(GSD-2)、gstack、mattpocock/skills 等 8 套獨立、完整、動輒 2,500~7,300 行的教學手冊 —— 每一套都宣稱自己能提升 AI 協作品質,每一套都有各自的哲學、安裝方式與最佳實務。
...