AI開發

Spec-Kit 使用教學手冊 版本: 14.0 最後更新: 2026年7月15日 適用於: Spec-Kit v0.12.15+ / Spec Kit Templates - 0.12.15 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 新增，v0.9.3 正式實作完成） 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 新增） 2.25 社群治理擴充與文件站遷移（v0.8.10 新增） 2.26 高保證規格工作流與版本特徵報告（v0.8.11 新增） 2.27 Integration Auto 與社群擴充更新（v0.8.12 新增） 2.28 工作流迴圈修正與代理工作流自動化（v0.8.13 新增） 2.29 CLI 重構與分支命名規範（v0.8.14 新增） 2.30 後執行 Hook 與 Token Budget（v0.8.15 新增） 2.31 Workflow Preset 與規格品質重驗證（v0.8.16 新增） 2.32 Hermes Agent 整合與社群文件整合（v0.8.17 新增） 2.33 Self Upgrade 正式實作與 SPECKIT_WORKFLOW_RUN_ID（v0.8.18-v0.9.0 新增） 2.34 Cline 原生整合與相容性修正（v0.9.1 新增） 2.35 Workflow Continue-On-Error 與 Self Upgrade 正式實作（v0.9.2-v0.9.3 新增） 2.36 Resume/Status JSON 輸出與 Rovodev 整合（v0.9.4-v0.9.5 新增） 2.37 Git 擴充改為 Opt-in 與 Legacy 旗標全面移除（v0.10.0 重大變更） 2.38 整合狀態回報強化與 Extension Schema 新欄位（v0.10.1-v0.10.2 新增） 2.39 Data Model Diagram 擴充與 Preset 指令重構（v0.10.3-v0.10.4 新增） 2.40 Workflow Step Catalog 與 Zed 整合（v0.11.0 新增） 2.41 Workflow JSON 輸出強化與 Analyze Subagent 化（v0.11.1-v0.11.3 新增） 2.42 Bundle 系統 (Bundle System)（v0.11.4 新增） 2.43 ZCode 整合、PyPI 發布籌備與 Firebender 整合（v0.11.5-v0.11.6 新增） 2.44 OMP 整合與 Catalog SHA256 驗證（v0.11.7 新增） 2.45 Jira 整合進階與 Spec Roadmap 擴充（v0.11.8 新增） 2.46 多安裝安全與 GHES 認證修正（v0.11.9-v0.11.10 新增） 2.47 Community Bundle Submission 與 Monorepo 指南（v0.11.7-v0.11.10 新增） 2.48 Agent-Context 全面 Opt-in 與 Workflow Validation 強化（v0.12.0 重大變更） 2.49 Workflow 平行處理與 Python 腳本類型支援（v0.12.1-v0.12.4 新增） 2.50 生態系轉型:整合退場、Copilot Skills 棄用與 Catalog 安全性強化（v0.12.2-v0.12.6, v0.12.12 新增） 2.51 Bundle 版本管理強化與工作流引擎穩健性（v0.12.7-v0.12.11 新增） 2.52 治理與品質保證預設集擴充、社群目錄成長（v0.12.11-v0.12.15 新增） 第三章:使用流程詳細說明 ...

Spec-Kit 使用教學手冊 版本: 1.0 最後更新: 2025年10月29日 適用於: Spec-Kit v0.0.79+ 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 倉庫分支與版本控制建議 第三章:使用流程詳細說明 3.1 Step 1:撰寫 Spec (/speckit.specify) 3.2 Step 1a:澄清模糊需求 (/speckit.clarify) 3.3 Step 2:撰寫 Plan (/speckit.plan) 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 術語表 6.5 快速指令參考 結語 前言 目的與適用對象 本手冊旨在幫助開發團隊快速掌握 Spec-Driven Development (SDD) 方法論,並透過 Spec-Kit 工具組與 AI 助手協作,建立高品質、可維護的軟體系統。 ...

