開源專案觀察
Superpowers:141k star,為你的 AI 程式設計代理裝上「工作流引擎」
你用 AI 寫程式,但它有「方法論」嗎?
大多數人用 AI 寫程式是這樣的:
你給一個需求,AI 立刻開始寫程式碼。寫完一段,你發現不對,讓它改。改完又發現另一個問題,繼續改。來回幾輪,程式碼越來越亂,最後你甚至不確定它到底在做什麼。
問題在哪?AI 只有「能力」,沒有「方法論」。
它會寫程式碼,但不會規劃。它會改 bug,但不知道什麼時候應該停下來思考。它能在你指導下工作,但不會主動把事情做得更好。
Superpowers 解決的就是這個問題。
141k stars,一個「代理工作流」框架
Superpowers 是一個完整的軟體開發工作流框架,專門為 AI 程式設計代理設計。
它的核心是:一套可組合的「技能」,加上初始指令,確保你的代理正確使用它們。
這不是一個新工具,而是一個「方法論層」,可以安裝在 Claude Code、Cursor、Codex、OpenCode 等平台上。
它怎麼運作
第一步:不急於寫程式碼
當你的編碼代理看到你要建構什麼東西時,它不會立刻跳進去寫程式碼。
相反,它會停下來問你:你到底想做什麼?
透過提問,它會幫你細化需求、探索替代方案,然後以足夠短的區塊呈現設計給你閱讀和消化。
第二步:分解實作計畫
在你核准設計後,它會制定一個清晰到「一個熱情但品味差、沒有判斷力、沒有專案上下文、厭惡測試的初級工程師」也能跟進的實作計畫。
重點強調: - 真正的紅/綠 TDD - YAGNI(你不會需要它) - DRY(不要重複自己)
第三步:子代理驅動開發
一旦你說「開始」,它啟動一個「子代理驅動開發」流程:代理逐一完成每個工程任務,檢查和審查工作,然後繼續前進。
Claude 常常能夠自主工作好幾個小時,不會偏離你們一起制定的計畫。
核心工作流
Superpowers 定義了一個完整的開發流程:
1. brainstorming(腦力激盪)
啟動於寫程式碼之前。透過提問細化粗略想法,探索替代方案,分段呈現設計供驗證。儲存設計文件。
2. using-git-worktrees(使用 Git 工作樹)
啟動於設計核准後。在新分支上建立隔離工作區,執行專案設定,驗證乾淨的測試基線。
3. writing-plans(撰寫計畫)
啟動於設計核准後。將工作分解為小任務(每個 2-5 分鐘)。每個任務有精確的檔案路徑、完整程式碼、驗證步驟。
4. subagent-driven-development(子代理驅動開發)
啟動於計畫制定後。為每個任務派發新的子代理,進行兩階段審查(規格合規性,然後程式碼品質)。程式碼不好的時候,它會停下來審查,而不是繼續往前衝。
5. test-driven-development(測試驅動開發)
啟動於實作期間。強制執行 RED-GREEN-REFACTOR:寫失敗測試 → 看它失敗 → 寫最小程式碼 → 看它通過 → 提交。刪除在測試之前寫的程式碼。
6. requesting-code-review(請求程式碼審查)
啟動於任務之間。根據計畫審查,按嚴重程度回報問題。關鍵問題阻擋進度。
7. finishing-a-development-branch(完成開發分支)
啟動於任務完成後。驗證測試,呈現選項(merge/PR/keep/discard),清理工作樹。
代理在任何任務前檢查相關技能。 這是強制工作流,不是建議。
技能庫
測試
- test-driven-development:RED-GREEN-REFACTOR 循環(包括測試反模式參考)
除錯
- systematic-debugging:4 階段根因流程(包括根因追蹤、深度防禦、基於條件的等待技術)
- verification-before-completion:確保真的修復了
協作
- brainstorming:蘇格拉底式設計細化
- writing-plans:詳細實作計畫
- executing-plans:帶檢查點的批量執行
- dispatching-parallel-agents:並發子代理工作流
- requesting-code-review:預審查檢查清單
- receiving-code-review:回應回饋
- using-git-worktrees:平行開發分支
- finishing-a-development-branch:合併/PR 決策工作流
- subagent-driven-development:快速迭代 + 兩階段審查
元
- writing-skills:按照最佳實務建立新技能(包括測試方法論)
- using-superpowers:技能系統介紹
安裝方式
支援多個平台:
Claude Code(官方市集)
/plugin install superpowers@claude-plugins-official Cursor
/add-plugin superpowers Codex
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md OpenCode
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md Gemini CLI
gemini extensions install https://github.com/obra/superpowers 核心哲學
- 測試驅動開發:先寫測試,永遠
- 系統化而非臨時:流程優於猜測
- 降低複雜性:簡單是主要目標
- 證據優於聲明:聲明成功前先驗證
為什麼值得關注
大多數 AI 程式設計工具只給你「能力」:它能寫程式碼、改 bug、解釋邏輯。
但 Superpowers 給你的是「方法論」:它知道什麼時候該停下來規劃,什麼時候該測試,什麼時候該審查。
能力讓你快,方法論讓你穩。
141k stars 說明了一件事:真正讓 AI 程式設計變得可用的,不是更強的模型,而是更好的工作流。
相關連結:
- GitHub:https://github.com/obra/superpowers
- 作者部落格:https://blog.fsck.com/2025/10/09/superpowers/
- Discord:https://discord.gg/35wsABTejz
- 作者:Jesse Vincent(Prime Radiant)