注册
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 条评论

登录 后参与评论

还没有评论，来抢沙发～