AI自動化 2026-05-26

Obra Superpowers Claude Code 完整教學：2026 工作流指南

ZecCloud 技術團隊 · 2026年5月26日 · ~8 分鐘
Obra Superpowers Claude Code 外掛工作流與雲端 Mac 開發指南 2026

Superpowers（作者 Jesse Vincent / @obra）是 GitHub 上星標最多的 Claude Code 外掛生態——截至 2026 年已有 17 萬+ stars。與只增加單一技能或 MCP 的外掛不同，Superpowers 安裝的是完整軟體開發方法論：先腦力激盪再寫程式、把計畫拆成小任務、強制測試驅動開發（TDD）、合併前審查。

Anthropic 在 2026 年初將 Superpowers 納入官方 Claude 外掛市場。若你已讀過我們的最佳 Claude Code 外掛排行，Superpowers 是那些「點工具」之上的工作流層——本篇涵蓋安裝、指令與適用場景。

Superpowers 到底是什麼

Superpowers 不是模型升級，而是可組合技能 + 鉤子的外掛套件，按階段引導 Claude Code：

階段技能行為
設計蘇格拉底式腦力激盪——改檔案前先提問
計畫writing-plans 將工作拆成 2–5 分鐘任務並標明路徑
隔離using-git-worktrees 建立分支 worktree，保持乾淨基線
建置子代理或批次執行，強制 TDD（紅 → 綠 → 重構）
審查requesting-code-review 在任務間審查；嚴重問題阻斷進度
交付finishing-a-development-branch — 合併、PR 或捨棄並驗證
可引用定義：Superpowers 把 Claude Code 從「快速程式碼產生器」變成「在設計與測試明確之前拒絕動手實作的嚴謹隊友」。

來源：obra/superpowers 與 Superpowers 文件。

在 Claude Code 上安裝 Superpowers（兩條路徑）

路徑 A — Anthropic 官方市場（推薦）

/plugin install superpowers@claude-plugins-official

若已啟用 claude-plugins-official（近期 Claude Code 預設開啟），这是阻力最小的安裝方式。參見 Claude Code 探索外掛。

路徑 B — Obra Superpowers 市場（最新發布）

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

當 Obra 市場版本早於 Anthropic 目錄時選路徑 B。隨時更新：

/plugin update superpowers

/reload-plugins

驗證安裝

在新 Claude Code 工作階段中確認斜線指令存在：

  • /superpowers:brainstorm — 互動式設計細化
  • /superpowers:write-plan — 根據已核准設計產生實作計畫
  • /superpowers:execute-plan — 帶檢查點的批次執行

若指令缺失，重新新增市場並檢查 /plugin list。

Superpowers 工作流逐步說明

1. 腦力激盪（不要跳過）

從 /superpowers:brainstorm 開始，或用自然語言描述功能。Superpowers 阻止過早寫程式——Claude 會先釐清問題並產出待核准的設計檔案。

原因：多數代理失敗是規格失敗，而非模型失敗。

2. 编写計畫

設計核准後，writing-plans 輸出包含精確檔案路徑、每步驗證方式、2–5 分鐘粒度估算的任務清單。

3. Git worktree 隔離

using-git-worktrees 建立隔離分支/工作區，執行專案初始化，並在編輯前確認測試基線乾淨。

4. 強制 TDD 執行

實作階段，test-driven-development 技能要求：寫失敗測試 → 觀察失敗 → 寫最少程式碼 → 觀察通過 → 重構並提交。技能內含「鐵律」與常見代理捷徑的紅旗表。

5. 程式碼審查關卡

requesting-code-review 在任務之間執行。嚴重問題會阻斷下一任務直至修復。

6. 完成分支

finishing-a-development-branch 驗證測試後，提供合併 / PR / 保留 / 捨棄選項。

Superpowers vs 原版 Claude Code

维度原版 Claude Code啟用 Superpowers
聽到「做 X」后常直接改檔案先腦力激盪
測試除非明確要求強制 TDD 循環
計畫臨時發揮結構化計畫與檢查點
並行手動子代理批次驅動
紀律取決於提示詞技能 + 鉤子強制執行
最適合快速腳本、一次性修復功能、重構、團隊工作流

何時可跳過 Superpowers：一次性原型、純 Markdown 編輯，或預計 <15 分鐘、流程成本高於省下的 bug 的任務。

在雲端 Mac mini M4 上使用 Superpowers

iOS 與全端團隊常在專用 Mac mini M4（本機或ZecCloud 雲端租賃）上執行 Claude Code，以便 Xcode、sourcekit-lsp 與長測試套件留在 Apple Silicon 上。

建議步驟：

  1. SSH 登入 Mac — 見Mac mini M4 SSH 教學
  2. 在該主機安裝 Claude Code CLI
  3. 通過路徑 A 或 B 安裝 Superpowers
  4. 在專案目錄執行 /superpowers:brainstorm

外掛在執行 Claude Code 的機器上執行——不在你的筆電上。16 GB 記憶體的雲端 Mac 可舒適執行 Superpowers + swift-lsp 處理中等規模 iOS 儲存庫。

揭露說明：ZecCloud 提供本篇提及的雲端 Mac mini 租賃。Superpowers 為 Obra 獨立開源專案；ZecCloud 不維護此外掛。

Superpowers vs 其他外掛套件

套件重點與 Superpowers 關係
Superpowers (Obra)端到端 SDLC 紀律—
官方 feature-dev功能鷹架互補 — 更輕量
官方 pr-review-toolkitPR 審查互補 — Superpowers 分支之後使用
第三方代理市集大量單點代理目錄更廣，TDD 約束較弱

可同時執行 Superpowers + github + swift-lsp——Superpowers 管流程，GitHub 與 LSP 管資料與符號。

故障排除

問題處理
找不到指令/plugin marketplace add obra/superpowers-marketplace 后重新安裝
技能未啟用/reload-plugins；開新工作階段
代理仍直接寫程式先明確執行 /superpowers:brainstorm
大儲存庫變慢用 git worktree；在計畫中縮小任務範圍
與其他外掛衝突停用重疊工作流外掛；保留 LSP + MCP

常見問題

Obra Superpowers 免費嗎？+
是的——外掛為 MIT 開源。你只需為 Claude Code / API 付費，Superpowers 本身不收費。
obra 和 Superpowers 有什麼區別？+
Obra 是 Jesse Vincent 的 GitHub 組織；Superpowers 是外掛儲存庫 obra/superpowers。「Obra Superpowers」是社群常用簡稱。
官方市場還是 Obra 市場？+
兩者均可。用 @claude-plugins-official 最簡單；用 @superpowers-marketplace 可更快獲得 Obra 發布節奏。
Superpowers 能在 Cursor 或 Codex 上用嗎？+
Superpowers 面向多種 harness，但Claude Code 有原生外掛路徑（本文所述）。其他工具可能需要手動複製技能——見儲存庫 README。
能與現有 Claude Code 外掛一起用嗎？+
可以。保留 GitHub、語言伺服器（如 swift-lsp）與 commit-commands；Superpowers 在之上增加工作流技能。

結論

Obra Superpowers 是 2026 年 Claude Code 的紀律層：14+ 技能強制「腦力激盪 → 計畫 → TDD → 審查」再交付。從官方市場一條指令安裝，驗證 /superpowers:brainstorm，在本地 Mac 或雲端 Mac mini上跑嚴肅功能開發。

在雲端 Mac mini 上執行 Superpowers

ZecCloud 提供獨享 Apple Silicon 節點，香港/東京/首爾/新加坡/美東可選，約 ¥730/月起，5 分鐘 SSH 交付。