Visual Studio Code 使用教學手冊 完整的 VS Code 開發環境設定與實戰指南 涵蓋前端 (Vue 3 + TypeScript) 與後端 (Spring Boot) 開發，適用於團隊協作與企業級專案開發 📋 目錄 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.2 推薦字型與主題 1.3 專案必要的 Extensions 清單 1.3.1 基礎開發工具 1.3.2 前端開發 1.3.3 後端開發 1.3.4 Python 開發 1.3.5 AI 輔助開發 1.3.6 一鍵安裝指令 1.4 設定同步功能 1.5 實務案例與注意事項 2. 專案開發環境配置 2.1 如何開啟專案 2.2 前端、後端工作區設定 2.3 編碼規範設定 2.3.1 前端編碼規範 (ESLint + Prettier) 2.3.2 後端編碼規範 (Checkstyle) 2.3.3 Maven 獨立安裝設定 2.4 容器化開發環境 (Dev Containers) 2.5 實務案例與注意事項 3. 日常開發操作 3.1 Git 與 GitHub/GitLab 整合 3.2 常用快捷鍵 3.3 偵錯與斷點設定 3.4 終端機與多工作區使用 3.5 程式碼片段 (Snippets) 使用 3.6 AI 輔助開發 — GitHub Copilot 3.6.1 程式碼自動完成與 Next Edit Suggestions 3.6.2 Copilot Chat 對話式助手 3.6.3 Inline Chat（行內聊天） 3.6.4 智慧動作 3.6.5 Agent 模式與 Agent Sessions 3.6.6 Autopilot 與 Agent 權限控制 3.6.7 Plan Agent（計畫代理） 3.6.8 自訂指示檔 3.6.9 MCP 伺服器整合 3.6.10 Custom Agents（自訂代理） 3.6.11 Agent Skills（代理技能） 3.6.12 Prompt Files（提示檔案） 3.6.13 Hooks（生命週期鉤子） 3.6.14 語言模型選擇 3.7 實務案例與注意事項 4. 專案特定開發流程指引 4.1 前端開發流程 4.2 後端開發流程 4.3 全端開發工作流程 4.4 程式碼品質檢查 4.5 效能監控與分析 4.6 實務案例與注意事項 4.7 Python 開發環境設定 4.7.1 Python 專案結構 4.7.2 Python 環境設定 4.7.3 Python 開發工具設定 4.7.4 Python 偵錯設定 4.7.5 Python 任務設定 4.7.6 Python 專案範例 4.7.7 Python 開發最佳實務 5. 協作開發功能 5.1 Live Share 即時協作 5.2 多人開發設定 5.3 程式碼審查工具 5.3.1 GitHub Pull Request 整合 5.3.2 GitLab Merge Request 整合 5.3.3 程式碼審查檢查清單 5.4 團隊協作最佳實務 6. 進階功能與擴充 6.1 自訂程式碼片段 6.2 擴充功能開發入門 6.3 工作流程自動化 6.3.1 Task 自動化 6.3.2 GitHub Actions 整合 6.3.3 GitLab CI/CD 整合 6.4 效能優化進階技巧 6.5 遠端開發與 SSH 6.6 工作區管理進階技巧 6.7 設定檔 (Profiles) 管理 6.8 Chat Customizations 編輯器 7. 最佳實務 7.1 常見問題 (FAQ) 與解決方式 7.2 建議的工作習慣 7.3 效能最佳化 7.4 安全性最佳實務 7.5 團隊協作規範 8. 檢查清單 8.1 新進成員快速上手檢查清單 8.2 日常開發檢查清單 8.3 部署前檢查清單 8.4 故障排除檢查清單 9. 附錄 9.1 參考資源 9.2 版本歷程 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.1.1 下載與安裝 前往 Visual Studio Code 官方網站 點擊 “Download for Windows” 下載安裝檔 執行安裝檔，建議勾選以下選項： ✅ 新增至 PATH (在重新啟動後可用) ✅ 在檔案總管中的檔案上顯示「使用 Code 開啟」動作 ✅ 在檔案總管中的目錄上顯示「使用 Code 開啟」動作 ✅ 將 Code 註冊為支援的檔案類型的編輯器 1.1.2 首次啟動設定 啟動 VS Code 選擇適合的色彩主題 登入 Microsoft 帳戶（可選，用於同步設定） 1.2 推薦字型與主題 1.2.1 推薦字型 建議安裝並使用以下等寬字型： ...