Superpowers

Superpowers是什麼

Superpowers 是 Jesse Vincent 和 Prime Radiant 團隊開發的開源 Agentic 技能框架與軟件開發方法論，專爲 Claude、Cursor、GitHub Copilot 等 AI Coding Agent 設計。通過 14 個可組合技能（Skills）和初始指令，讓 AI 編碼助手不再直接跳寫代碼，是先通過蘇格拉底式提問提煉需求、生成可驗證的設計文檔、制定詳細實施計劃，再進入子代理驅動的開發流程。核心強調 RED-GREEN-REFACTOR 測試驅動開發、YAGNI 原則和 DRY 原則，支持 Git Worktrees 隔離開發、並行子代理調度、兩階段代碼審查等高級工作流，讓 Claude 等 Agent 能自主運行數小時而不偏離既定計劃。

查看原圖來源（外部連結）

Superpowers的主要功能

• 蘇格拉底式頭腦風暴（brainstorming）：通過追問提煉需求，分塊呈現設計方案供用戶確認後再進入編碼
• 設計文檔生成：將粗糙想法轉化爲結構化、可驗證的規格說明並自動保存
• 詳細實施計劃（writing-plans）：將工作拆解爲 2-5 分鐘的微任務，包含精確文件路徑、完整代碼和驗證步驟
• 子代理驅動開發（subagent-driven-development）：爲每個任務派遣獨立子代理，執行兩階段審查（規格合規性 + 代碼質量）
• 測試驅動開發（test-driven-development）：強制 RED-GREEN-REFACTOR 循環，先寫測試再寫代碼，刪除測試前編寫的任何代碼
• 系統化調試（systematic-debugging）：四階段根因分析流程，包含根因追蹤、縱深防禦、條件等待等技術
• Git Worktrees 工作流（using-git-worktrees）：在獨立分支和工作區中開發，驗證乾淨測試基線
• 並行代理調度（dispatching-parallel-agents）：併發執行多個子代理工作流，提升大型項目效率
• 代碼審查機制（requesting-code-review / receiving-code-review）：任務間自動審查，按嚴重程度報告問題，關鍵問題阻塞進度
• 分支收尾（finishing-a-development-branch）：驗證測試、提供合併/PR/保留/丟棄選項、清理工作區
• 技能自擴展（writing-skills）：遵循最佳實踐創建和測試新技能，支持團隊沉澱內部方法論
• 多平台插件支持：Claude Code 官方市場、Cursor、OpenAI Codex CLI/App、GitHub Copilot CLI、Gemini CLI、OpenCode 全覆蓋

如何使用Superpowers

• Claude Code 官方市場：運行 /plugin install superpowers@claude-plugins-official。
• Claude Code Superpowers 市場：先執行 /plugin marketplace add obra/superpowers-marketplace，再執行 /plugin install superpowers@superpowers-marketplace。
• OpenAI Codex CLI：打開插件搜索界面，搜索 “Superpowers” 並選擇安裝。
• OpenAI Codex App：側邊欄點擊 Plugins，在 Coding 分類找到 Superpowers 點擊 + 安裝。
• Cursor：在 Agent 聊天中通過插件市場搜索 “superpowers” 安裝。
• OpenCode：輸入 Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md。
• GitHub Copilot CLI：依次運行 copilot plugin marketplace add obra/superpowers-marketplace 和 copilot plugin install superpowers@superpowers-marketplace。
• Gemini CLI：運行 gemini extensions install https://github.com/obra/superpowers，更新時用 gemini extensions update superpowers。
• 基礎工作流：頭腦風暴 → 設計確認 → Git Worktree 創建 → 撰寫計劃 → 子代理執行/計劃執行 → TDD 實現 → 代碼審查 → 分支收尾。

Superpowers的關鍵信息和使用要求

• 開源協議：MIT License，可自由使用、修改和商業應用。
• 維護者：Jesse Vincent 及 Prime Radiant 團隊。
• 核心哲學：TDD 優先、系統化流程、複雜度削減、證據驗證。
• 技能數量：14 個可組合技能，覆蓋測試、調試、協作、計劃執行、並行代理、Git 工作流。
• 安裝前提：需使用支持插件系統的 Coding Agent（Claude Code、Cursor、Codex 等）。
• 工作流強制性：Agent 在執行任務前必須檢查相關技能，非建議而是強制流程。
• 社區支持：Discord 社區、GitHub Issues、郵件訂閱發佈通知。
• 貢獻規範：不接受隨意新增技能，修改需跨所有支持平台驗證，遵循 writing-skills 指南。
• 更新機制：部分平台自動更新，具體取決於 Coding Agent 的插件系統。

Superpowers的核心優勢

• 不直接寫代碼，先理解需求：Agent 看到開發任務時先退一步，通過提問明確真實目標，避免幻覺和返工。
• 系統化而非隨意：基於流程的方法論替代猜測式編程，以複雜度削減爲首要目標。
• 證據勝於斷言：驗證通過後才宣告成功，避免”看起來能跑”的虛假完成。
• 自動觸發技能：技能在檢測到相關任務時自動激活，無需手動調用或記憶複雜指令。
• 長時間自主運行：Claude 等 Agent 可在既定計劃下自主工作數小時不偏離目標。
• 強制測試優先：TDD 作爲強制性工作流而非可選建議，從根本上保障代碼質量。
• 多 Agent 生態兼容：同一套技能庫跨 Claude、Cursor、Copilot、Codex、Gemini 等平台無縫工作。
• 微任務拆解：2-5 分鐘粒度的任務描述讓”熱情的初級工程師”也能準確執行。
• 隔離式開發：Git Worktrees 避免污染主分支，支持並行實驗和安全回退。

Superpowers的應用場景

• 從零構建新功能：通過頭腦風暴和設計文檔確保需求理解正確，避免後期大規模返工。
• 大型重構項目：用 Git Worktrees 隔離實驗，子代理並行處理不同模塊的改造。
• Bug 修復與根因分析：系統化調試技能指導 Agent 進行四階段根因追蹤，而非盲目試錯。
• 代碼審查自動化：在提交前讓 Agent 執行兩階段審查，主動發現規格偏離和質量問題。
• 多文件複雜改動：將大需求拆解爲微任務，分派子代理逐步實施並持續驗證。
• 跨平台開發協作：同一套 Superpowers 技能在 Claude、Cursor、Copilot 間保持一致體驗。

Superpowers的常見問題