註冊
Claude

Claude Code 安裝 superpowers 插件：兩條官方 README 裏的命令、它會自動觸發哪些技能、怎麼排查

superpowers 是 obra/superpowers 項目提供的一套 Claude Code 技能插件，核心是先問清需求、再出設計和計劃、再按測試驅動開發執行。本文按該項目官方 README 講安裝命令、基本工作流、技能清單、私隱說明和出問題時怎麼查。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-05 · 依據官方文檔與公開資料整理 Pro 帳號
本文根據 GitHub 項目 obra/superpowers 的官方 README，以及 Claude Code 官方文檔《Discover and install prebuilt plugins》整理，資料核對於 2026-11-05。superpowers 是第三方開源項目，不是 Anthropic 官方產品。配圖為本站整理的示意圖，不是介面截圖。本站（bigolab.com）不是 Anthropic 官方網站。

適用於誰

  • 搜「claude code 安裝 superpowers」，想知道正確命令的人；
  • 聽說它能讓 Claude Code 先想清楚再寫代碼，想知道裝了之後會發生什麼的人；
  • 裝了之後感覺行為變了、想排查的人。

結論先說

  1. superpowers 是一個技能插件集合。README 的自我介紹是：為編程智能體準備的一套完整軟件開發方法，由一組可組合的技能和一些初始指令構成，保證智能體會用這些技能。
  2. Claude Code 的安裝命令（README 原樣）：/plugin install superpowers@claude-plugins-official（走 Anthropic 官方插件市場）；或者先 /plugin marketplace add obra/superpowers-marketplace，再 /plugin install superpowers@superpowers-marketplace。
  3. 技能是自動觸發的，README 說你不需要做什麼特別的事。它的流程偏重：先提問、寫設計、寫計劃，再用子智能體逐個任務實現，強調測試驅動開發。
  4. 小任務可能顯得囉嗦，這是它的設計取向，不是故障；不想用時可以卸載或停用插件。
  5. 第三方插件會影響 Claude 的行為，裝之前建議先看一眼內容，見 /guides/agent-skills-security-audit-before-install。

Claude Code 安裝 superpowers 的步驟

圖：本站根據 obra/superpowers 官方 README 整理的示意圖

一、安裝步驟

方式一：Anthropic 官方插件市場（README 列在前面）

在 Claude Code 裏運行：

text
/plugin install superpowers@claude-plugins-official

Claude Code 官方文檔說明：/plugin install 在會話裏不會立刻安裝，而是打開 /plugin 面板並定位到該插件的詳情，讓你先查看並選擇安裝範圍（scope）。官方還說，Claude Code 會在你第一次啟動交互式終端會話時自動添加 Anthropic 的官方市場（claude-plugins-official）。

方式二：superpowers 作者自己的市場

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

README 說這個市場提供 superpowers 和一些相關插件。

讓插件生效：Claude Code 官方文檔說，安裝的插件在下次啟動 Claude Code 時加載，或在已打開的會話裏運行 /reload-plugins。

README 還提醒：安裝方法因工具而異，如果你同時用多個編程智能體（如 Codex、Cursor），要為每一個單獨安裝。更新方式 README 只說「因編程智能體而異，通常是自動的」。插件市場的一般用法見 /guides/claude-code-plugins-marketplace。

二、裝好之後會發生什麼：README 的基本工作流

superpowers 的基本工作流

圖：本站根據 obra/superpowers 官方 README 整理的示意圖

README 描述的流程是：

  1. brainstorming：動手前先通過提問弄清你真正想要什麼；小改動在聊天裏確認，大項目會寫一份設計文檔；
  2. using-git-worktrees：設計通過後，在新分支建隔離工作區、跑項目初始化、確認測試基線乾淨；
  3. writing-plans：拆成 2–5 分鐘的小任務，每個任務有準確的文件路徑、完整代碼和驗證步驟；
  4. subagent-driven-development 或 executing-plans：前者每個任務派一個新的子智能體並在每個任務後複查（最徹底），後者在當前會話裏內聯執行，最後整體複查一次（最省）；
  5. test-driven-development：強制紅-綠-重構（先寫失敗的測試、看它失敗、寫最少的代碼、看它通過、提交）；
  6. requesting-code-review：任務之間按計劃複查，嚴重問題會阻塞進度；
  7. finishing-a-development-branch：任務完成後驗證測試，給出合併、提 PR、保留或丟棄的選項，並清理工作區。

