GitHub 上有个仓库不到一年攒了 26.4 万颗星，主语言不是 TypeScript 也不是 Python，而是 Shell。它不造模型、不做编辑器、不提供云端服务，只干一件事：给你的 coding agent 装上一套完整的软件开发方法论。这就是 obra/superpowers。截至 2026 年 8 月 1 日，仓库有 264,481 颗星、23,607 个 fork、310 个开放 issue，MIT 协议，主语言 Shell，创建于 2025 年 10 月 9 日，最近一次推送在 7 月 31 日。README 开篇一句话定调："A complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them."--一套完整的软件开发方法论，构建在一组可组合技能和若干初始指令之上，确保你的 agent 真的会用它们。作者署名 Jesse Vincent，背后公司叫 Prime Radiant。
解决什么问题：Agent 不缺聪明，缺纪律
用过 Claude Code、Cursor 的人多半踩过这些坑：你说"加个登录功能"，Agent 二话不说开始写代码，写到一半发现需求理解歪了，推倒重来；或者它一口气写了 300 行没写一个测试，你不敢合；再或者它写着写着忘了最初的计划，开始自由发挥，给你造了一堆你根本没要的东西。根子上的问题不是模型不够聪明，而是没人逼它在动手之前先把"做什么、怎么做、做到什么程度"想清楚。Superpowers 解决的就是这个--它不是另一个 coding agent，而是一套装在你现有 agent 里的工作纪律，让 agent 在写第一行代码之前，先退一步问你到底想干什么。
市面上管 agent 行为大致三层：CLAUDE.md / .cursorrules 这类静态规则告诉 agent"怎么做"，但照不照做全靠自觉；MCP 工具给 agent 加"手"但不约束"该不该动手"。Superpowers 是第三层：把方法论变成自动触发的技能，不是建议是强制工作流。前两层管"能力"，它管"纪律"。
核心机制：先问清楚，再动手
它的工作方式从你启动 coding agent 的那一刻就开始了。Agent 发觉你在构建什么东西后，不会直接跳进去写代码，而是先退一步问你到底想做什么。它通过对话把需求一点点扯出来，形成一份 spec（规格说明），然后把 spec 分成短到你真能读进去的段落，一段段展示给你确认。你签字画押之后，agent 才生成一份实现计划--README 的原话是，这份计划得清晰到"一个热情有余、品味不足、毫无判断力、毫无项目上下文、还讨厌写测试的初级工程师"都能照着做。计划里反复强调三条：TDD（测试驱动开发，先写测试再写代码）、YAGNI（You Aren't Gonna Need It，别写你现在用不到的东西）、DRY（Don't Repeat Yourself，别重复自己）。你说"go"之后，它启动 subagent-driven-development 流程，派子代理逐个任务推进、检查、审查。README 说，你的 agent 连续自主工作几个小时不偏离计划是常有的事。关键是这些技能会自动触发--你不需要手动调用任何命令，装上之后你的 coding agent 就"有 Superpowers 了"。
七步工作流：从头脑风暴到清理分支
README 把完整工作流拆成七步，每一步对应一个技能，按顺序触发：
第一步 brainstorming（头脑风暴）：在写代码之前激活。通过提问把模糊的想法磨成清晰设计，探索替代方案，分段展示设计供你验证，最后存一份设计文档。
第二步 using-git-worktrees（git 工作树）：设计批准后激活。在新分支上创建隔离工作区，跑项目初始化，确认测试基线干净。
第三步 writing-plans（编写计划）：拿到批准的设计后激活。把工作拆成每个 2 到 5 分钟就能干完的小任务，每个任务都带精确的文件路径、完整代码和验证步骤。
第四步 subagent-driven-development 或 executing-plans：计划在手后激活。每个任务派一个全新子代理去执行，做两阶段审查--先查 spec 合规、再查代码质量；或者分批执行并在批次间设人工检查点。
第五步 test-driven-development（测试驱动开发）：实现过程中激活。强制走 RED-GREEN-REFACTOR 循环--先写一个会失败的测试、看它失败、写最少的代码让它通过、提交。如果发现先写了代码再补测试，直接删掉重来。
第六步 requesting-code-review（代码审查）：任务之间激活。对照计划审查，按严重程度报告问题，关键问题阻断推进。
第七步 finishing-a-development-branch（收尾分支）：任务完成后激活。验证测试通过，给出选项--合并、提 PR、保留或丢弃，然后清理工作树。
README 强调：agent 在执行任何任务之前都会先检查有没有相关技能可用。这些是强制工作流，不是建议。
技能库拆解：四类技能覆盖全生命周期
Superpowers 内置的技能分四类。
测试类：test-driven-development，走 RED-GREEN-REFACTOR 循环，附带一份测试反模式参考，告诉你什么测试不该写。
调试类：systematic-debugging，一个四阶段根因排查流程，内置 root-cause-tracing（根因追踪）、defense-in-depth（纵深防御）、condition-based-waiting（条件等待）三种技术；verification-before-completion，确保问题真的修了再宣布成功--这条直接对应它的哲学"证据优于声称"。
协作类是最厚的一类，九个技能：brainstorming（苏格拉底式设计打磨）、writing-plans（详细实现计划）、executing-plans（带检查点的分批执行）、dispatching-parallel-agents（并发子代理工作流）、requesting-code-review（审查前清单）、receiving-code-review（回应审查反馈）、using-git-worktrees（并行开发分支）、finishing-a-development-branch（合并 / PR 决策流程）、subagent-driven-development（带两阶段审查的快速迭代）。从想清楚到交付，全链路覆盖。
元技能类：writing-skills（按最佳实践创建新技能，自带测试方法）和 using-superpowers（技能系统入门介绍）。
一个值得注意的取舍：README 在 Contributing 部分明确说"通常不接受新技能贡献"，而且任何技能更新必须在所有支持的 coding agent 上都能跑。技能行为测试用的是 superpowers-evals 项目的 drill 评测框架。这和 OpenClaw 的 clawhub 技能商店（5400+ 技能、开放注册）是两个极端：一个宁可少而精，一个宁可多而广。
11 个 coding agent 通吃
Superpowers 支持的 coding agent harness 有 11 个：Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。每个安装方式不同，但思路一致--把 Superpowers 当插件装进去。
Claude Code 走官方插件市场，一行命令：/plugin install superpowers@claude-plugins-official。Cursor 输入 /add-plugin superpowers。Codex CLI 输入 /plugins 搜 superpowers。Codex App 在侧边栏 Plugins 里点加号。Kimi Code 进 Marketplace 找 Superpowers，或 /plugins install https://github.com/obra/superpowers。Gemini CLI 用 gemini extensions install。Antigravity 用 agy plugin install。Pi 用 pi install git:github.com/obra/superpowers。Factory Droid 和 GitHub Copilot CLI 先注册市场再装。OpenCode 让 agent 自己拉安装说明。
一个细节：同时用多个 coding agent 的话，Superpowers 要在每个里面分别装一次--它走各平台原生插件机制，不是全局代理。好处是从 Cursor 切到 Claude Code 体验一致，方法论不随工具变。
哲学与取舍
README 列了四条哲学：测试驱动开发（先写测试，永远如此）、系统化优于即兴（流程优于猜测）、复杂度消减（以简洁为首要目标）、证据优于声称（先验证再宣布成功）。这几条不是空话--test-driven-development 技能会在你"先写代码后补测试"时把代码删掉让你重来，verification-before-completion 会在你说"搞定了"之前逼你先跑验证。
关于遥测：默认从网站加载 brainstorming 技能的可视化伴侣 logo，请求只带版本号，不带项目信息或 prompt。设 SUPERPOWERS_DISABLE_TELEMETRY 可关闭，也尊重 Claude Code 的 DISABLE_TELEMETRY 开关。
和本项目的呼应：我们也在用 agent-skills
说个真实体感。做这个网站（aiwebcool.com）时，项目也用了同样的 agent-skills 机制--.agents/skills 下放 hallmark、humanizer 等技能，.claude/skills 符号链接过去，agent 启动自动加载。和 Superpowers 思路一致：不靠人记流程，靠技能自动触发。区别在于 Superpowers 把这套方法论做成了跨 11 个平台、经过 drill 评测验证的通用产品，我们只是自家项目用了个简化版。读它 README 时最大的感受是"原来这套东西可以系统化到这个程度"--把"先想清楚再动手"这件听起来像废话的道理，变成了一串可执行、可验证、可复用的技能。
适合谁，注意什么
适合：天天用 coding agent 但受够了它"不问清楚就开写"的开发者；想给团队定一套统一 agent 工作纪律、又不打算自己从零搭的技术负责人；在用 TDD 但发现 agent 总跳过测试的团队；同时用多个 coding agent、想要一套跨平台方法论的。
注意四点。一是它依赖 coding agent 自身的插件和子代理能力，如果你的 agent 不支持 subagent 或 skill 自动触发，Superpowers 装上也只是个摆设。二是"自主工作数小时"的前提是前期 spec 和计划足够扎实--计划糊弄，agent 也会糊着往下跑，垃圾进垃圾出。三是它不接受新技能贡献，想往里塞自定义流程得另想办法（可以用 writing-skills 技能在自己项目里写，但不会进官方库）。四是 MIT 协议本身免费，但 coding agent 的订阅费另算--Claude Code 约 20 美元 / 月、Cursor 约 20 美元 / 月。Superpowers 省的是你盯它干活的时间，不是订阅费。企业需要商业支持、额外工具或托管支出管理，联系 [email protected]。
背后的人和商业模式
作者是 Jesse Vincent，博客 blog.fsck.com，2025 年 10 月 9 日发的首发公告。他背后是 Prime Radiant 公司（官网 primeradiant.com），评测框架 superpowers-evals 放在 prime-radiant-inc 组织下。商业逻辑清楚：开源方法论（MIT）是免费入口，企业服务（商业支持、工具、托管支出管理）是变现路径。社区在 Discord 活跃，新版本可在 primeradiant.com/superpowers/ 订阅通知。
Superpowers 不复杂--没有一行模型代码，不提供 API。它做的事是把"先想清楚再动手"这套工程纪律变成技能塞进你已有的 coding agent。26.4 万颗星的背后，是被 agent 自由发挥折腾过的人发现"管住流程"比"换个更强的模型"更值钱。
参考来源
- Superpowers GitHub 仓库（264,481 star / 23,607 fork，Shell，MIT 协议）：https://github.com/obra/superpowers
- README 原文（方法论定位与技能清单）：https://github.com/obra/superpowers/blob/main/README.md
- 首发公告（Jesse Vincent，2025-10-09）：https://blog.fsck.com/2025/10/09/superpowers/
- Prime Radiant 公司官网（商业服务）：https://primeradiant.com
- 评测框架 superpowers-evals：https://github.com/prime-radiant-inc/superpowers-evals/