📌 项目地址：obra/superpowers | ⭐ 198,353 颗星 | 🔧 Shell | 📜 未标注
先讲一个可能你碰到过的问题
你让AI写一个函数，它改了你三个文件。你让它加个日志，它重写了整个模块。你回头审查代码，发现测试全被删了，依赖库升级了两个版本，还顺手改了一个跟你需求完全无关的配置文件。
这不是模型能力问题。GPT-4、Claude、Cursor这些工具在写代码上已经够强了。问题出在编码代理没有边界感，缺少一套让它“先想清楚再动手”的流程。GitHub上obra/superpowers这个项目，就是专门解决这个问题的。项目用Shell写成，198,353个Star。
它不是代码库，是一套“代理行为规范”
点进仓库你会发现，没什么可下载的脚本。README第一句说清了它的本质：
Superpowers is 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.
翻译过来：这是一套完整的软件开发方法论，加上一组可组合的技能和一套初始指令，让编码代理按这套方法工作。安装后，代理启动时自动加载这些规则，不需要手动告诉它“先分析需求”、“先写测试”。
工作流程：三段式强制工程纪律
流程不依赖人类提醒，代理启动后自动触发。分为三个步骤，全部写死在代理的初始配置里。
第一步：反向需求确认。 你说“帮我建个东西”，代理不会直接写代码。它会反问“你到底想做什么”。从对话里抽取出规格说明（spec），然后分段展示给你确认。README的原文是“shows it to you in chunks short enough to actually read and digest”——每段长度刚好能读完，不会让你面对几十页文档。
这一步强制你把需求说清楚，而不是让AI猜。
第二步：TDD+YAGNI+DRY的强制实现计划。 规格确认后，代理写一份实现计划。READEME对这份计划的要求很有意思：
an implementation plan that’s clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow
翻译过来是：计划必须清晰到“一个热情但品味差、没有判断力、缺乏项目背景、讨厌测试的初级工程师都能照着做”。
这份计划强制包含三条规则：
- TDD： 先写测试，再写实现，测试必须是红-绿模式（先跑不过，再跑过）。
- YAGNI（You Aren’t Gonna Need It）： 不写当前不需要的功能。
- DRY（Don’t Repeat Yourself）： 不重复。
第三步：子代理驱动开发（Subagent-driven Development）。 你同意计划后，主代理启动多个子代理。每个子代理负责一个具体任务：写测试、写实现、跑测试。主代理检查输出，不合格的退回重做。READEME的原话是“It’s not uncommon for your agent to work autonomously for a couple hours at a time without deviating from the plan you put together”——连续自主工作几个小时不偏离计划，很常见。
这个机制有点像代码审查的自动化版本。子代理只有任务上下文，没有项目大局观，所以不会自作主张改别的地方。
198k星是怎么来的
这个数字说明两件事。第一，很多人吃过“代理自作主张”的亏。第二，这套流程不是一个人闭门造车，背后有组织：Primer Radiant团队。他们不仅维护仓库，还提供企业支持（sales@primeradiant.com），招聘全职社区工程师（https://primeradiant.com/jobs/superpowers-community-engineer/）。说明项目有持久性，不是个人练手。
安装：只有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安装分两种方式：
官方插件市场（推荐）：
/plugin install superpowers@claude-plugins-officialSuperpowers自营市场：
先注册市场源，再安装插件：
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace区别在于官方市场的是Anthropic审核过的版本，自营市场更新可能更快但风险自担。安装后不需要配置，代理启动时自动加载。
什么项目适合用这套流程
我自己的看法：Superpowers适合复杂、需要质量保证、变更需要可追溯的项目。不适合一次性脚本或边界清晰的临时任务。
举个例子。我在Claude Code里要求“写一个读取Markdown统计标题数的命令行工具”。代理没有直接写代码，先反问我“输出格式是什么？是否递归子目录？是否处理非Markdown文件？”我回答了三次才确认规格。然后它生成计划——三个任务：写测试、写实现、写README。我确认后才启动子代理执行。最终输出一套测试覆盖率100%的代码，没有修改其他文件，逻辑完全符合规格。代价是耗时长了一倍。
对临时任务来说，一倍的时间成本不值。但如果你在做一个项目维护周期几个月甚至几年的正经开发，这一倍的时间买的是“改动不出问题”的确定性。
总结
Superpowers的核心价值不是让AI写更多代码，而是让AI写代码时“不做不该做的事”。它把TDD、YAGNI、DRY这些工程原则硬编码到代理行为里，用子代理隔离任务降低副作用，用规格确认避免需求跑偏。198k星不是因为它炫酷，而是因为它解决了一个实际问题：AI代理需要流程管理，而它提供了目前最系统化的方案。
如果你在用AI做正经软件开发，值得试试。至少，把README里的流程当方法论手动执行一遍，也会有收获。