README 強調這些是「強制工作流，不是建議」，智能體會在任何任務前檢查有沒有相關技能。README 沒有給出輕量模式的開關；小改動是否顯得太重，需要你自己判斷（這是本站的提醒，不是 README 的話）。

相關的 Claude Code 概念：子智能體見 /guides/claude-code-subagents，worktree 見 /guides/claude-code-worktree，計劃模式見 /guides/claude-code-plan-mode。

三、技能清單（README）

  • 測試：test-driven-development；
  • 排錯：systematic-debugging（四階段根因流程）、verification-before-completion（確認真的修好了）、diagnosing-superpowers（出問題時分析會話）；
  • 協作：brainstorming、writing-plans、executing-plans、dispatching-parallel-agents、requesting-code-review、receiving-code-review、using-git-worktrees、finishing-a-development-branch、subagent-driven-development；
  • 元技能：writing-skills（按最佳實踐創建新技能）、using-superpowers（介紹技能系統）。

README 的理念四條：測試驅動、系統化而非臨時起意、降低複雜度、證據優先於聲明。

四、行為不對時怎麼辦

README 有一節「When Something Goes Wrong」：如果某個技能不該觸發卻觸發了，或該觸發卻沒觸發，或智能體無視計劃、重複勞動、token 消耗比預期多，可以對智能體說「figure out what went wrong with superpowers in this session」，它會調用 diagnosing-superpowers 技能。技能會讀取會話記錄，用行級證據說明發生了什麼，並可按需打包一份脫敏的材料用於提交問題報告。要分析以前的會話，在句子裏帶上會話 ID。

另外可以用 Claude Code 的 /plugin 面板查看、停用或卸載插件；會話變長時的處理見 /guides/claude-code-context-compact。想知道 token 和額度怎麼消耗，見 /guides/claude-usage-limits；訂閱 Claude Code 可以看 /chongzhi/claude-code。

五、私隱：README 的遙測說明

README 的最後一節寫明：brainstorming 的可選「可視化助手」功能裏，Prime Radiant 的 logo 預設從他們的網站加載，請求裏包含正在使用的 superpowers 版本，不包含項目、提示詞或編程智能體的細節；項目方說這用來粗略了解使用量。可以設環境變量 SUPERPOWERS_DISABLE_TELEMETRY 為真值來關閉，README 還說它也遵循 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC。

常見問題

Q：它是 Anthropic 官方出的嗎？

不是。README 寫明作者是 Jesse Vincent 和 Prime Radiant 的團隊；但 README 稱可以通過 Anthropic 的官方插件市場安裝。

Q：商業使用有限制嗎？

README 的許可證一節寫的是 MIT License，另有商業支持服務的聯絡方式。具體條款以倉庫裏的 LICENSE 文件為準。

Q：裝了之後每次都要走這麼多步，能不能只用一部分技能？

README 沒有介紹只啟用部分技能的方法。Claude Code 的插件面板可以停用整個插件，更細的控制可以參考 /guides/claude-code-skills-directory-location-priority。

相關教學

參考資料

  • GitHub：obra/superpowers README — https://github.com/obra/superpowers
  • Claude Code 官方文檔：Discover and install prebuilt plugins — https://code.claude.com/docs/en/discover-plugins

