已收錄317 則資訊/102 款 AI 工具/399 個開源專案/74 個學習資源
首頁資訊開源排行榜模型排行AI 工具學習資源
首頁 / 開源排行榜 / superpowers

superpowers

一個可組合的技能庫，為 AI 程式碼代理提供嚴謹、測試驅動的軟體開發方法論。

ShellMITskill
⭐ GitHubhttps://github.com/obra/superpowers
272,614
Star 數
+0
Star 增速
2026年8月13日
最後更新
4
點擊數

1. 專案概覽

Superpowers 是一套專為 AI 程式碼代理設計的開源軟體開發方法論——這是一個由「技能」組成的可組合函式庫，能引導 Claude Code、Cursor 和 Codex CLI 等工具遵循嚴謹且以證據為導向的工作流程，而非任由它們直接跳入臨時性的程式碼撰寫。

2. 背景與定位

Superpowers 的誕生旨在解決 AI 程式碼代理常見的失敗模式：先寫程式碼再思考、跳過設計審查、略過測試，並在未經實質驗證的情況下便宣稱任務「完成」。其核心使命是賦予代理一套可重複且具備專業水準的流程——包含腦力激盪、規劃、隔離執行、測試驅動開發及程式碼審查——確保代理生成的軟體能達到與人類工程團隊相同的標準。

不同於單一用途的提示詞庫或一次性的「程式碼代理」封裝工具，Superpowers 明確定位為方法論加上技能庫，而非單一工具。它在設計上與代理無關：同一套技能集可安裝於 13 種以上的不同程式碼代理（包括 Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Devin 等），而不綁定於特定廠商的生態系統。它亦強調「系統化決策優於臨時決策」以及「證據優於主張」，這使其有別於那些不強制執行流程紀律的輕量級提示工程集合。

3. 功能分類

  • 🧪 測試 — 1 項技能。test-driven-development 強制執行嚴格的 RED-GREEN-REFACTOR 循環，確保代理在撰寫實作程式碼前先編寫會失敗的測試。
  • 🐞 除錯 — 2 項技能。systematic-debugging 推動根本原因分析而非憑空猜測；verification-before-completion 則阻止代理在缺乏實際運作證據的情況下將工作標記為「完成」。
  • 🤝 協作 — 9 項技能。包含 brainstorming（在撰寫程式碼前與使用者進行設計驗證）、writing-plans / executing-plans（任務分解與執行）、dispatching-parallel-agents（將工作分派給子代理）、requesting-code-review / receiving-code-review、using-git-worktrees（隔離且安全的開發分支）、finishing-a-development-branch，以及 subagent-driven-development。
  • 🧩 後設技能 — 2 項技能。writing-skills 說明如何撰寫新技能；using-superpowers 則解釋框架本身應如何被呼叫與組合。

4. 主要亮點

  • 七階段開發工作流程 — 每個任務都會經歷設計腦力激盪、git worktree 隔離、任務分解、附帶審查循環的子代理執行、TDD、基於規格書的程式碼審查以及分支清理，賦予代理驅動的開發一致的結構。
  • 與代理無關的安裝方式 — 適用於 13 種以上的程式碼代理（Claude Code、Cursor、Codex CLI、Gemini CLI、GitHub Copilot CLI、Devin、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi、Hermes Agent），團隊不會被鎖定在單一廠商。
  • 預設採用測試驅動開發 — test-driven-development 技能使 RED-GREEN-REFACTOR 成為預設循環，而非可選的紀律。
  • 重證據輕主張的驗證機制 — verification-before-completion 專門設計用來防止代理在沒有證明的情況下自行回報成功。
  • Git worktree 隔離 — 開發工作在隔離的 worktree 中進行，避免實驗性或進行中的代理工作影響主分支的穩定性。
  • 可組合、可擴充的技能庫 — 技能是模組化且基於 Markdown 的單元（SKILL.md），而 writing-skills 則為希望新增自訂技能的團隊記錄了相關模式。

5. 依角色劃分的使用情境

  • 一般開發人員 — 將 Superpowers 安裝到您選擇的程式碼代理中，即可在日常的代理輔助程式設計環節中內建結構化規劃、TDD 強制執行及程式碼審查。
  • 專案經理 / 技術主管 — 利用腦力激盪與規劃技能，讓代理在開始實作前揭示設計取捨並產出可供審查的計畫，減少意外的重寫情況。
  • 開源維護者 — using-git-worktrees 和 finishing-a-development-branch 技能有助於保持代理提交的分支隔離且整潔，減輕維護者的審查負擔。

（DevOps/SRE、安全工程以及資料/研究科學並非本專案的重點領域，故未列入。）

6. 快速入門

