深度解析Superpowers：讓AI編程智能體真正學會"協作開發"
整理版優先睇
速讀
5 個重點
高亮
Superpowers 框架讓 AI 從「直接寫 Code」變成「先理解需求、再協作開發」
整理版摘要
呢篇文章係作者深度解析一個叫 Superpowers 嘅開源框架，佢唔係普通 prompt 集合，而係一套完整嘅 AI 編程工作流框架。作者想解決嘅問題係：AI 寫 Code 雖然快，但成日忽略邊界情況同最佳實踐，導致質量唔穩定。Superpowers 嘅答案係強制執行 TDD、YAGNI、DRY 呢類工程原則，仲透過子智能體分工同 1% 規則嚟確保每個步驟都有人 check。
框架核心理念係令 AI 智能體由「直接寫 Code」轉向「先理解需求、制定計劃、分工協作」。佢提供咗 13 個核心技能，分為流程類、執行類同元技能，涵蓋腦力激盪、測試驅動開發、子智能體開發等關鍵環節。呢啲技能透過 Hooks 系統自動注入會話，配合三個 Slash Command（/brainstorm、/write-plan、/execute-plan）降低使用門檻。
成個框架嘅結論係：只要畀 AI 一套清晰嘅協作流程，佢就可以好似人類開發者咁有系統咁產出高質素 Code。作者仲強調呢套框架適用於多個主流平台，包括 Claude Code、Cursor、OpenCode、Codex 同 Gemini，有實際可操作性。
- 【結論】Superpowers 提供嘅唔係 prompt，而係一套令 AI 由「寫 Code」轉向「協作開發」嘅完整工作流，強制執行 TDD、YAGNI 等最佳實踐。
- 【方法】核心工作流四個階段：腦力激盪（釐清需求）→ 制定計劃（拆解任務）→ 子智能體開發（分工協作）→ 驗證完成（多層檢查），確保每一步都有質素把關。
- 【差異】有別於傳統 prompt 工程，Superpowers 透過 1% 規則防止 AI 跳過關鍵步驟，任何修改超過 1% 代碼嘅操作都必須先啟動相關技能，唔俾 AI「偷懶」。
- 【啟發】子智能體模式（Orchestrator + 多個專精 Agent）模擬真實團隊協作，後端、前端、測試各司其職，有效避免衝突同重複工作。呢個架構可以應用到其他 AI 場景。
- 【可行動點】開發者可以喺 Claude Code、Cursor、OpenCode 等平台安裝 Superpowers，直接使用 /brainstorm、/write-plan、/execute-plan 三個 Slash Command 啟動工作流，降低使用門檻。
整理重點
由直接寫 Code 到協作開發
AI 程式設計發展到而家，最關鍵嘅問題已經唔係「AI 識唔識寫 Code」，而係「AI 點樣確保寫出嚟嘅 Code 係可靠嘅」。Superpowers 嘅答案係：俾 AI 一個完整嘅 開發流程框架，等佢唔好跳過任何重要步驟。
強制執行最佳實踐，例如 TDD、YAGNI、DRY，唔畀 AI 隨性發揮。
呢個框架仲引入咗 子智能體協作模式，主智能體做總指揮，後端、前端、測試 Agent 各自負責自己範疇，好似真實團隊咁分工。
整理重點
13 個核心技能覆蓋開發全流程
Superpowers 將開發能力拆成 13 個 核心技能，分為三類：流程類、執行類同元技能。每個技能都有具體嘅執行規範，確保 AI 每次執行都 consistent。
- 流程類（Process Skills）：包括腦力激盪、系統化調試、接收同請求 Code Review。呢啲技能確保開發嘅步驟順序正確。
- 執行類（Implementation Skills）：編寫同執行計劃、TDD、子智能體開發、並行代理調度、完成開發分支、完成前驗證。呢啲係實際寫 Code 嘅環節。
- 元技能（Meta Skills）：使用 Superpowers 同編寫新技能。呢層係框架自我擴展嘅關鍵。
技能優先級：流程類永遠高過執行類，確保先諗清楚再做。
整理重點
四階段工作流：理解、計劃、執行、驗證
整個開發流程分四個階段，每個階段都有明確嘅輸出同檢查點，避免 AI 跳步。
- 1 第一階段：腦力激盪——AI 唔會直接寫 Code，而係先反問用戶需求細節，展示設計選項，最終生成需求規格。例如用戶話「做個登錄功能」，AI 會問係用戶名密碼定社交登錄。
- 2 第二階段：制定計劃——AI 生成實施計劃，必須清晰到「熱情但無經驗嘅初級工程師」都睇得明，強調 TDD（先寫測試）、YAGNI（唔做多餘功能）、DRY（唔重複自己）。
- 3 第三階段：子智能體開發——主智能體將任務分派俾後端 Agent、前端 Agent、測試 Agent，佢哋同時工作，減少開發時間。
- 4 第四階段：驗證完成——有 check list 確保功能測試通過、Code Review 通過、文檔已更新、Git 分支已合併，最後先同用戶確認。
每個階段嘅檢查點係質素保證嘅關鍵，唔可以跳過任何一個。
整理重點
Hooks 系統：自動注入上下文
觸發事件 → hooks.json → session-start 腳本
↓
初始化邏輯
· 檢測平台
· 注入上下文
· 加載技能
↓
Session 就緒，技能已加載 ✅Superpowers 利用 Hooks 系統 喺每次會話啟動時自動注入 using-superpowers 元技能，咁樣就唔使用戶每次手動叫喚。呢個設計令框架嘅使用體驗流暢好多。
平台適配層支援 Claude Code、Cursor、OpenCode、Codex、Gemini，安裝方式各有唔同。
整理重點
元技能同 1% 規則：防止 AI 偷懶
元技能 using-superpowers 係每次會話自動注入嘅核心規則集。佢包含 SUBAGENT-STOP 防止子智能體遞歸調用、EXTREMELY-IMPORTANT 強制執行 1% 規則、Red Flags 識別 AI 常見嘅「偷懶」藉口，例如跳過測試或者忽略 Code Review。
呢個設計嘅哲學係：AI 嘅「直覺」成日忽略邊界情況，所以要用規則綁住佢，等佢跟返正規軟件工程流程。
深度解析 Superpowers：令 AI 編程智能體真係學識「協作開發」
當 AI 編程助手越來越勁，一個核心問題就浮現咗出嚟：點樣令 AI 唔止係寫 code，而係好似真正嘅開發者咁思考、協作同迭代？ Superpowers 就係為咗解決呢個問題而出現。
Superpowers 係乜嘢？
Superpowers 係一個面向 AI 編程智能體嘅完整嘅軟件開發工作流框架。佢唔係單純嘅提示詞集合，而係一套系統化嘅開發方法論，令 AI 智能體可以：
┌─────────────────────────────────────────────────────────┐
│ Superpowers 核心理念 │
├─────────────────────────────────────────────────────────┤
│ │
│ 🔄 從"直接寫代碼"到"先理解需求" │
│ AI 不是一上來就寫代碼，而是先問清楚"你要做什麼" │
│ │
│ 📐 從"隨性發揮"到"規範流程" │
│ 強制執行 TDD、YAGNI、DRY 等最佳實踐 │
│ │
│ 👥 從"單打獨鬥"到"團隊協作" │
│ 子智能體驅動開發，多角色分工 │
│ │
│ ✅ 從"寫完算數"到"驗證通過" │
│ 每個步驟都有檢查點，確保質量 │
│ │
└─────────────────────────────────────────────────────────┘
核心架構圖
┌─────────────────────────────────────────────────────────┐
│ Superpowers 系統架構 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 用戶交互層 │ │
│ │ 你告訴 AI 要做什麼 → AI 彙報進展 → 你審批 │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Skills 技能庫 │ │
│ │ │ │
│ │ ├── brainstorming 頭腦風暴 │ │
│ │ ├── writing-plans 編寫計劃 │ │
│ │ ├── subagent-driven 子智能體開發 │ │
│ │ ├── test-driven 測試驅動開發 │ │
│ │ ├── systematic-debugging 系統化調試 │ │
│ │ └── ... 共 13 個核心技能 │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 平台適配層 │ │
│ │ │ │
│ │ Claude Code │ Cursor │ OpenCode │ Codex │ Gemini │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
五大平台支援
Superpowers 支援主流 AI 編程平台，安裝方式好靈活：
| Claude Code | .claude-plugin/plugin.json | |
| Cursor | /add-plugin | hooks/hooks-cursor.json |
| OpenCode | opencode.json | opencode.json |
| Codex | .codex/INSTALL.md | |
| Gemini CLI | gemini extensions install | gemini-extension.json |
13 個核心技能（Skills）
┌─────────────────────────────────────────────────────────┐
│ Skills 技能矩陣 │
├─────────────────────────────────────────────────────────┤
│ │
│ 🔮 流程類技能（Process Skills） │
│ ├── brainstorming 頭腦風暴 │
│ ├── systematic-debugging 系統化調試 │
│ ├── receiving-code-review 接收代碼審查 │
│ └── requesting-code-review 請求代碼審查 │
│ │
│ 🎯 執行類技能（Implementation Skills） │
│ ├── writing-plans 編寫實施計劃 │
│ ├── executing-plans 執行計劃 │
│ ├── test-driven-development 測試驅動開發 │
│ ├── subagent-driven-development 子智能體開發 │
│ ├── dispatching-parallel-agents 並行代理調度 │
│ ├── finishing-a-development-branch 完成開發分支 │
│ └── verification-before-completion 完成前驗證 │
│ │
│ 📝 元技能（Meta Skills） │
│ ├── using-superpowers 使用 Superpowers │
│ └── writing-skills 編寫新技能 │
│ │
└─────────────────────────────────────────────────────────┘
工作流：點樣令 AI「學會」開發
第一階段：理解需求（Brainstorming）
用戶：幫我做一個用戶登錄功能
┌─────────────────────────────────────────────────────────┐
│ 頭腦風暴流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ 1️⃣ AI 不會直接答應，而是反問： │
│ "你是想要： │
│ A) 用戶名密碼登錄 │
│ B) 社交賬號登錄（Google/GitHub） │
│ C) 手機號驗證碼登錄 │
│ ..." │
│ │
│ 2️⃣ AI 啓動 Brainstorming Skill，展示設計選項 │
│ 讓用戶明確需求細節 │
│ │
│ 3️⃣ 生成需求規格說明書 │
│ │
└─────────────────────────────────────────────────────────┘
第二階段：制定計劃（Writing Plans）
AI 生成的實施計劃應該：
├── 清晰到"熱情但沒經驗的初級工程師"也能看懂
├── 強調 TDD（先寫測試，再寫功能）
├── 遵循 YAGNI（你不會需要它）
└── 遵循 DRY（不要重複自己）
第三階段：子智能體驅動開發（Subagent-Driven Development）
┌─────────────────────────────────────────────────────────┐
│ 子智能體協作模式 │
├─────────────────────────────────────────────────────────┤
│ │
│ 主智能體 │
│ (Orchestrator) │
│ │ │
│ ┌─────────┼─────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │後端 │ │前端 │ │測試 │ │
│ │Agent │ │Agent │ │Agent │ │
│ │ │ │ │ │ │ │
│ │實現API │ │實現UI │ │編寫 │ │
│ │ │ │ │ │單元測試│ │
│ └────────┘ └────────┘ └────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
第四階段：驗證與完成（Verification）
┌─────────────────────────────────────────────────────────┐
│ 驗證檢查清單 │
├─────────────────────────────────────────────────────────┤
│ │
│ ✅ 功能測試通過 │
│ ✅ 代碼審查通過 │
│ ✅ 文檔已更新 │
│ ✅ Git 分支已合併（可選） │
│ ✅ 向用戶確認完成 │
│ │
└─────────────────────────────────────────────────────────┘
技術實現：Hooks 系統
Session 生命週期鈎子
┌─────────────────────────────────────────────────────────┐
│ Session 啓動流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 觸發事件 │───▶│ hooks.json│───▶│session- │ │
│ │ startup │ │ │ │start │ │
│ │ clear │ │ │ │腳本 │ │
│ │ compact │ │ │ │ │ │
│ └──────────┘ └──────────┘ └────┬─────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ 初始化邏輯 │ │
│ │ · 檢測平台 │ │
│ │ · 注入上下文 │ │
│ │ · 加載技能 │ │
│ └──────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ Session 就緒 │ │
│ │ 技能已加載 │ │
│ └──────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
Hook 執行鏈
┌─────────────────────────────────────────────────────────┐
│ Hook 執行鏈流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ 觸發事件 │
│ (startup / clear / compact) │
│ │ │
│ ▼ │
│ hooks/hooks.json ──▶ 讀取 SessionStart 定義 │
│ │ │
│ ▼ │
│ hooks/session-start (bash 腳本) │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────┐ │
│ │ 初始化邏輯 │ │
│ │ 1. 檢測平台 (Claude Code / Cursor) │ │
│ │ 2. 通過 printf 注入 using-superpowers │ │
│ │ 3. 加載技能上下文 │ │
│ └──────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ Session 就緒，技能已加載 ✅ │
│ │
└─────────────────────────────────────────────────────────┘
核心元技能：using-superpowers
Skill 結構詳解
using-superpowers 是一個元技能（Meta Skill），佢喺每次會話啟動時自動注入，負責管理所有其他技能嘅調用規則。
┌─────────────────────────────────────────────────────────┐
│ using-superpowers Skill 結構 │
├─────────────────────────────────────────────────────────┤
│ │
│ <SUBAGENT-STOP> │
│ ├── 作用：阻止子智能體遞歸激活協議 │
│ └── 防止無限循環調用 │
│ │
│ <EXTREMELY-IMPORTANT> │
│ ├── 作用：1% 規則強制執行 │
│ └── 防止 AI 跳過關鍵檢查點 │
│ │
│ Platform Adaptation │
│ ├── 作用：平台特定工具映射 │
│ └── 適配不同 AI 平台的工具差異 │
│ │
│ The Rule │
│ ├── 作用：技能調用決策流程 │
│ └── 定義何時調用哪個技能 │
│ │
│ Red Flags │
│ ├── 作用：識別 AI 的"偷懶"藉口 │
│ └── 常見：跳過測試、忽略審查等 │
│ │
└─────────────────────────────────────────────────────────┘
1% 規則（The 1% Rule）
呢個係 Superpowers 最核心嘅設計理念之一：
┌─────────────────────────────────────────────────────────┐
│ 1% 規則 │
├─────────────────────────────────────────────────────────┤
│ │
│ 當智能體提議修改超過 1% 的代碼時，必須： │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ ❌ "我知道需求，直接改了" │ │
│ │ ↓ │ │
│ │ ✅ 必須先啓動相應技能 │ │
│ │ │ │
│ │ 例如：修改 API 邏輯 → 啓動 executing-plans │ │
│ │ 添加新測試 → 啓動 test-driven │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 為什麼要這樣做？ │
│ └── AI 的"直覺"往往忽略邊界情況和最佳實踐 │
│ │
└─────────────────────────────────────────────────────────┘
技能優先級
技能調用優先級：
1. 🔮 Process Skills（流程類）優先級更高
2. 🎯 Implementation Skills（執行類）
原因：先確保流程正確，再執行具體實現
目錄結構
┌─────────────────────────────────────────────────────────┐
│ Superpowers 項目結構 │
├─────────────────────────────────────────────────────────┤
│ │
│ superpowers/ │
│ │ │
│ ├── .claude-plugin/ # Claude Code 插件配置 │
│ │ └── plugin.json # 插件清單 │
│ │ │
│ ├── .cursor-plugin/ # Cursor 插件配置 │
│ │ │
│ ├── .codex/ # Codex 配置 │
│ │ └── INSTALL.md # 安裝說明 │
│ │ │
│ ├── .opencode/ # OpenCode 配置 │
│ │ │
│ ├── hooks/ # Hook 腳本 │
│ │ ├── hooks.json # Hook 定義 │
│ │ ├── session-start # 會話啓動腳本 │
│ │ └── run-hook.cmd # Windows 兼容腳本 │
│ │ │
│ ├── skills/ # 13 個核心技能 │
│ │ ├── brainstorming/ # 頭腦風暴 │
│ │ ├── writing-plans/ # 編寫計劃 │
│ │ ├── subagent-driven/ # 子智能體開發 │
│ │ ├── test-driven/ # 測試驅動開發 │
│ │ ├── systematic-debugging/ # 系統化調試 │
│ │ └── ... # 更多技能 │
│ │ │
│ ├── commands/ # Slash Commands │
│ │ ├── brainstorm.md # /brainstorm │
│ │ ├── write-plan.md # /write-plan │
│ │ └── execute-plan.md # /execute-plan │
│ │ │
│ ├── agents/ # Agent 模板 │
│ │ │
│ ├── docs/ # 文檔 │
│ │ │
│ ├── tests/ # 測試 │
│ │ │
│ └── package.json # 版本: 5.0.5 │
│ │
└─────────────────────────────────────────────────────────┘
Commands：Slash Commands
Superpowers 提供咗 3 個核心 Slash Commands：
┌─────────────────────────────────────────────────────────┐
│ Slash Commands 速查表 │
├─────────────────────────────────────────────────────────┤
│ │
│ /brainstorm │
│ └── 啓動頭腦風暴：明確需求、討論方案 │
│ │
│ /write-plan │
│ └── 制定實施計劃：拆解任務、設定檢查點 │
│ │
│ /execute-plan │
│ └── 執行計劃：啓動子智能體、推進開發 │
│ │
└─────────────────────────────────────────────────────────┘
Agents：子智能體模板
┌─────────────────────────────────────────────────────────┐
│ Agent 協作架構 │
├─────────────────────────────────────────────────────────┤
│ │
│ 主智能體 │
│ (Orchestrator) │
│ │ │
│ ┌──────────┼──────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Backend │ │ Frontend │ │ Test │ │
│ │ Agent │ │ Agent │ │ Agent │ │
│ │ │ │ │ │ │ │
│ │ 業務邏輯 │ │ UI 組件 │ │ 單元測試 │ │
│ │ API 接口 │ │ 頁面路由 │ │ 集成測試 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ 特點： │
│ ├── 每個 Agent 有明確的職責邊界 │
│ ├── 通過主智能體協調工作 │
│ └── 避免重複工作和衝突 │
│ │
└─────────────────────────────────────────────────────────┘
TDD 工作流
Superpowers 強制執行 TDD（測試驅動開發）：
┌─────────────────────────────────────────────────────────┐
│ TDD 循環 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────┐ │
│ │ │ │
│ ▼ │ │
│ ┌─────────┐ │ │
│ │ 寫測試 │ │ │
│ │ RED │ │ │
│ └────┬────┘ │ │
│ │ │ │
│ ▼ │ │
│ ┌─────────┐ │ │
│ │ 寫代碼 │ │ │
│ │ GREEN │ │ │
│ └────┬────┘ │ │
│ │ │ │
│ ▼ │ │
│ ┌─────────┐ │ │
│ │ 重構 │─────────────────────┘ │
│ │ REFACTOR│ ← 測試通過後可進行 │
│ └─────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
系統化除錯流程
當出現問題嘅時候，Superpowers 有標準化嘅除錯流程：
┌─────────────────────────────────────────────────────────┐
│ 系統化調試流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ 1️⃣ 復現問題 │
│ └── 找到能穩定復現 bug 的步驟 │
│ │
│ 2️⃣ 分析日誌 │
│ └── 定位錯誤發生的具體位置 │
│ │
│ 3️⃣ 形成假設 │
│ └── "我認為是 X 導致了 Y" │
│ │
│ 4️⃣ 驗證假設 │
│ └── 通過測試或修改代碼驗證 │
│ │
│ 5️⃣ 修復並測試 │
│ └── 修復後確保不引入新問題 │
│ │
└─────────────────────────────────────────────────────────┘
版本歷史
| v5.0.5 | ||
| v5.0.4 | ||
| v5.0.0 | ||
| v4.x |
同傳統開發方式嘅對比
┌─────────────────────────────────────────────────────────┐
│ 傳統 AI 開發 vs Superpowers │
├─────────────────────────────────────────────────────────┤
│ │
│ 傳統 AI 開發 │
│ ├── 直接寫代碼 → 可能返工 │
│ ├── 單個 Agent → 上下文爆炸 │
│ ├── 忽略測試 → 質量不穩定 │
│ └── 隨意提交 → 代碼風格不一致 │
│ │
│ Superpowers │
│ ├── 先規劃後開發 → 減少返工 │
│ ├── 多 Agent 協作 → 上下文清晰 │
│ ├── 強制 TDD → 質量有保障 │
│ └── 規範流程 → 團隊協作順暢 │
│ │
└─────────────────────────────────────────────────────────┘
適用場景
┌─────────────────────────────────────────────────────────┐
│ Superpowers 適用場景 │
├─────────────────────────────────────────────────────────┤
│ │
│ ✅ 複雜項目開發 │
│ └── 需要多人協作的大型項目 │
│ │
│ ✅ 需要規範流程 │
│ └── 企業級開發，需要統一標準 │
│ │
│ ✅ AI First 項目 │
│ └── 純 AI 驅動的開發團隊 │
│ │
│ ✅ 培訓 AI 智能體 │
│ └── 讓 AI 學習正確的開發方法論 │
│ │
└─────────────────────────────────────────────────────────┘
快速入門
安裝到 Claude Code
# 方式 1: 官方插件市場安裝
claude plugin install superpowers
# 方式 2: 手動克隆
git clone https://github.com/obra/superpowers.git ~/.claude/commands/superpowers
確認安裝
# 查看技能目錄
ls ~/.claude/commands/superpowers/skills
🔗 延伸資源
呢篇文章係基於 DeepWiki 對 Superpowers 項目嘅深度解析編寫嘅。
引用連結
[1]https://github.com/obra/superpowers
[2]https://deepwiki.com/obra/superpowers
深度解析 Superpowers：讓 AI 編程智能體真正學會"協作開發"
當 AI 編程助手越來越強大，一個核心問題浮現出來：如何讓 AI 不只是寫代碼，而是像真正的開發者一樣思考、協作、迭代？ Superpowers 正是為解決這個問題而生。
Superpowers 是什麼？
Superpowers 是一個面向 AI 編程智能體的完整軟件開發工作流框架。它不是簡單的提示詞集合，而是一套系統化的開發方法論，讓 AI 智能體能夠：
┌─────────────────────────────────────────────────────────┐
│ Superpowers 核心理念 │
├─────────────────────────────────────────────────────────┤
│ │
│ 🔄 從"直接寫代碼"到"先理解需求" │
│ AI 不是一上來就寫代碼，而是先問清楚"你要做什麼" │
│ │
│ 📐 從"隨性發揮"到"規範流程" │
│ 強制執行 TDD、YAGNI、DRY 等最佳實踐 │
│ │
│ 👥 從"單打獨鬥"到"團隊協作" │
│ 子智能體驅動開發，多角色分工 │
│ │
│ ✅ 從"寫完算數"到"驗證通過" │
│ 每個步驟都有檢查點，確保質量 │
│ │
└─────────────────────────────────────────────────────────┘
核心架構圖
┌─────────────────────────────────────────────────────────┐
│ Superpowers 系統架構 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 用戶交互層 │ │
│ │ 你告訴 AI 要做什麼 → AI 彙報進展 → 你審批 │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Skills 技能庫 │ │
│ │ │ │
│ │ ├── brainstorming 頭腦風暴 │ │
│ │ ├── writing-plans 編寫計劃 │ │
│ │ ├── subagent-driven 子智能體開發 │ │
│ │ ├── test-driven 測試驅動開發 │ │
│ │ ├── systematic-debugging 系統化調試 │ │
│ │ └── ... 共 13 個核心技能 │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 平台適配層 │ │
│ │ │ │
│ │ Claude Code │ Cursor │ OpenCode │ Codex │ Gemini │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
五大平台支持
Superpowers 支持主流 AI 編程平台，安裝方式靈活：
| Claude Code | .claude-plugin/plugin.json | |
| Cursor | /add-plugin | hooks/hooks-cursor.json |
| OpenCode | opencode.json | opencode.json |
| Codex | .codex/INSTALL.md | |
| Gemini CLI | gemini extensions install | gemini-extension.json |
13 個核心 Skills 技能
┌─────────────────────────────────────────────────────────┐
│ Skills 技能矩陣 │
├─────────────────────────────────────────────────────────┤
│ │
│ 🔮 流程類技能（Process Skills） │
│ ├── brainstorming 頭腦風暴 │
│ ├── systematic-debugging 系統化調試 │
│ ├── receiving-code-review 接收代碼審查 │
│ └── requesting-code-review 請求代碼審查 │
│ │
│ 🎯 執行類技能（Implementation Skills） │
│ ├── writing-plans 編寫實施計劃 │
│ ├── executing-plans 執行計劃 │
│ ├── test-driven-development 測試驅動開發 │
│ ├── subagent-driven-development 子智能體開發 │
│ ├── dispatching-parallel-agents 並行代理調度 │
│ ├── finishing-a-development-branch 完成開發分支 │
│ └── verification-before-completion 完成前驗證 │
│ │
│ 📝 元技能（Meta Skills） │
│ ├── using-superpowers 使用 Superpowers │
│ └── writing-skills 編寫新技能 │
│ │
└─────────────────────────────────────────────────────────┘
工作流：如何讓 AI "學會"開發
第一階段：理解需求（Brainstorming）
用戶：幫我做一個用戶登錄功能
┌─────────────────────────────────────────────────────────┐
│ 頭腦風暴流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ 1️⃣ AI 不會直接答應，而是反問： │
│ "你是想要： │
│ A) 用戶名密碼登錄 │
│ B) 社交賬號登錄（Google/GitHub） │
│ C) 手機號驗證碼登錄 │
│ ..." │
│ │
│ 2️⃣ AI 啓動 Brainstorming Skill，展示設計選項 │
│ 讓用戶明確需求細節 │
│ │
│ 3️⃣ 生成需求規格說明書 │
│ │
└─────────────────────────────────────────────────────────┘
第二階段：制定計劃（Writing Plans）
AI 生成的實施計劃應該：
├── 清晰到"熱情但沒經驗的初級工程師"也能看懂
├── 強調 TDD（先寫測試，再寫功能）
├── 遵循 YAGNI（你不會需要它）
└── 遵循 DRY（不要重複自己）
第三階段：子智能體驅動開發（Subagent-Driven Development）
┌─────────────────────────────────────────────────────────┐
│ 子智能體協作模式 │
├─────────────────────────────────────────────────────────┤
│ │
│ 主智能體 │
│ (Orchestrator) │
│ │ │
│ ┌─────────┼─────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │後端 │ │前端 │ │測試 │ │
│ │Agent │ │Agent │ │Agent │ │
│ │ │ │ │ │ │ │
│ │實現API │ │實現UI │ │編寫 │ │
│ │ │ │ │ │單元測試│ │
│ └────────┘ └────────┘ └────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
第四階段：驗證與完成（Verification）
┌─────────────────────────────────────────────────────────┐
│ 驗證檢查清單 │
├─────────────────────────────────────────────────────────┤
│ │
│ ✅ 功能測試通過 │
│ ✅ 代碼審查通過 │
│ ✅ 文檔已更新 │
│ ✅ Git 分支已合併（可選） │
│ ✅ 向用戶確認完成 │
│ │
└─────────────────────────────────────────────────────────┘
技術實現：Hooks 系統
Session 生命週期鈎子
┌─────────────────────────────────────────────────────────┐
│ Session 啓動流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 觸發事件 │───▶│ hooks.json│───▶│session- │ │
│ │ startup │ │ │ │start │ │
│ │ clear │ │ │ │腳本 │ │
│ │ compact │ │ │ │ │ │
│ └──────────┘ └──────────┘ └────┬─────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ 初始化邏輯 │ │
│ │ · 檢測平台 │ │
│ │ · 注入上下文 │ │
│ │ · 加載技能 │ │
│ └──────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ Session 就緒 │ │
│ │ 技能已加載 │ │
│ └──────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
Hook 執行鏈
┌─────────────────────────────────────────────────────────┐
│ Hook 執行鏈流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ 觸發事件 │
│ (startup / clear / compact) │
│ │ │
│ ▼ │
│ hooks/hooks.json ──▶ 讀取 SessionStart 定義 │
│ │ │
│ ▼ │
│ hooks/session-start (bash 腳本) │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────┐ │
│ │ 初始化邏輯 │ │
│ │ 1. 檢測平台 (Claude Code / Cursor) │ │
│ │ 2. 通過 printf 注入 using-superpowers │ │
│ │ 3. 加載技能上下文 │ │
│ └──────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ Session 就緒，技能已加載 ✅ │
│ │
└─────────────────────────────────────────────────────────┘
核心元技能：using-superpowers
Skill 結構詳解
using-superpowers 是一個元技能（Meta Skill），它在每次會話啓動時自動注入，負責管理所有其他技能的調用規則。
┌─────────────────────────────────────────────────────────┐
│ using-superpowers Skill 結構 │
├─────────────────────────────────────────────────────────┤
│ │
│ <SUBAGENT-STOP> │
│ ├── 作用：阻止子智能體遞歸激活協議 │
│ └── 防止無限循環調用 │
│ │
│ <EXTREMELY-IMPORTANT> │
│ ├── 作用：1% 規則強制執行 │
│ └── 防止 AI 跳過關鍵檢查點 │
│ │
│ Platform Adaptation │
│ ├── 作用：平台特定工具映射 │
│ └── 適配不同 AI 平台的工具差異 │
│ │
│ The Rule │
│ ├── 作用：技能調用決策流程 │
│ └── 定義何時調用哪個技能 │
│ │
│ Red Flags │
│ ├── 作用：識別 AI 的"偷懶"藉口 │
│ └── 常見：跳過測試、忽略審查等 │
│ │
└─────────────────────────────────────────────────────────┘
1% 規則（The 1% Rule）
這是 Superpowers 最核心的設計理念之一：
┌─────────────────────────────────────────────────────────┐
│ 1% 規則 │
├─────────────────────────────────────────────────────────┤
│ │
│ 當智能體提議修改超過 1% 的代碼時，必須： │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ ❌ "我知道需求，直接改了" │ │
│ │ ↓ │ │
│ │ ✅ 必須先啓動相應技能 │ │
│ │ │ │
│ │ 例如：修改 API 邏輯 → 啓動 executing-plans │ │
│ │ 添加新測試 → 啓動 test-driven │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 為什麼要這樣做？ │
│ └── AI 的"直覺"往往忽略邊界情況和最佳實踐 │
│ │
└─────────────────────────────────────────────────────────┘
技能優先級
技能調用優先級：
1. 🔮 Process Skills（流程類）優先級更高
2. 🎯 Implementation Skills（執行類）
原因：先確保流程正確，再執行具體實現
目錄結構
┌─────────────────────────────────────────────────────────┐
│ Superpowers 項目結構 │
├─────────────────────────────────────────────────────────┤
│ │
│ superpowers/ │
│ │ │
│ ├── .claude-plugin/ # Claude Code 插件配置 │
│ │ └── plugin.json # 插件清單 │
│ │ │
│ ├── .cursor-plugin/ # Cursor 插件配置 │
│ │ │
│ ├── .codex/ # Codex 配置 │
│ │ └── INSTALL.md # 安裝說明 │
│ │ │
│ ├── .opencode/ # OpenCode 配置 │
│ │ │
│ ├── hooks/ # Hook 腳本 │
│ │ ├── hooks.json # Hook 定義 │
│ │ ├── session-start # 會話啓動腳本 │
│ │ └── run-hook.cmd # Windows 兼容腳本 │
│ │ │
│ ├── skills/ # 13 個核心技能 │
│ │ ├── brainstorming/ # 頭腦風暴 │
│ │ ├── writing-plans/ # 編寫計劃 │
│ │ ├── subagent-driven/ # 子智能體開發 │
│ │ ├── test-driven/ # 測試驅動開發 │
│ │ ├── systematic-debugging/ # 系統化調試 │
│ │ └── ... # 更多技能 │
│ │ │
│ ├── commands/ # Slash Commands │
│ │ ├── brainstorm.md # /brainstorm │
│ │ ├── write-plan.md # /write-plan │
│ │ └── execute-plan.md # /execute-plan │
│ │ │
│ ├── agents/ # Agent 模板 │
│ │ │
│ ├── docs/ # 文檔 │
│ │ │
│ ├── tests/ # 測試 │
│ │ │
│ └── package.json # 版本: 5.0.5 │
│ │
└─────────────────────────────────────────────────────────┘
Commands：Slash Commands
Superpowers 提供了 3 個核心 Slash Commands：
┌─────────────────────────────────────────────────────────┐
│ Slash Commands 速查表 │
├─────────────────────────────────────────────────────────┤
│ │
│ /brainstorm │
│ └── 啓動頭腦風暴：明確需求、討論方案 │
│ │
│ /write-plan │
│ └── 制定實施計劃：拆解任務、設定檢查點 │
│ │
│ /execute-plan │
│ └── 執行計劃：啓動子智能體、推進開發 │
│ │
└─────────────────────────────────────────────────────────┘
Agents：子智能體模板
┌─────────────────────────────────────────────────────────┐
│ Agent 協作架構 │
├─────────────────────────────────────────────────────────┤
│ │
│ 主智能體 │
│ (Orchestrator) │
│ │ │
│ ┌──────────┼──────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Backend │ │ Frontend │ │ Test │ │
│ │ Agent │ │ Agent │ │ Agent │ │
│ │ │ │ │ │ │ │
│ │ 業務邏輯 │ │ UI 組件 │ │ 單元測試 │ │
│ │ API 接口 │ │ 頁面路由 │ │ 集成測試 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ 特點： │
│ ├── 每個 Agent 有明確的職責邊界 │
│ ├── 通過主智能體協調工作 │
│ └── 避免重複工作和衝突 │
│ │
└─────────────────────────────────────────────────────────┘
TDD 工作流
Superpowers 強制執行 TDD（測試驅動開發）：
┌─────────────────────────────────────────────────────────┐
│ TDD 循環 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────┐ │
│ │ │ │
│ ▼ │ │
│ ┌─────────┐ │ │
│ │ 寫測試 │ │ │
│ │ RED │ │ │
│ └────┬────┘ │ │
│ │ │ │
│ ▼ │ │
│ ┌─────────┐ │ │
│ │ 寫代碼 │ │ │
│ │ GREEN │ │ │
│ └────┬────┘ │ │
│ │ │ │
│ ▼ │ │
│ ┌─────────┐ │ │
│ │ 重構 │─────────────────────┘ │
│ │ REFACTOR│ ← 測試通過後可進行 │
│ └─────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
系統化調試流程
當出現問題時，Superpowers 有標準化的調試流程：
┌─────────────────────────────────────────────────────────┐
│ 系統化調試流程 │
├─────────────────────────────────────────────────────────┤
│ │
│ 1️⃣ 復現問題 │
│ └── 找到能穩定復現 bug 的步驟 │
│ │
│ 2️⃣ 分析日誌 │
│ └── 定位錯誤發生的具體位置 │
│ │
│ 3️⃣ 形成假設 │
│ └── "我認為是 X 導致了 Y" │
│ │
│ 4️⃣ 驗證假設 │
│ └── 通過測試或修改代碼驗證 │
│ │
│ 5️⃣ 修復並測試 │
│ └── 修復後確保不引入新問題 │
│ │
└─────────────────────────────────────────────────────────┘
版本歷史
| v5.0.5 | ||
| v5.0.4 | ||
| v5.0.0 | ||
| v4.x |
與傳統開發方式的對比
┌─────────────────────────────────────────────────────────┐
│ 傳統 AI 開發 vs Superpowers │
├─────────────────────────────────────────────────────────┤
│ │
│ 傳統 AI 開發 │
│ ├── 直接寫代碼 → 可能返工 │
│ ├── 單個 Agent → 上下文爆炸 │
│ ├── 忽略測試 → 質量不穩定 │
│ └── 隨意提交 → 代碼風格不一致 │
│ │
│ Superpowers │
│ ├── 先規劃後開發 → 減少返工 │
│ ├── 多 Agent 協作 → 上下文清晰 │
│ ├── 強制 TDD → 質量有保障 │
│ └── 規範流程 → 團隊協作順暢 │
│ │
└─────────────────────────────────────────────────────────┘
適用場景
┌─────────────────────────────────────────────────────────┐
│ Superpowers 適用場景 │
├─────────────────────────────────────────────────────────┤
│ │
│ ✅ 複雜項目開發 │
│ └── 需要多人協作的大型項目 │
│ │
│ ✅ 需要規範流程 │
│ └── 企業級開發，需要統一標準 │
│ │
│ ✅ AI First 項目 │
│ └── 純 AI 驅動的開發團隊 │
│ │
│ ✅ 培訓 AI 智能體 │
│ └── 讓 AI 學習正確的開發方法論 │
│ │
└─────────────────────────────────────────────────────────┘
快速開始
安裝到 Claude Code
# 方式 1: 官方插件市場安裝
claude plugin install superpowers
# 方式 2: 手動克隆
git clone https://github.com/obra/superpowers.git ~/.claude/commands/superpowers
驗證安裝
# 查看技能目錄
ls ~/.claude/commands/superpowers/skills
🔗 延伸資源
本文基於 DeepWiki 對 Superpowers 項目的深度解析編寫。
引用連結
[1]https://github.com/obra/superpowers
[2]https://deepwiki.com/obra/superpowers