Superpowers 是什么：给编程 Agent 装一套开发流程

Superpowers 是 Jesse Vincent 和 Prime Radiant 团队维护的开源 Agent Skill 合集。它覆盖编程 Agent 从「听懂需求」到「合并分支」的整条流程：先问清楚、写设计、拆计划，再用子 Agent 按测试先行一步步实现。截至 2026-10-31（北京时间），最新版是 v7.0.1，许可证 MIT，GitHub 约 31 万星。

它是什么

README 开头把 Superpowers 定义为「给编程 Agent 的一整套软件开发方法」：由一组可组合的 Skill 加一段启动指令组成，启动指令保证 Agent 真的会去用这些 Skill。每个 Skill 是一个 SKILL.md，描述里写明什么时候必须调用，比如 brainstorming 写的是「在任何创造性工作之前必须使用」，test-driven-development 写的是「实现任何功能或修 bug 时，在写实现代码之前使用」。

解决什么问题

编程 Agent 最常见的毛病是太急：需求还没说完就开写，写完不跑测试就说「已修复」，改着改着偏离了原来的计划。Superpowers 把这些坏习惯逐个对上一条强制流程。README 里的基本工作流是七步：

另外还有 systematic-debugging（四阶段找根因）、verification-before-completion（没跑验证命令就不许说完成）、dispatching-parallel-agents、receiving-code-review、writing-skills，以及 v6.4.1 加入的 diagnosing-superpowers：会话出问题时，它读会话记录，带行号说明哪个 Skill 该触发没触发。

verification-before-completion 的铁律只有一句：没有新鲜的验证证据，就不能声称完成。

怎么用

按宿主选安装方式，以下命令都来自官方 README：

# Claude Code：官方插件市场
/plugin install superpowers@claude-plugins-official

# Cursor：Agent 对话框里
/add-plugin superpowers

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# GitHub Copilot CLI
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

# Qwen Code
qwen extensions install obra/superpowers

Codex 应用和 Codex CLI 走官方插件市场（CLI 里 /plugins 搜 superpowers）；OpenCode 是让它读取仓库里 .opencode/INSTALL.md 照做。装完不需要记命令，正常提需求就行。想确认装好了，新开会话说「Let's make a react todo list」，Agent 应该先开始问问题，而不是直接建项目。

如果某次会话里 Skill 该触发没触发，或者 Agent 不按计划走、token 烧得比预期多，直接对它说「figure out what went wrong with superpowers in this session」，会调用 diagnosing-superpowers 出诊断报告。

v7.0.1 改了什么

v7.0.0 把 brainstorming 从头重写，用户反馈开场问题太模板化、问多了烦。v7.0.1 的调整：在已有项目里先读代码和文档，再提问，不问材料里已有答案的事；你已经说清要什么时，它复述需求加上它在项目里看到的东西，只问还没定的那一点。设计文档这一步也收紧了：官方测试场景里，改之前 24 次运行有 24 次跳过设计文档直接开写，改之后是 3 次。

另一处改动针对 Claude Code：压缩上下文后，每个 Skill 只会重新挂载前 20,000 个字符。有用户报告 subagent-driven-development 的「最多五轮修复」规则因此被截掉，单个任务跑了 18 轮。v7.0.1 把这个 Skill 和 writing-skills 的大段内容挪到 references/，用到时再从磁盘读，并加了测试：任何 SKILL.md 达到 20,000 字节就报错。

关于遥测：brainstorming 的可选可视化伴侣页面会从官网加载 Prime Radiant 的 logo，请求里带 Superpowers 版本号，README 写明不含项目、提示词或 Agent 信息。关掉方法是设环境变量 SUPERPOWERS_DISABLE_TELEMETRY，它也认 Claude Code 的 DISABLE_TELEMETRY。

适合谁，不适合谁

适合：让 Agent 做多文件、要跑一两个小时的功能开发的人；团队想统一「先设计、再计划、测试先行、评审后合并」流程的人；经常被 Agent 一句「已修复」骗到的人。和本站写过的 grill-me 相比，grill-me 只管「把需求拷问清楚」这一段，Superpowers 管到合并分支。worktree 那一步可配合 编程 Agent 的 worktree 清理习惯一起看。

不适合：只想让 Agent 改一行配置、出个脚本的人。brainstorming 遇到「把图标改成矢车菊蓝」这种需求会直接做，但只要它判断有关键信息缺失，就会先开一轮对话，对赶时间的小改动是额外开销。全套流程、子 Agent 和每步评审也会多花 token，预算紧的可以选 executing-plans 的串行模式。

最后

在你常用的宿主里装上 Superpowers，新开会话说一句「Let's make a react todo list」，看它是不是先问你需求、给方案、写设计文档，再决定要不要拿到真项目里用。