Superpowers 是什麼、怎麼安裝和使用：Claude Code / Codex 最熱門的 Skills 開發流程框架

本文根據 obra/superpowers 倉庫 README、作者發佈文章和 Claude Code 官方文檔整理，資料核對於 2026-10-10。各工具的安裝方式更新較快，以倉庫 README 為準。

是什麼

Superpowers 由 Jesse Vincent（GitHub 用戶名 obra）和他所在的 Prime Radiant 團隊開發，2025 年 10 月發佈。它不是零散的技能合集，而是一套軟件開發方法論：用一組可以互相銜接的技能，加上一段開場指令，讓編程智能體不再一上來就寫代碼，而是先退一步問清你到底要做什麼，把設計分成小段給你確認，再寫出一份「沒有項目背景的新手也能照做」的實施計劃，然後派子智能體按計劃逐項完成、逐項評審。README 提到，這樣安排後智能體連續自主工作幾個小時而不偏離計劃並不少見。

截至 2026-10-10，GitHub 顯示該倉庫約 29.7 萬 Star、2.7 萬 Fork，最近一次推送在 2026-10-10，是按 Star 數排在最前面的 Skills 項目；它也被收錄進 Anthropic 官方插件市場和 OpenAI 的 Codex 插件市場。

包含哪些 Skill

倉庫裏共十餘個技能，按用途可以分成幾組：

• 基本流程（按觸發順序）：
• brainstorming：動手前通過提問弄清需求，小改動在對話裏確認，大項目產出設計文檔；
• using-git-worktrees：設計確認後新建分支和隔離工作區，先跑一遍測試確認基線乾淨；
• writing-plans：把工作拆成每個 2～5 分鐘的小任務，寫明文件路徑、代碼和驗證步驟；
• subagent-driven-development / executing-plans：前者每個任務派一個新的子智能體並逐項評審（最細緻），後者在當前會話裏連續做完、最後統一評審（最省）；
• test-driven-development：強制「先寫失敗的測試 → 看它失敗 → 寫最少的代碼 → 看它通過 → 提交」；
• requesting-code-review / receiving-code-review：任務之間對照計劃評審，嚴重問題會阻止繼續；
• finishing-a-development-branch：收尾時驗證測試，給出合併、開 PR、保留或丟棄的選項。
• 調試：systematic-debugging（四階段找根因）、verification-before-completion（確認真的修好了）、diagnosing-superpowers（排查某次會話裏技能為什麼沒按預期觸發）。
• 並行：dispatching-parallel-agents。
• 元技能：writing-skills（按規範寫新技能並測試）、using-superpowers（技能體系的引導）。

怎麼安裝

每種工具要單獨安裝一次（命令均來自 README）。

Claude Code——從官方市場裝：

text
/plugin install superpowers@claude-plugins-official

或者用作者自己的市場（裏面還有幾個相關插件）：

text
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Codex：Codex App 裏點側邊欄的 Plugins，在 Coding 分類找到 Superpowers 點「+」；Codex CLI 裏輸入 /plugins，搜尋 superpowers，選擇 Install Plugin。

其他工具：

bash
# Gemini CLI
gemini extensions install https://github.com/obra/superpowers
# GitHub Copilot CLI
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace
# Qwen Code
qwen extensions install obra/superpowers

Cursor 在 Agent 對話裏輸入 /add-plugin superpowers；Kimi Code 輸入 /plugins 在 Marketplace 裏安裝。README 還給出了 Antigravity、Devin CLI、Factory Droid、Grok Build、OpenCode、Pi、Hermes Agent 等的安裝方式。README 沒有提供 claude.ai 網頁版的安裝方式。

怎麼用

裝好後不需要記命令，技能會自動觸發：

• 驗證安裝：新開一個會話，輸入 Let's make a react todo list（README 給的測試語句）。正常情況下它不會直接寫代碼，而是先觸發 brainstorming 向你提問。
• 正常開發：照常描述需求，例如「給這個項目加一個導出 CSV 的功能」。它會依次走提問 → 設計確認 → 寫計劃 → 你說開始後執行 → 評審 → 收尾。每一步都會停下來等你確認。
• 出問題時：對智能體說 figure out what went wrong with superpowers in this session，它會調用診斷技能讀會話記錄，指出哪一步沒按流程走。

適合誰 / 不適合誰

適合：

• 讓智能體做中大型功能、苦於它「不問清楚就開寫」「改着改着跑偏」的開發者；
• 認同測試驅動開發、願意在開工前花時間確認設計的團隊；
• 同時用多種編程智能體、希望流程一致的人。

不適合：

• 只想快速改一行代碼、寫個小腳本的場景——完整流程顯得繁瑣，也更耗 token；
• 不寫測試的項目，或對話式探索為主的原型階段；
• 非編程用途。

注意事項

• 許可證：MIT。
• 維護狀態：非常活躍（最近推送 2026-10-10）；README 說明一般不接受新增技能的貢獻，技能改動要在所有支持的工具上都能工作。
• 會改變智能體的預設行為：它通過會話開始時的 Hook 注入引導指令，README 的說法是這些流程是「強制的，不是建議」。和其他同樣接管流程的技能庫（如 gstack、ECC）一起裝容易互相打架，建議先只裝一個。
• 遙測：brainstorming 的可選可視化介面預設會從作者網站加載一個帶版本號的圖標，用於粗略統計使用量；README 稱不包含項目和提示詞資訊，可設定環境變量 SUPERPOWERS_DISABLE_TELEMETRY 關閉。
• 認準倉庫名：skills.sh 榜單上有多個同名但作者不同的 superpowers 倉庫，內容與它無關，安裝時確認是 obra/superpowers。
• 安全：插件含 Hooks 和腳本，來源知名但仍建議安裝時看一眼詳情面板；它會自動創建 Git 分支和工作區，請在有版本管理的項目裏使用。