spec-kit使用教學
Spec-Kit 使用教學手冊 版本: 9.0 最後更新: 2026年5月14日 適用於: Spec-Kit v0.8.9+ / Spec Kit Templates - 0.8.9 Created by: Eric Cheng 📚 目錄 前言 目的與適用對象 背景說明:為何採用 SDD + Spec-Kit → AI 助手流程 本手冊使用假設 第一章:概念理解 1.1 SDD 是什麼? 1.2 Spec-Kit 概覽 1.3 SDD 中的關鍵 artefacts(工件) 1.4 流程概覽:SDD 的階段/步驟 1.5 為什麼這對我們團隊/共用平台開發特別有價值 第二章:環境準備 2.1 前置條件 2.2 安裝 Spec-Kit CLI 2.3 建立專案與初始化 2.4 建立團隊守則 (Constitution) 2.5 模板與提示文件說明 2.6 GitHub 倉庫分支與版本控制建議 2.7 擴充系統 (Extension System) 2.8 預設系統 (Presets System) 2.9 CLI 診斷指令 (doctor / status) 2.10 Plugin Architecture(v0.4.4-0.4.5 重大架構變革) 2.11 整合管理指令 (specify integration) 2.12 Git 擴充 (Bundled Git Extension) 2.13 工作流引擎 (Workflow Engine, v0.7.0) 2.14 –integration 旗標(v0.7.1 取代 –ai) 2.15 Self Management 指令(v0.7.5 新增) 2.16 預設組合策略 (Composition Strategies, v0.8.0) 2.17 Skills-Based Scaffolding(v0.8.0 新增) 2.18 feature.json 自訂分支支援(v0.8.1 新增) 2.19 –no-git 旗標棄用與 GITHUB_TOKEN 認證(v0.8.2 新增) 2.20 目錄探索 CLI 與 Devin 整合(v0.8.3 新增) 2.21 Constitution 上下文載入與治理擴充(v0.8.4–v0.8.6 新增) 2.22 Lingma 整合與 Agent Orchestrator(v0.8.7 新增) 2.23 Config-Driven 認證與排程擴充(v0.8.8 新增) 2.24 治理生態系擴充與 BrownKit(v0.8.9 新增) 第三章:使用流程詳細說明 3.1 Step 1:撰寫 Spec (/speckit.specify) 3.2 Step 1a:澄清模糊需求 (/speckit.clarify) 3.3 Step 2:撰寫 Plan (/speckit.plan) 3.3a Step 2a:驗證 Plan (Plan Validation) 3.4 Step 3:拆分 Tasks (/speckit.tasks) 3.5 Step 4:預實作檢查 (/speckit.analyze + /speckit.checklist) 3.6 Step 5:實作 (/speckit.implement) 3.7 Step 6:迭代維護 第三章小結 第四章:實務案例與應用指引 4.1 案例一:Greenfield 開發 - 新建交易記錄微服務 4.2 案例二:Brownfield 整合 - 為既有系統新增功能 4.3 團隊協作:多人開發 4.4 AI 助手最佳實踐 4.5 平台導入建議 第四章小結 第五章:常見問題與陷阱 5.1 常見問題(FAQ) 5.2 常見陷阱與避免方法 第五章小結 第六章:附錄 6.1 完整模板範例 6.2 檢查清單 6.3 參考資源 6.4 社群實作範例 (Community Walkthroughs) 6.5 社群工具生態系 (Community Friends) 6.6 術語表 6.7 快速指令參考 6.8 版本異動紀錄 (Changelog 摘要) 結語 前言 目的與適用對象 本手冊旨在幫助開發團隊快速掌握 Spec-Driven Development (SDD) 方法論,並透過 Spec-Kit 工具組與 AI 助手協作,建立高品質、可維護的軟體系統。 ...