安裝指南

這是什麼

Superpowers 是一套給 coding agent 的「完整軟體開發方法論」——建構在一組可組合的技能之上，加上確保 agent 會使用它們的開場指令。它是 obra/superpowers（MIT License）的繁體中文翻譯學習站。本 repo 只改說明文字，指令、路徑、技能名全部照原樣，所以安裝方式跟上游完全一樣。

Superpowers 官方建議：如果你用多個 harness，請分別為每個安裝。

OpenCode（本機開發主平台）

在 opencode.json（全域或專案層級）的 plugin 陣列加入：

{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}

重開 OpenCode。外掛透過 plugin manager 安裝並註冊所有技能。驗證：問「Tell me about your superpowers」。想釘版本就改用分支或 tag：

{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v5.0.3"]
}

詳見 docs/README.opencode.md（OpenCode 版完整指南，含 troubleshooting）。

Claude Code

官方 marketplace 安裝：

/plugin install superpowers@claude-plugins-official

或註冊 Superpowers marketplace 再裝：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Codex App / Codex CLI

Codex App：側欄 Plugins → Coding 區塊找到 Superpowers → 按 + 安裝。

Codex CLI：

/plugins

搜尋 superpowers → 選擇 Install Plugin。

Cursor

在 Cursor Agent chat 安裝：

/add-plugin superpowers

或在 plugin marketplace 搜尋「superpowers」。

Gemini CLI

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

更新：gemini extensions update superpowers

GitHub Copilot CLI

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Kimi Code

/plugins

Marketplace → Superpowers 安裝；或直接從 repo 安裝：

/plugins install https://github.com/obra/superpowers

Antigravity

agy plugin install https://github.com/obra/superpowers

Factory Droid

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

Pi

pi install git:github.com/obra/superpowers

開始使用

1. 裝好後，下一個 session 開場就注入 Superpowers 的開場指令。
2. 直接說「我們來做 X」——它會先觸發 brainstorming，把點子敲成設計。
3. 本網站就是這套技能的閱讀版：全景圖看工作流，學習路線照順序學，每個技能頁都是中英逐段對照。

注意

• 這是翻譯學習站；想用英文原版，直接安裝上游：superpowers@git+https://github.com/obra/superpowers.git。
• 不要兩套都裝——每個技能會出現兩次。選擇其一。
• 翻譯只動說明文字，若遇問題請先比對上游行為。