尋找所需內容
您可以在儲存庫的 skills/ 目錄中按類別（測試、除錯、協作、後設）瀏覽技能庫，或閱讀 docs/ 以獲取針對特定代理的設定說明。

安裝 / 整合
安裝只需針對您的程式碼代理執行單一指令，例如：

# Claude Code
/plugin install superpowers@claude-plugins-official

# Cursor
/add-plugin superpowers

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# GitHub Copilot CLI
copilot plugin install superpowers@superpowers-marketplace

請參閱儲存庫 README 以取得涵蓋所有 13 種以上支援代理的完整表格。

貢獻
請 Fork 此儲存庫，從 dev 分支進行開發，並在發起 Pull Request 前遵循 skills/writing-skills/SKILL.md 中記載的方法論。請注意，維護者表示通常不接受全新技能的貢獻——修復錯誤及改進現有技能才是主要的貢獻途徑。

7. 專案結構

superpowers/
├── .claude-plugin/     # Claude Code 外掛資訊清單
├── .cursor-plugin/     # Cursor 外掛資訊清單
├── .devin-plugin/      # Devin 外掛資訊清單
├── .kimi-plugin/       # Kimi Code 外掛資訊清單
├── .opencode/          # OpenCode 擴充套件 + INSTALL.md
├── .pi/extensions/     # Pi 擴充套件資訊清單
├── .agents/plugins/    # 共用代理外掛定義
├── skills/             # 核心技能庫（每個技能對應一個 SKILL.md）
├── docs/               # 特定代理及通用文件
├── hooks/              # 工作流程鉤子
├── scripts/            # 輔助自動化腳本
├── assets/             # 靜態資源（標誌、遙測像素等）
└── tests/              # 測試套件 / 評估框架

skills/ 目錄是本專案的核心——每個技能都是一個獨立的 SKILL.md，描述代理應在何時以及如何應用該技能。.{agent}-plugin/ 目錄則將相同的技能庫調適為各支援程式碼代理的外掛格式。

8. 相關生態系統

Superpowers 依賴其所安裝的程式碼代理平台——Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Codex CLI、Devin、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi 和 Hermes Agent——這些平台各自提供了底層的 LLM 執行環境及外掛/擴充機制，供 Superpowers 的技能在其上運行。它透過疊加共享的開發方法論來補充（而非取代）每個代理的原生功能。

9. 授權條款

  • ✅ 允許免費使用、複製、修改、合併、發布及散布，包括用於商業目的（MIT 授權）。
  • ✅ 允許免費安裝至任何支援的程式碼代理，無論個人或組織皆可使用。
  • ❌ 不提供任何擔保——軟體係以「現狀」提供。
  • ℹ️ 原始版權聲明及授權條款必須保留在軟體的副本或重要部分中。
  • ℹ️ 本專案包含可選用的退出式遙測功能（透過標誌載入信標追蹤版本採用情況）；可透過環境變數停用。

10. 常見問題

問：Superpowers 適用於我的程式碼代理嗎？
答：它支援 13 種以上的代理，包括 Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Codex CLI 和 Devin——請查閱 README 中的安裝表格，以取得適用於您代理的確切指令。

問：Superpowers 是單一工具還是一組提示詞？
答：兩者皆非——它是一套結構化的方法論，以可組合的技能庫（skills/）形式實作，旨在讓代理在整個開發工作流程中持續呼叫，而非僅作為一次性提示詞使用。

問：我可以貢獻新技能嗎？
答：您可以發起 Pull Request，但維護者指出通常不接受全新技能的貢獻；改進現有技能、文件或代理整合的貢獻較有可能被合併。所需格式請參閱 skills/writing-skills/SKILL.md。

問：它會收集我的資料嗎？
答：它包含僅限於版本採用追蹤的可選用遙測功能，並尊重退出機制的環境變數設定。

問：安裝後如何更新 Superpowers？
答：更新程序遵循您所使用之程式碼代理的一般外掛/擴充更新機制；詳情請參閱儲存庫 README 中的「更新」章節，以獲取針對您代理的具體說明。

11. 快速連結

  • 儲存庫：https://github.com/obra/superpowers
  • 貢獻指南：skills/writing-skills/SKILL.md（位於儲存庫內）
  • 特定代理文件：docs/ 目錄（位於儲存庫內）
  • 社群：儲存庫上的 GitHub Issues 與 Discussions

12. 總結

Superpowers 將臨時性的 AI 輔助程式設計轉化為嚴謹且以證據為基礎的工程流程——涵蓋腦力激盪、規劃、TDD 及程式碼審查——並可安裝於團隊現有的任何程式碼代理中。對於希望其 AI 程式碼代理表現得像謹慎的工程師，而非快速但草率的自動補全工具，同時又不想被鎖定在單一代理廠商的開發人員與團隊而言，這是最具價值的解決方案。