superpowers:让 AI 编程助手先想清楚,再动手写代码

obra/superpowers

📦 3 Parts + Conclusion

👉 滑动

不是让 AI 更聪明，是让它守规矩

用 AI 写代码，最让人头疼的往往不是慢，而是它太急。

一句话丢过去，它立刻噼里啪啦生成几百行。你一看，技术栈不是你要的，目录结构跟现有项目对不上，测试一行没有。改起来比重写还费劲。

问题不在模型聪不聪明。人类工程师接活时会 先问清楚要做什么，AI 大多把这一步跳过去了。

superpowers 就是冲这件事来的。它是 Jesse Vincent 和 Prime Radiant 团队做的 AI 编程助手技能框架，MIT 协议开源，当前版本 v6.3.0，2026 年 8 月 12 日发布。装上之后，Claude Code、Codex、Cursor 这类助手会先跟你把需求聊成设计文档，再拆成小任务一步步做。

它本身不是软件。仓库里没有运行时、没有二进制，主体是一堆 Markdown——一个技能就是一个 SKILL.md 文件，加一段会话启动时注入的提示，让助手干活前记得去查技能。

体量已经不小：GitHub star 约 28.7 万，官方插件市场显示安装量超过 100 万次（2026 年 9 月 16 日查询）。

— Superpowers 官方项目图标（来源：仓库 assets/app-icon.png）

官方 README 说得很直接：助手一旦看出你在「做点什么」，不会立刻写代码，而是 退一步，先问清楚你真正想要什么。

官方列出的七步工作流

有一条规则格外狠：写在测试之前的代码会被删掉。

14 个技能，14 个助手

技能库现在有 14 个，分测试、调试、协作、元技能四类。支持的工具同样有 14 个，README 给每个工具都写了单独步骤：

技能长什么样

技能不是代码，是可以直接读的规则文件。以 brainstorming 为例，它先把请求分成 三条路径：可行性试探、改动已有代码、新项目或新子系统。三条路都得先拿到你的同意才能开工，区别只是文档长短。

它还列了一张 借口对照表，把 AI 常见的自我说服逐条配上反驳，比如「这个太简单了不需要设计」对应的是「简单意味着设计可以短，不是可以没有」。

作者在 2025 年 10 月 9 日的发布博客里附了一份完整会话记录，开头只有一句话：

助手没有动手写代码。它先读技能文件，然后提问：命令行还是网页版、功能要多全、用哪种技术方案、数据存不存、文件放哪里。

问完才开始设计：生成设计逐段确认，建一个 git worktree 在独立分支上开工，写出拆成 6 个任务的计划。接着每个任务先写失败测试看它变红，再写实现看它变绿，最后提交。

每个任务结束，主助手还会派一个 reviewer 子代理审查，通过了才进下一个。

计划文档长什么样

writing-plans 规定每份计划都要从固定表头开始：

每个任务再按固定结构展开：改哪些文件、跟相邻任务怎么对接，然后是一组勾选框步骤——写失败测试、运行确认失败、写最小实现、运行确认通过、提交。官方要求细到「一个热情但没经验、还不爱写测试的人也能照着做完」。

Claude Code 用户最省事，官方给的是一条命令：

想从项目自己的市场装，就两步：

装完不需要任何配置。其他助手的命令不一样，Cursor 里是 /add-plugin superpowers，OpenCode 是让助手去读一份安装说明文件再照做。同时用几个助手的话，每个都要单独装一次。

免费。MIT 协议开源，技能、工作流和各家助手的集成全都不要钱。要花钱的是背后那个 AI 模型——装不装它，调用助手的费用都照付。

README 里另有一节 Commercial Services：企业用户想要商业支持、额外工具或统一管理花销，可以发邮件去问。这是可选项，不影响免费用开源版。

限制方面，官方资料提到几条：

还有一点：这套东西的「强制」靠助手读懂规则再遵守，不是运行时的硬约束——它提高的是遵守概率，不是让违规不可能。当成一份讲规矩的说明书，比当成能锁住它的控制器更准确。

如果你已经在用 Claude Code、Cursor、Codex 这类助手，做的是要长期维护的项目，值得试。它的价值不在帮你写得更快，而在 把先设计、再计划、再写测试变成默认动作。一个人做项目、没人帮你 review 的时候，补的正是这个缺口。

如果只是偶尔让 AI 写个一次性脚本，这套流程的开销可能大于收益，装不装都行。

官方入口：「GitHub 仓库 github.com/obra/superpowers」「插件市场页面 claude.com/plugins/superpowers」「作者发布说明 blog.fsck.com 2025 年 10 月 9 日那篇」。

真用起来，记得回头看一眼它写的计划文档——那是你动工前唯一能叫停的机会。

拥有数万开源项目工具的小程序上线了大家可以找到自己感兴趣的工具软件平台小程序还在持续不断更新测评中。