在使用 Claude Code 進行 AI 輔助開發的過程中,Spec-Driven Development(SDD)是目前最主流的方法論。核心概念是:先寫規格文件、再讓 AI 根據規格生成程式碼,藉此減少幻覺、提升一致性。
但 SDD 工具之間的差異非常大。我在過去幾個月裡依序使用了 Spec Kit、OpenSpec 和 Superpowers,三款工具解決的是同一個問題,但走出了完全不同的路。以下是我的實戰心得。
Spec Kit:完整但沉重的規格機器
Spec Kit 是我最早接觸的 SDD 工具,由 GitHub 官方團隊維護(github/spec-kit),目前 GitHub 星數約 86.8k。
它的設計哲學是「無歧義的完整規格」。每啟動一個功能,Spec Kit 會產生 5 到 7 個以上的 Markdown 文件:包括 spec.md、plan.md、tasks.md、research.md、data-model.md、quickstart.md,外加 contracts 目錄和專案級的 constitution.md。
優點:
規格極為完整,適合大型團隊或多人協作場景
Module Contract 明確定義 API 邊界,降低模組間的耦合
有完善的 linting 和一致性檢查機制
痛點:
文件數量爆炸:一個中等功能就產出 2000 行以上的規格文件
Token 消耗驚人:光是載入規格文件就吃掉 18,000+ tokens,Claude Pro 用不到一小時就可能觸及上限
Module Contract 經常比實際程式碼長 4 倍,投入產出比失衡
對小型專案或個人開發者來說,過度工程化
OpenSpec:有感的輕量化
因為 Spec Kit 的沉重感,同事推薦我試試 OpenSpec(Fission-AI/OpenSpec),GitHub 星數約 38.9k。
OpenSpec 把每次變更收斂到大約 4 個工件:proposal.md、specs/ 目錄、design.md 和 tasks.md。安裝只要一行指令(npm install -g @fission-ai/openspec 然後 openspec init),5 分鐘內就能開始使用。
優點:
文件量大幅減少,Token 消耗明顯降低
保留 SDD 的核心精神(先規格、後實作),但去掉了冗餘的儀式感
新增了 OPSX 工件導向工作流,進一步簡化流程
設定約 5 分鐘(對比 Spec Kit 的 30 分鐘以上)
痛點:
仍然是「文件先行」的思路,對需求模糊的情境幫助有限
缺乏即時視覺反饋,設計決策仍停留在文字想像
社群規模相對較小,生態系還在發展中
Superpowers:引導式開發的新大陸
Superpowers(obra/superpowers)是目前 Claude Code 生態中最受歡迎的外掛,GitHub 星數高達 145k。
和前兩者最大的不同是:Superpowers 不是先給你一堆文件模板,而是透過 Brainstorming 引導式問答,一步一步帶你釐清需求。它會問你:「你想解決什麼問題?」「使用者是誰?」「有哪些限制?」然後根據你的回答逐步收斂出規格。
優點:
引導式對話取代文件模板,特別適合需求不明確的場景
Sub-agent 架構:拆分任務後由獨立子代理執行,並有兩階段審查機制
相關工具(如 superpowers-chrome)提供即時設計預覽,讓風格和版面不只停留在文字想像
社群最大、更新最活躍、文件最豐富
痛點:
引導式問答在需求已經很明確時,可能反而比直接寫規格慢
Sub-agent 架構會產生額外的 Token 開銷(每個子代理都要重建上下文)
視覺預覽功能需要額外安裝配套工具
三者比較表
比較項目 | Spec Kit | OpenSpec | Superpowers |
|---|---|---|---|
GitHub 星數 | ~86.8k | ~38.9k | ~145k |
維護方 | GitHub 官方 | Fission AI | Jesse Vincent(社群) |
每次變更產生文件數 | 5-7+ 個 | ~4 個 | 依對話動態產生 |
Token 消耗 | 高(18k+ tokens / 功能) | 中等 | 中等(子代理有額外開銷) |
設定時間 | ~30 分鐘 | ~5 分鐘 | ~5 分鐘 |
開發流程 | 文件模板驅動 | 輕量文件驅動 | 引導式對話驅動 |
視覺預覽 | 無 | 無 | 有(需配套工具) |
適合場景 | 大型團隊 / 嚴格規格需求 | 中小型專案 / 快速迭代 | 需求探索 / 個人或小團隊 |
學習曲線 | 陡峭 | 平緩 | 極低(對話式) |
比較項目Spec KitOpenSpecSuperpowersGitHub 星數~86.8k~38.9k~145k維護方GitHub 官方Fission AIJesse Vincent(社群)每次變更產生文件數5-7+ 個~4 個依對話動態產生Token 消耗高(18k+ tokens / 功能)中等中等(子代理有額外開銷)設定時間~30 分鐘~5 分鐘~5 分鐘開發流程文件模板驅動輕量文件驅動引導式對話驅動視覺預覽無無有(需配套工具)適合場景大型團隊 / 嚴格規格需求中小型專案 / 快速迭代需求探索 / 個人或小團隊學習曲線陡峭平緩極低(對話式)
我的選擇路徑
回顧我的使用歷程:Spec Kit → OpenSpec → Superpowers,其實反映了一個有趣的趨勢——SDD 工具正在從「文件量最大化」走向「互動智慧化」。
Spec Kit 試圖用完整的規格文件消除所有歧義,但在 AI 輔助開發的語境下,過多的文件反而成了負擔。OpenSpec 做了減法,保留核心精神的同時砍掉了冗餘。而 Superpowers 則跳脫了「先寫文件」的思維框架,用引導式對話讓 AI 成為你的需求分析搭檔。
對我來說,目前 Superpowers 是日常開發的首選,因為它最貼近我的工作方式:先對話、後動手。但如果是多人協作的大型專案,Spec Kit 的嚴謹度仍然有它的價值。OpenSpec 則是兩者之間的折衷方案。
最終的選擇取決於你的開發場景、團隊規模,以及你對「規格」的定義。但無論選哪個,SDD 的核心理念——讓 AI 有據可循——都是值得堅持的方向。