obra/superpowers

An agentic skills framework & software development methodology that works.

這是什麼

Superpowers 是一套給 coding agent 使用的軟體開發方法論，不是單一提示詞或小工具。README 的核心說法是：它把一組可組合的 skills，加上一段會在 session 開始時啟動的初始指令，裝到不同 agent harness 裡，讓代理在看到你要「做東西」時，不是立刻衝去寫 code，而是先釐清需求、整理規格，再把設計拆成可審閱的小段。等設計通過後，它會產出足夠明確的實作計畫，並強調 RED/GREEN TDD、YAGNI、DRY，以及後續的 subagent-driven-development。換句話說，這個專案想解決的是「AI 會寫 code，但常常缺流程、缺驗證、缺邊界」的問題。

為什麼上榜

這次日榜選到 obra/superpowers，metadata 顯示它已有 284,691 stars，本期新增 732 stars，熱度很高。它吸引人的地方在於切入點相當務實：不是再宣稱某個模型更聰明，而是把 agent 寫程式時常見的失控點，包成一套「會自動觸發的工作流」。README 也列出它支援 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Hermes Agent 等多種環境，這讓它看起來像是跨 agent 的流程層。爭點也在這裡：它要求 agent 遵守 mandatory workflows，等於把速度換成規格、測試與審查；對追求快速試作的人可能偏重，但對怕 AI 改壞專案的人，這正是亮點。

適合誰，可以拿來做什麼

Superpowers 適合已經在用 coding agent，但覺得成果品質不穩的人：例如想把粗略想法變成規格、希望 agent 先寫計畫再動手、或需要多個 subagent 分工完成任務的開發者。README 的基本流程涵蓋 brainstorming、git worktrees、writing-plans、subagent-driven-development、test-driven-development、code review、finishing branch，因此它比較像一套「AI 結對工程師的操作規範」。如果你的工作是維護既有 repo、重視測試基準、希望每個改動都能追溯到計畫與驗證，它會比單純貼 prompt 更有結構。相反地，如果只是一次性問答或小片段修改，完整流程可能顯得太正式。

上手

README 說明安裝方式依 harness 而異；如果你同時使用多個 agent，需要分別安裝。以下是 README 明確列出的幾個入口：

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

# Codex CLI：先開啟插件搜尋介面，再搜尋 Superpowers
/plugins

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

# Hermes Agent
hermes plugins install obra/superpowers --enable

安裝後也要注意 README 對 Hermes Agent 的提醒：需要重啟 active sessions；而且 Hermes 沒有 post-compaction hook，超長 session 若壓縮掉第一輪 bootstrap，可能要開新 session 才能恢復 skills 觸發。

README 重點摘要

• Superpowers 的定位是 coding agent 的完整開發方法論，以 skills library 和初始指令組成，而不是單一工具。
• 基本流程從 brainstorming 到 finishing branch，強調先規格、再計畫、再實作與審查。
• Skills library 包含測試、除錯、協作與 meta 類技能，例如 test-driven-development、systematic-debugging、requesting-code-review、writing-skills。
• README 明確主張 Evidence over claims：完成前要驗證，而不是只相信 agent 的宣稱。
• 授權為 MIT；另有可選的 visual companion telemetry，README 說明可用環境變數停用。