Nathaniel 的更多內容

  1. 01

    Claude Code 在 Windows 上的常見坑：Git Bash 還是 PowerShell、路徑反斜槓、假報錯、WSL 怎麼選

    Windows 上用 Claude Code，裝好之後最容易踩的是：用哪個 shell、路徑寫法不一致、grep 沒匹配就報錯、鉤子沒生效、WSL 和原生怎麼選。本文逐條按官方文檔整理原因和處理辦法，附三段提示詞和一張對照表。

    Claude0
  2. 02

    Claude Code Hooks 實戰「提交前自動跑測試」：PreToolUse 攔住 git commit，測試不過就退出碼 2，附 Windows 注意點

    只寫一個完整例子：讓 Claude Code 每次要執行 git commit 之前，先自動跑項目測試，沒通過就攔下並把輸出交給它修。本文按官方 Hooks 文檔給出腳本、settings.json 配置、測試方法、排錯和 Windows 的兩處坑。

    Claude0
  3. 03

    Claude Code 自定義斜槓命令與 Skill 實戰：從零寫一個「生成更新日誌」的 /release-notes，含傳參、預執行命令和調試

    概念看過了，還是不知道從哪下手？本文按 Claude Code 官方「Extend Claude with skills」寫一個完整可用的例子：用 /release-notes 根據 git 記錄生成更新日誌，覆蓋目錄、frontmatter、傳參、預執行命令、預授權和調試。

    Claude0
  4. 04

    Claude Code 部署網站：先寫 Dockerfile 和 compose 在本機跑通，再按清單上雲伺服器，別讓它直接改線上

    想讓 Claude Code 幫你把網站部署到雲伺服器。本文只寫通用做法，按 Docker 官方文檔講：讓它寫 Dockerfile、.dockerignore 和 compose，在本機跑通，端口和數據卷怎麼設，再給出上線清單，並說明為什麼不要讓它直接動線上機器。

    Claude0
  5. 05

    Claude Code 寫爬蟲與數據清洗：先查 robots.txt 和網站條款，控制頻率，原始數據留一份再清洗

    想讓 Claude Code 寫爬蟲抓數據再清洗。本文先講合規：robots.txt 不是授權也不是安全措施、網站條款要自己讀；再講怎麼用 Python 標準庫檢查規則、小樣本先試、儲存原始數據，以及用 pandas 清洗，附四段提示詞。

    Claude0
  6. 06

    Claude Code 寫 Chrome 擴展：按 Manifest V3 起步，加載未打包的擴展，改了哪些文件要重新加載

    想讓 Claude Code 幫你寫一個 Chrome 擴展。本文按 Chrome 官方擴展文檔講：manifest.json 的最小寫法、在 chrome://extensions 加載未打包的擴展、哪些改動要刷新、怎麼看控制檯和報錯，再給四段提示詞，以及權限要盡量少。

    Claude0

同產品的其他教學

  1. 01

    Claude Code 寫安卓 App：Android Studio 建項目、讓它用 gradlew 編譯安裝，報錯和日誌怎麼餵給它

    想讓 Claude Code 幫你寫安卓 App。官方文檔沒有專門的安卓教學，本文把 Claude Code 官方工作流和安卓官方命令行文檔拼在一起：Android Studio 建項目、gradlew 編譯安裝、模擬器和真機、測試與日誌，附四段提示詞。

    Claude0
  2. 02

    Claude Code 用數據庫 MCP 查數據、出報表：只讀帳號、先看口徑再看數字，結果別一次拉太多行

    想用自然語言讓 Claude Code 查數據庫、出統計報表，而不是寫後端接口。本文按官方 MCP 頁面和 DBHub 說明講：怎麼連 PostgreSQL、MySQL、SQLite、輸出太大怎麼辦、怎麼讓它先說明口徑、怎麼核對數字，附三段提示詞。

    Claude0
  3. 03

    Claude Code 配 Figma MCP 還原設計稿：插件或一條命令安裝，複製圖層連結，小塊小塊地讓它出代碼

    想讓 Claude Code 照 Figma 設計稿寫前端代碼。本文按 Figma 官方開發者文檔講：遠程伺服器地址、插件和手動兩種安裝、怎麼複製圖層連結、為什麼要選小塊、座位類型與調用次數限制，並給三段還原設計稿的提示詞。

    Claude0
  4. 04

    Claude Code 管理 GitHub issue：用 gh 命令還是 GitHub MCP，怎麼裝、怎麼限權、怎麼讓它分揀和回覆 issue

    讓 Claude Code 讀 issue、分揀標籤、起草回覆、關聯 PR，有兩條路：裝好 gh 命令行直接用，或連 GitHub 官方 MCP 伺服器。本文按兩邊官方文檔講安裝命令、令牌權限、只讀模式，並給出三段分揀提示詞和限權設定。

    Claude0
  5. 05

    Claude Code 配 Playwright MCP 做瀏覽器測試：一條命令安裝，讓它打開頁面、點按鈕、讀控制檯，再把流程寫成測試

    想讓 Claude Code 自己打開瀏覽器測試你的網頁。本文按微軟 Playwright MCP 官方倉庫和 Claude Code 官方 MCP 文檔講：安裝命令、怎麼確認連上、有頭無頭與隔離參數、一次測試的提示詞，以及它不是安全邊界這件事。

    Claude0
  6. 06

    Claude Code 寫文檔、README 和代碼註釋：先讓它讀代碼再動筆，指定風格，寫完逐條核對命令能不能跑

    想讓 Claude Code 給項目補 README、接口文檔和註釋，又怕它編造不存在的命令和參數。本文按官方「Handle documentation」工作流講：先找沒有文檔的代碼、指定風格、寫完核對，附四段可複製提示詞和驗證辦法。

    Claude0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～