github/spec-kit

Spec Kit – AI 輔助開發工具包

是什麼 – 一個開源的 Python 工具包，讓您透過一組結構化、可重複使用的「技能」與 AI 編碼代理（例如 GitHub Copilot）協作。它提供三個現成的流程：

流程	目標	主要輸出
規格驅動開發（SDD）	建立新功能或整個應用程式	規格、技術計畫、任務清單、實作資產與確認程式碼符合規格的收斂報告
缺陷修復	診斷並修復缺陷	原因評估、範圍限定的修復方案與驗證報告（verified、partial 或 failed）
想法評估	評估一個想法是否值得推進	收集的證據、決策文件（go、needs-clarification、kill）

這三個流程均為獨立入口點——您可以從任意一個開始，或透過擴充、預設、工作流程或套件整合自訂流程。

---

如何運作

1. 使用 uv 安裝 CLI（specify-cli）。
2. 建立專案目錄（specify init my-project --integration copilot）。
3. 在該目錄中啟動您的 AI 編碼代理。
4. 在代理的聊天中呼叫提供的斜線風格命令（例如 /speckit-specify、/speckit-bug-fix）。代理將回應請求的資產與下一步指示。
5. 迴圈執行——對於 SDD，重複 implement → converge 直到代理報告 Converged；對於缺陷修復，執行 assess → fix → test；對於想法評估，執行 intake → research → define → shape → decide。

此工具包不會在終端中執行命令；而是由 AI 代理解譯命令，然後執行工作（撰寫程式碼、產生文件、執行測試等），並將結構化結果儲存在隱藏的 .specify/ 資料夾中。

---

核心功能（README 中描述）

• 以代理為中心的工作流程 – 命令專為基於聊天的 AI 代理設計，確保人類在每一步中參與審查。
• 三個內建流程 – 覆蓋功能開發、缺陷修復與產品想法評估。
• 可擴充 – 可新增可選擴充（bug、assess），社群提供額外的擴充、預設、套件與自訂工作流程。
• 模板驅動 – 每個步驟使用可重複使用的模板，可在本地覆蓋。
• 跨平台 – 支援 Linux、macOS 與 Windows。
• 純 Python 執行時 – 需要 Python 3.11+ 與 uv 套件管理器。

---

典型使用情境

• 使用 Copilot（或其他支援代理）的團隊，希望將高階想法轉化為生產程式碼的可重複、可文件化方法。
• 單人開發者，尋找有引導的、AI 增強的缺陷修復工作流程，將診斷與修復分離。
• 產品經理或設計師，在投入資源開發新功能前，需要一個輕量級的證據收集流程。
• 組織，希望在不建構自訂內部工具的情況下，強制推行以規格為先的思維模式。

---

快速入門（來自 README 的步驟）

# 1. 安裝 uv（若尚未安裝）與 CLI
uv tool install specify-cli

# 2. 使用所選 AI 代理整合初始化新專案
specify init my-project --integration copilot
cd my-project

• 在專案資料夾中開啟您的 AI 編碼代理（例如 Copilot 聊天）。
• 執行您想要流程的斜線命令（請參閱 README 表格取得確切命令序列）。
• 跟隨代理的輸出，如有需要編輯生成的 Markdown 資產，然後繼續下一步。

---

文件與社群

• 完整的 CLI 參考、流程命令文件與操作指南托管於 GitHub Pages（README 中的連結）。
• 社群擴充、預設與套件列在文件的 社群 部分。
• 貢獻透過標準的 GitHub issue/PR 流程歡迎；專案採用 MIT 許可證。

---

TL;DR

Spec Kit 是一個基於 Python 的框架，透過簡單的聊天命令引導 AI 編碼代理完成定義明確的開發、除錯或想法評估流程。所有資產均儲存在專案本地的 .specify/ 資料夾中，使工作可重複、可審計，同時保持人類對每一步的控制。