MageByte-Zero/spec-superflow

它解決的問題

AI程式輔助工具經常在需求尚未完全理解時就開始撰寫程式，或在實作過程中偏離原始計畫。spec-superflow 透過引入風險導向的工作流程，強制在執行前對需求與設計達成共識，特別是針對高風險變更，同時對簡單調整保持輕量級。

如何運作

此專案提供一組「技能」與 CLI 工具鏈，可整合至各種 AI 代理（如 Claude Code、Cursor、Windsurf 等）。它使用內容層級的狀態機，將 AI 引導至八個不同階段：

1. 探索：透過 need-explorer 技能釐清需求。
2. 規格化：透過 spec-writer 建立提案、規格、設計與任務。
3. 橋接：透過 contract-builder 自動將這些成果壓縮成 execution-contract.md。
4. 執行：透過 build-executor 使用 TDD 與子代理驅動開發（SDD）實作程式碼。
5. 除錯：若實作失敗，透過 bug-investigator 進行根本原因分析。
6. 審查：透過 code-reviewer 進行結構化程式碼審查。
7. 結案：透過 release-archivist 與 spec-merger 完成並歸檔。

根據風險程度（檔案數量、對 API/權限的影響），系統會選擇 完整 路徑（所有階段）或 快速/熱修/微調 路徑（最少文件與直接驗證）。

適用對象

從事大型功能開發、多人協作專案或長期維護專案的開發者，這些專案需要嚴格的 TDD 與審查門檻。

特色亮點

• 多平台支援：相容於 19 種不同的 AI 程式平台，包括 Cursor、Claude Code、Windsurf 與 GitHub Copilot。
• 風險導向路由：根據變更的複雜度，自動選擇輕量或全面的工作流程。
• 受保護的執行機制：高風險變更必須先有已驗證的執行計畫與審查憑證，才能結案。
• 內容層級偵測：根據成果的實際內容追蹤狀態，而非檔案時間戳記。
• 整合式 CLI：內建強大的工具鏈（ssf），用於管理檢查點、交接與 git 隔離。