obra/superpowers

Superpowers 是一套給 coding agent 用的軟體開發方法論,由一組可組合的 skills 加上開場指令組成,讓 agent 在對話一開始就自動套用。它把流程固定成先問清需求、寫設計、拆計畫、再進 TDD 實作與程式碼審查,而不是一看到需求就直接寫程式。與單純的規則檔不同,這些 skills 會依情境自動觸發,並支援 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等多個 harness。
AI 寫程式與 SkillsShell★ 307,147

專案簡介

以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。

原始描述

An agentic skills framework & software development methodology that works.

AI 規格

可搭配的工具Claude CodeAntigravityCodex AppCodex CLICursorDevin CLIFactory DroidGemini CLI

主要功能

  • brainstorming skill 在動手前先問清需求,並把理解回放給你確認
  • writing-plans 把工作拆成 2 至 5 分鐘、含檔案路徑與驗證步驟的小任務
  • subagent-driven-development 每個任務派一個新 subagent,做完就審查
  • test-driven-development 強制 RED-GREEN-REFACTOR,先寫失敗測試再寫程式
  • using-git-worktrees 在新分支建立隔離工作區並確認測試基準乾淨
  • diagnosing-superpowers 讀 session transcript 找出 skill 行為異常的原因

安裝方式

  1. Claude Code:從 Anthropic 官方市集安裝外掛

    /plugin install superpowers@claude-plugins-official
  2. Claude Code:註冊 Superpowers 市集

    /plugin marketplace add obra/superpowers-marketplace
  3. Claude Code:從 Superpowers 市集安裝外掛

    /plugin install superpowers@superpowers-marketplace
  4. Antigravity:從本倉庫安裝外掛

    agy plugin install https://github.com/obra/superpowers
  5. Codex CLI:開啟外掛搜尋介面,搜尋 superpowers 後選 Install Plugin

    /plugins
  6. Cursor:在 Agent chat 中從市集安裝

    /add-plugin superpowers
  7. Devin CLI:從本倉庫安裝外掛

    devin plugins install obra/superpowers
  8. Factory Droid:註冊市集

    droid plugin marketplace add https://github.com/obra/superpowers

設定教學

安裝依 harness 而異,每個 harness 要分別安裝一次。多數是透過各自的 plugin 或 extension 指令從市集或本倉庫安裝,不需要手動填設定檔或 API 金鑰。

主要設定檔

部署方式

Claude Code(官方市集)

  1. 從 Anthropic 官方市集安裝外掛

    /plugin install superpowers@claude-plugins-official

Claude Code(Superpowers 市集)

  1. 註冊 Superpowers 市集

    /plugin marketplace add obra/superpowers-marketplace
  2. 從該市集安裝外掛

    /plugin install superpowers@superpowers-marketplace

Gemini CLI

  1. 以 extension 形式安裝

    gemini extensions install https://github.com/obra/superpowers

設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。

適合用途

  • 想讓 coding agent 先談清楚需求再動手的開發者
  • 在 Claude Code 或 Cursor 上想強制跑 TDD 流程的團隊
  • 需要把工作拆成可審查小任務、交給 subagent 執行的專案
  • 要排查某個 session 裡 agent 行為異常的維護者

常見問題

同時用 Claude Code 和 Cursor,需要各裝一次嗎

可以。同一個 agent 裝了多個 harness 時,README 要求每個 harness 各自安裝 Superpowers,不會共用同一份安裝。

之後要怎麼更新

用 harness 對應的更新指令,例如 gemini extensions update superpowers、devin plugins update superpowers、qwen extensions update superpowers、muse plugins update superpowers。Antigravity 則是用原本的安裝指令重裝一次。

怎麼確認 skills 有沒有正常觸發

skills 是自動觸發的,不用下特殊指令。README 建議開一個新 session 送出 Let's make a react todo list,若安裝正常,brainstorming 會在寫任何程式碼之前先被觸發。

某個 session 的 skill 行為不對,要怎麼查

請 agent 執行 diagnosing-superpowers skill,它會讀取 session transcript、附上逐行證據說明發生什麼事,也能打包一份去識別化的 bundle 供回報問題。要檢查先前的 session 就指定 session id。

Hermes 用久了 skills 突然不觸發怎麼辦

Hermes 沒有 post-compaction hook,session 壓縮過第一輪之後 bootstrap 會消失,skills 可能就不再觸發,這時開新 session 即可。安裝後也要重啟既有的 Hermes session。

公開標籤

aibrainstormingcodingobrasdlcskillssubagent-driven-developmentsuperpowers
Stars 等欄位只是 GitHub 快照,不保證品質、安全性或商用適用性。