zhu1090093659/spec_driven_develop

解決的問題

Spec-Driven Develop 為 AI 編碼代理提供了一種結構化、以架構為先的流程，用於處理大規模軟體變更——例如遷移、重寫與複雜重構——而不會遺失進度或盲目執行有缺陷的計畫。它防止 AI 代理在複雜實作過程中偏離原始意圖或引入架構退化這類常見問題。

如何運作

此專案是一組與平台無關的 Markdown 基礎「技能」，AI 代理可讀取並執行。它實作七階段流程（從意圖捕捉與深度分析，到執行與歸檔），並使用稱為「自適應控制」的封閉迴路反饋系統來監控執行遙測資料。若代理的進度偏離計畫過多，系統將自動觸發路徑修正或任務重新分解。

它原生整合 GitHub，透過 Issues、Milestones 與 Labels 追蹤任務，將工作分組為連貫的「交付批次」，而非零散的 PR。它也包含兩個輔助工作流程：「Deep Discuss」用於結構化技術腦力激盪，以及「Review SPD」用於以發現為先的程式碼審查，專注於缺陷與回歸問題。

適用對象

使用 AI 編碼代理（如 Claude Code、Cursor、Windsurf 或 Aider）進行高風險、大規模架構變更，或需要嚴謹規劃與追蹤的複雜功能實作的開發者。

主要亮點

• S.U.P.E.R 架構原則：透過自動化健康檢查與檢查清單，強制執行單一目的、單向流程、端點優於實作、環境無關、可替換元件。
• 自適應控制迴圈：受控制論啟發的反饋系統，當執行偏差超過特定閾值（20%、40%、60%）時，會暫停或重構計畫。
• 原生 GitHub 追蹤：自動建立 Issues 與 Milestones，管理工作樹與批次 PR，實現專業級專案管理。
• 平台無關：可作為 Claude Code、Codex 和 OpenCode 的外掛使用，也可作為任何支援自訂指令的代理的簡單 Markdown 技能。