# Superpowers

Canonical: https://cqbase.net/zh/entry/superpowers
Chinese: https://cqbase.net/zh/entry/superpowers
English: https://cqbase.net/en/entry/superpowers

> Jesse Vincent 的技能框架，让编码代理先计划、先写测试，再改代码。

Superpowers 是 obra（Jesse Vincent）维护的一套代理技能和开发方法。它把常见的软件工作拆开：先把设计说清楚，写计划，先写测试，再让代理实现，最后做复查。仓库用 MIT 许可发布。

适合已经在用 Claude Code、Cursor 或 Codex、但不希望代理一上来就改文件的人。按仓库里的安装说明启用，然后拿一个很小的任务看它会不会先停下来做计划。

注意（核验日期 2026-11-15）：仓库未归档，最新发版为 v7.0.2（2026-11-04 06:17 Asia/Shanghai）。Claude Code 的当前安装方式是官方插件市场命令 `/plugin install superpowers@claude-plugins-official`（https://claude.com/plugins/superpowers），这个项目并没有被官方技能机制取代。已知它与 Claude Code 的工具变化存在冲突，例如 issue [#2177](https://github.com/obra/superpowers/issues/2177)、[#2699](https://github.com/obra/superpowers/issues/2699)、[#2701](https://github.com/obra/superpowers/issues/2701)。2026-11-08 仍有帖文使用旧命令 `npx skills add obra/superpowers`。

## 解决什么问题

