📅 資料整理日期：2026-09-22
⚠️ 版本／星數等資訊可能隨時間變動
⚠️ 版本／星數等資訊可能隨時間變動
Superpowers 是一套 Agentic Skills Framework（代理式技能框架） 兼軟件開發方法論，專為 AI 編程代理（Coding Agent）而設。它把一整套工程紀律（TDD、系統化除錯、結構化規劃、代碼審查）打包成純文字檔 C1 ，讓 AI 由「你叫它寫就寫的助手」變成「有紀律的資深工程師」。
🧭 第一部分：背景與概覽 #
| 項目 | 詳情 |
|---|---|
| 作者 | Jesse Vincent（GitHub：obra），Prime Radiant 團隊 |
| 發佈時間 | 2025 年 10 月（首篇博客） |
| 代碼倉 | C1 |
| GitHub Stars | 約 290k（2026-09，史上增長最快的開發者工具之一） |
| Fork / 貢獻者 | 25.9k forks / 51 contributors |
| 授權 | MIT（開源） |
| 最新版本 | v6.4.1（2026-09-19） |
| 核心構成 | 14 個 C1 技能檔 + Session Hook + 多平台 manifest |
作者背景 #
Jesse Vincent 並非 AI 界新人，長期開發別人依賴的基建工具：
- Request Tracker (RT)：1990 年代的票務系統
- Perl 6：2005–2008 年擔任專案經理
- Keyboardio：共同創辦人（機械鍵盤）
- K-9 Mail：Android 電郵 App，後被 Mozilla 收購、改名 Thunderbird for Android
核心洞見 #
Superpowers 的出發點是一句反直覺判斷：
AI 編程代理缺的不是「能力」，而是「紀律」。
模型本身懂得 TDD、懂得除錯，但在有捷徑可走時會「說服自己」跳過步驟。Superpowers 的做法是用純文字把紀律固化下來，不靠 fine-tune、不靠專有 SDK。
🧩 第二部分：14 個核心技能 #
技能分四大類，每個都是一個獨立的 C1 檔：
🧪 測試類（Testing） #
| 技能 | 作用 |
|---|---|
| C1 | 嚴格 RED-GREEN-REFACTOR（紅綠重構）循環 + 反模式目錄 |
🐞 除錯類（Debugging） #
| 技能 | 作用 |
|---|---|
| C1 | 四階段根因分析（重現 → 收集數據 → 分析成因 → 驗證修復） |
| C1 | 基於證據的完成驗證，不准空口說做完 |
🤝 協作類（Collaboration） #
| 技能 | 作用 |
|---|---|
| C1 | 結構化頭腦風暴，寫代碼前先釐清需求 |
| C1 | 把功能拆成 2–5 分鐘可完成的小任務 |
| C1 | 執行已寫好的計劃 |
| C1 | 每個任務派一個全新 subagent 實作 |
| C1 | 並行調度多個代理 |
| C1 | 主動請求代碼審查 |
| C1 | 處理審查回饋 |
| C1 | 用 Git Worktree 隔離工作區 |
| C1 | 分支收尾、合併／發 PR／清理 |
🔧 元技能（Meta-Skills） #
| 技能 | 作用 |
|---|---|
| C1 | 教 AI 寫新技能（技能中的技能） |
| C1 | 系統啟動引導（Bootstrap） |
兩層技能架構 #
- 核心技能（Core Skills）：隨插件安裝，提供通用方法論
- 個人技能（Personal Skills）：放在 C1 ，可自訂；命中時優先覆蓋核心技能
🔄 第三部分：七階段開發流程 #
由想法到交付，代理會走一條結構化流水線，不會一來就寫代碼：
| 階段 | 技能 | 要點 |
|---|---|---|
| 1. Brainstorming（腦力激盪） | C1 | 蘇格拉底式提問釐清問題，產出設計文件，逐段等你批准 |
| 2. Worktree 隔離 | C1 | 在新分支建立隔離工作區，確認現有測試全過才開始 |
| 3. 寫計劃 | C1 | 拆成小任務，每項含確切檔案路徑 + 驗證步驟 |
| 4. Subagent 實作 | C1 | 每任務派一個 fresh subagent，做完兩階段審查（規格 + 品質） |
| 5. TDD 實作 | C1 | 先寫失敗測試 → 最少代碼令它過 → 重構 → 提交 |
| 6. 代碼審查 | C1 | 按嚴重度（Critical / Major / Minor）分類，Critical 阻斷進度 |
| 7. 分支收尾 | C1 | 驗證全測試過，再揀合併／發 PR／繼續 |
💡 關鍵心得：計劃（Plan）的人工覆核步驟一定不可以跳。計劃質素直接決定執行質素，花時間規劃可省下數小時返工。
⚖️ 第四部分：三大 Iron Laws（鐵律）與 Red Flags #
每個嚴格技能都以一條大寫、不可協商的鐵律開頭，再附一張「合理化藉口（Red Flags）」表，專防代理說服自己偷步。
| 技能 | Iron Law（鐵律） | 會阻斷的常見藉口 |
|---|---|---|
| TDD | NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST（無失敗測試就無產品代碼） | 「測試第一次跑就過」、「留返已刪代碼做參考」、「就今次一次」 |
| 驗證 | NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE（無新鮮驗證證據就不准說完成） | 「should」、「probably」、「seems to」這類模糊字眼 |
| 除錯 | NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST（未查根因前不准修復） | 症狀消失就當修好、跳過調查直接亂試 |
這些不是勵志海報，而是把資深工程師的 code review 意見硬編碼成指令。目標不是「教」代理（它本身懂），而是防止它自我說服去違反紀律。
真實成效 #
- chardet 7.0.0：用 Superpowers 重寫，快 41 倍、準確度 96.8%，修復數十個積壓 issue；覆蓋 2,161 個檔案、99 種編碼的完整測試套件，正是 TDD 的直接產物。
🖥️ 第五部分：多平台支援與安裝 #
同一份 C1 目錄可跨多個代理主機運作，靠各自的 thin manifest 指回同一批 Markdown：
| 平台 | 安裝方式 |
|---|---|
| Claude Code（整合最深） | C1 |
| Claude Code（社群市場） | /plugin install superpowers@superpowers-marketplace 然後 C2 |
| Cursor | C1 或在市場搜尋 |
| Codex CLI | 指示 Codex 讀取 C1 |
| Gemini CLI | C1 |
| OpenCode | C1 |
其餘支援：GitHub Copilot CLI、Qwen Code、Goose CLI、Auggie。
技能如何觸發 #
- 無需記指令，框架會自動偵測任務類型並激活對應技能
- 亦可手動：
/superpowers:write-plan、/superpowers:execute-plan、 C3 - 啟動引導（Bootstrap）低於 2,000 tokens，具體技能按需載入，非常節省 token
🎯 第六部分：適用場景與限制 #
✅ 最適合 #
| 場景 | 原因 |
|---|---|
| 多檔案重構 | 需要規劃 + 測試保護 |
| 需要測試覆蓋的生產功能 | TDD 強制執行 |
| 需要團隊一致性的專案 | 統一方法論 |
| 長時間遷移任務 | subagent 自主運作數小時不偏離 |
| 需架構設計的複雜功能 | 腦力激盪先釐清 |
⚠️ 較不適合 #
| 場景 | 原因 |
|---|---|
| 一兩行的快速修 bug | 紀律流程是 overkill |
| 原型 / Demo | 不需要工程紀律 |
| 單檔案小改動 | 同上 |
| 簡單配置更新 | 同上 |
🚧 已知限制 #
| 限制 | 說明 |
|---|---|
| Subagent 上下文注入問題 | 子代理可能收不到 C1 注入，導致技能激活不一致（known issue） |
| 模型過度推斷 | Opus 4.5 有時「靠描述猜」技能內容而非真讀，靠改 description 緩解 |
| Token 消耗 | 完整 brainstorm→plan→execute 流程會用較多 token |
🔗 參考連結 #
資料來源：GitHub 官方倉庫、作者博客及各公開評析（2026 年 9 月）