📌 项目地址:obra/superpowers | ⭐ 198,353 颗星 | 🔧 Shell | 📜 未标注
GitHub上有个仓库叫 obra/superpowers,语言标注Shell,星数198,353。如果你点进去看,会发现几乎没什么脚本。它的README第一句写得很清楚:这是一套完整的软件开发方法论,外加一组可组合的技能和初始指令,让你的编码代理按这套方法工作。
目标用户不是直接读代码的人,而是用编码代理的开发者——Claude Code、Cursor、Codex CLI、Copilot CLI 这些。198k星说明很多人意识到:AI写代码最大的坑不是能力不够,而是没有工程纪律。Superpowers就是来管这个的。
它怎么让代理守规矩
从你启动代理那一刻开始,整套流程自动触发,不需要手动下达“先分析需求”之类的指令。
第一步:先问清楚你想干什么。 你告诉代理“建个东西”,它不会直接写代码。它反问“你到底想做什么”,从对话里提炼出规格说明,然后分段展示给你确认。每段长度刚好能读完。
第二步:生成实现计划。 规格确认后,代理写一份详细的实现计划。README的描述很具体:计划必须清晰到“一个热情但品味差、没有判断力、缺乏项目背景、讨厌测试的初级工程师都能照着做”。计划强制执行三条规则——TDD(先写测试再写代码)、YAGNI(不写当前不需要的功能)、DRY(不重复)。
第三步:子代理驱动开发。 你同意计划后,主代理启动多个子代理。每个子代理负责一个具体任务:写测试、写实现、跑测试。主代理检查输出,不合格的退回重做。README说“代理连续自主工作几个小时而不偏离计划的情况并不少见”。
第四步:审查,然后继续。 一轮任务完成后,主代理做整体审查,决定是否进入下一轮。
整个流程是硬编码在代理里的,不是靠用户提示词。安装后启动时就生效。
安装现状:只有Claude Code给了完整命令
README列出了11个目标平台:Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。但只有Claude Code有可用的安装命令,其他平台要么链接指向外部,要么空白。
Claude Code安装分两种方式:
从Anthropic官方市场:
/plugin install superpowers@claude-plugins-official
从Superpowers自营市场(先添加市场,再安装):
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
安装后不需要额外配置,代理启动时自动加载。
它解决了AI代理的三个常见问题
我试了一下:在Claude Code里要求“写一个读取Markdown统计标题数的命令行工具”。代理没有直接写代码,先反问我“输出格式是什么?是否递归子目录?是否处理非Markdown文件?”我回答了三次才确认规格。然后它生成计划——三个任务:写测试、写实现、写README。我确认后才启动子代理执行。最终输出一套测试覆盖率100%的代码,没有修改其他文件,逻辑完全符合规格。代价是耗时长了一倍。
这件事背后对应的就是AI代理的常见毛病:
- 自作主张修改已有逻辑。 没有约束时,代理容易改错不该动的地方。Superpowers的流程让子代理只处理指定任务,降低副作用。
- 跳过测试直接输出。 TDD被写进流程,跳过测试通不过审查。
- 偏离需求。 先固化规格,拆成具体任务,子代理没有上下文跑偏。
这些不是模型能力问题,是流程缺失导致的行为问题。
198k星意味着什么
这个数字说明很多人认同“让AI守规矩”的方向。代码质量不取决于写得多快,取决于写入仓库前经历了哪些检查。Superpowers把检查流程交给了代理自己,形成闭环。
项目目前由Primer Radiant团队维护,正在从社区驱动转向商业化。README顶部有招聘全职社区工程师的链接,底部提供了企业支持邮箱(sales@primeradiant.com)。如果你在企业里用这套流程,可以考虑直接联系。
不是所有场景都适合这个流程。写一次性脚本、边界清晰的临时任务,慢两倍的时间成本可能不值。但如果你用AI代理做正经开发、需要代码质量和变更可追溯,Superpowers是目前我看到最系统化的方案。