[obra/superpowers](https://github.com/obra/superpowers) 是 Jesse Vincent（obra）维护的一套代理技能和开发方法。它希望编码代理在动手改文件之前，先把需求和设计问清楚，写出可执行的计划，再按测试驱动的方式实现，并在任务之间做复查。仓库用 MIT 许可发布，并未归档。

核验日期为 2026-11-16（Asia/Shanghai）。GitHub Releases 的最新正式版是 [v7.0.2](https://github.com/obra/superpowers/releases/tag/v7.0.2)，发布时间是 2026-11-03 22:17 UTC，换算为 2026-11-04 06:17（Asia/Shanghai）。仓库最近一次推送是 2026-11-04 07:24（Asia/Shanghai）。本站已把它移出首页要目并加了警告提示，原因是安装方式已经变化，并且它与部分编码工具存在已知摩擦，而不是项目停止维护。它也没有被 Anthropic 的官方 Agent Skills 机制取代：Claude Code 仍可通过官方插件市场安装。

## 适合谁

适合已经在使用 Claude Code、Cursor、Codex 或其他 README 列出的编码工具，又不希望代理一上来就改代码的人。官方流程强调先讨论设计、再写计划、再实现，因此不适合「只想立刻改一个文件」的短任务。

README 为多种工具分别写了安装方式，并提醒：若你同时使用不止一种工具，需要分别安装。本指南重点写 Claude Code、Cursor 和 Codex CLI 的官方命令；其他工具请直接看仓库 README，不要把某一家的命令套到另一家。

## 怎么装

命令来自 2026-11-16 查阅的仓库 [README](https://github.com/obra/superpowers/blob/main/README.md)。不要再使用仍在流传的旧命令 `npx skills add obra/superpowers`。

**Claude Code**

官方推荐路径是 Anthropic 的[官方插件市场](https://claude.com/plugins/superpowers)：

```text
/plugin install superpowers@claude-plugins-official
```

也可以先登记 Superpowers 自己的市场，再安装：

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

**Cursor**

在 Cursor 的 Agent 对话里执行：

```text
/add-plugin superpowers
```

也可以在插件市场里搜索 “superpowers”。

**Codex CLI**

官方说明走 [OpenAI 的插件市场](https://github.com/openai/plugins)。先打开插件搜索界面：

```text
/plugins
```

再搜索 `superpowers`，选择 `Install Plugin`。Codex 应用则是在侧栏 Plugins 的 Coding 分类里添加 Superpowers。

装好后，用一个很小、可丢弃的任务看它会不会先停下来讨论设计，而不是立刻写文件。更新方式因工具而异，README 只概括说「常常是自动的」，没有给出适用于所有工具的统一升级命令。

## 一个实际例子

官方在 Muse 安装说明里，把「新开一轮对话，发送 `Let's make a react todo list`」当作安装是否生效的检查：正常情况下应先触发 brainstorming，而不是直接写代码。本次没有在本机实跑，因此不编造它会问哪些问题，也不编造生成的设计文档。

1. 按你实际使用的工具，用上一节的官方命令安装，不要混用旧的 `npx` 命令。
2. 新开一轮对话，在一个空的练习目录里发送上述提示，或改成你自己的、范围同样小的练习任务。
3. 预期效果（来自官方说明，不是实测）：代理应先把设计说清楚并征求确认，而不是马上创建项目文件。
4. 若它直接开始改文件，先不要继续扩大任务。可按 README 的建议，让它「figure out what went wrong with superpowers in this session」，并自己审查后续 diff。

## 常见坑

- 仍按旧教程执行 `npx skills add obra/superpowers`。2026-11-16 的 README 对 Claude Code 给出的是 `/plugin install` 命令。
- 把「已进入官方市场」理解成「和当前 Claude Code 完全没有摩擦」。[issue #2177](https://github.com/obra/superpowers/issues/2177) 在 2026-11-16 仍为开放（open），最近更新时间是 2026-10-22 20:00 UTC，即 2026-10-23 04:00（Asia/Shanghai）。它报告：从 Claude Code 2.1.233 起，部分当前模型不再默认提供 `TodoWrite` / `Task*` 工具，而当时的 Superpowers 技能仍要求使用这些工具；报告环境是 Superpowers 6.3.0 与 Claude Code 2.1.235。issue 中的权宜做法是在 `~/.claude/settings.json` 的 `env` 里设置 `CLAUDE_CODE_ENABLE_TODO_TOOLS` 为 `"1"`。此后已发布 v7.0.2，本次没有复测该问题在 7.0.2 上是否仍然存在，不能把它写成已经修复或一定仍会复现。
- [issue #2699](https://github.com/obra/superpowers/issues/2699) 在 2026-11-16 仍为开放，创建于 2026-11-14 19:58（Asia/Shanghai）。它针对 v7.0.2，认为 `using-superpowers` 里偏强硬的措辞会让当前 Claude 模型过度触发技能。这是用户报告，不是官方已确认的结论。
- 若你使用 OpenCode：[issue #2701](https://github.com/obra/superpowers/issues/2701) 在 2026-11-16 仍为开放，创建于 2026-11-14 20:46（Asia/Shanghai）。它认为插件在 OpenCode v2 的工具映射里错误宣称「没有 todo 工具」，与 `experimental.todo` 开启后实际存在的 `todowrite` 不符。本次没有在 OpenCode 上复现。
- 可选的可视化配套功能默认会从维护方网站加载 Logo，并带上 Superpowers 版本号。官方说明这不包含项目、提示词或所用工具的细节，并可用环境变量 `SUPERPOWERS_DISABLE_TELEMETRY` 关闭；同时尊重 Claude Code 的 `DISABLE_TELEMETRY` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`。

## FAQ

### Superpowers 是不是已经被官方 Agent Skills 取代了？

没有。2026-11-16 查阅的仓库 README 仍把 Claude Code 的安装路径指向官方插件市场命令 `/plugin install superpowers@claude-plugins-official`，并链接 [claude.com/plugins/superpowers](https://claude.com/plugins/superpowers)。本站把它移出要目，是因为安装说明容易过时、以及存在上述开放 issue，不是因为它已被官方机制替代。

### Claude Code 现在应该用哪条安装命令？

以仓库当前 README 为准：`/plugin install superpowers@claude-plugins-official`。不要把旧的 `npx skills add obra/superpowers` 当成当前官方命令。

### 最新版本是哪一个？

GitHub Releases 在 2026-11-16 显示的最新正式版是 v7.0.2，发布于 2026-11-04 06:17（Asia/Shanghai）。若你本地看到的版本不同，先对照该 Releases 页面，而不是只看第三方教程。

### 为什么代理说找不到 TodoWrite 或 Task 工具？

[issue #2177](https://github.com/obra/superpowers/issues/2177)（仍开放）描述过这类情况，并给出了环境变量权宜做法。该 issue 针对的是 6.3.0 和当时的 Claude Code 版本。v7.0.2 发布之后，本次没有复测，因此不能保证同一设置仍然必要，或问题已经消失。请先看该 issue 的当前讨论和官方 README。

### 许可证是什么？可以商用吗？

仓库声明为 MIT License，详见 [LICENSE](https://github.com/obra/superpowers/blob/main/LICENSE)。商用或再分发前请自行阅读许可全文。README 另外提到企业支持可联系 sales@primeradiant.com，这与开源许可是分开的，本文不讨论商务条款。

## 来源与许可

仓库 [obra/superpowers](https://github.com/obra/superpowers) 使用 MIT 许可。本文依据 2026-11-16 查阅的 README、[v7.0.2 发版说明](https://github.com/obra/superpowers/releases/tag/v7.0.2)、官方插件页，以及当时仍为开放的 issue [#2177](https://github.com/obra/superpowers/issues/2177)、[#2699](https://github.com/obra/superpowers/issues/2699)、[#2701](https://github.com/obra/superpowers/issues/2701)，用自己的话写成，供 CQBase 上下文库使用。若安装命令或已知问题有变，以仓库和官方插件页为准。

## 收录信息

- 作者: obra
- 许可证: MIT
- 来源: https://github.com/obra/superpowers
- 收录: 2026-11-15
- GitHub 星标: 317797（采集 2026-11-15）

