Superpowers：让Codex/Copilot从对话工具变成AI编程执行者

我先把话挑明现在的AI写代码工具几乎人人都装可绝大多数人用出来的效果就是高级点的补全插件——让它写个函数它能写让它把一个需求从头到尾干完它立刻开始装死。问题不在模型在于工具本身只给了你一张嘴没给你手和脚。今天要聊的superpowers就是专门解决这个问题的VS Code扩展它能让Codex、Copilot这类AI助手从只能聊天变成能拆任务、能改多个文件、能自己跑命令跑测试的完整执行者。如果你正觉得AI编程不过如此或者刚接触Codex还在纠结怎么把它用好这篇文章值得你花十分钟看完。我需要先泼一盆冷水superpowers不是魔法它不会让模型智商暴涨。但它会改变你使用AI的方式——从一句一句挤牙膏变成把整个需求丢给它让它自己规划、自己动手、自己验证。GitHub上这个项目作者是Shopify的创始人Tobias Lütke发布当天就冲上了趋势榜核心原因就是它把AI编程从demo演示拉到了真实干活的层面。1. 先弄明白superpowers到底改了什么1.1 它解决的三个核心痛点用AI写过代码的人基本都经历过下面三个场景。第一上下文断裂——你让AI改了A文件转头让它改B文件的时候它已经把A文件忘得一干二净你不得不反复复制粘贴代码过去。第二只说不做——你要求AI重构这个函数并加上单元测试它给你输出一段完整的重构代码然后让你自己把代码放到对应的文件里本质上你还是在当人肉搬运工。第三单文件思维——大多数AI编程工具默认只处理当前打开的文件可真实项目里一个功能往往涉及十几个文件改了接口就要改调用方改了配置就要改测试。superpowers的思路很直接把AI从一个问答机器人升级成一个硅基实习生。它给模型配了四样东西——文件读写能力、终端执行能力、网页搜索能力以及一个用来拆解复杂任务的工作记忆系统。你可以直接对它说帮我给登录模块加上验证码功能它会自己列出改动清单自己打开LoginController、LoginService、login.html自己改完再自己跑一遍测试最后把结果汇报给你。中间除了第一次确认计划之外你基本不用插手。1.2 它和原生Codex/Copilot的差异在哪里OpenAI的Codex本身有agent模式Copilot也有类似功能但如果你都用过会发现它们更像单线程执行者——你给一个指令它从头做到尾中途卡住了就停下来问你。superpowers引入了一个叫并行Agent的机制它会把任务拆开同时让多个Agent分头干活。比如我让它写一个带缓存的多级菜单接口它会同时开两个Agent一个写缓存工具类一个写菜单树构建逻辑最后再自动合并。还有个细节很多人没注意到它把计划做成了独立环节。普通工具是一上来就改代码superpowers会先把方案写成一段带步骤的计划贴在输出面板里你确认之后它才动手。这一步看着多余实际用起来非常关键——AI经常理解错需求与其等它把错误代码写完了再返工不如在第一步就掐断。我自己实测下来这个确认机制至少帮我省掉了一半的返工时间。2. 安装与配置最容易被旧教程带偏的一步2.1 安装前的准备清单先说环境要求。它本质上是VS Code扩展所以你需要VS Code或者Cursor这类兼容编辑器。模型后端默认支持OpenAI的Codex也需要你有一个可以访问OpenAI API的账号或者能使用Codex CLI登录状态。Node环境不是硬性要求但装了没坏处因为部分辅助功能依赖Node脚本执行。还有一点它需要联网因为网页搜索功能和云端模型调用都跑在网络上。不少人在安装这一步就卡住了原因是在网上搜到了过期的教程。这个扩展在早期版本里的ID是worbuddy.superpowers后来作者把项目迁移到了新命名空间很多老教程还停留在旧ID上。你如果在扩展市场搜索superpowers会看到两个看起来很接近的插件一个是老版本归档一个是新版本装错了自然怎么折腾都不生效。我的建议是直接认准发布者名称新版本的发布者是tobi市场ID是tobi.superpowers实在不确定就上GitHub仓库页面看安装说明那里的信息永远是最新的。2.2 从安装到跑通完整配置步骤打开VS Code左侧扩展面板搜索superpowers找到发布者为tobi的那个点安装。装完之后它会提示你重载窗口先别急着用此时扩展还没连上模型。按下CtrlShiftP打开命令面板输入Superpowers: Login它会让你选择登录方式——如果之前装过Codex CLI直接选Use existing Codex login就能复用没有的话选API Key方式把OpenAI的key粘进去key建议用环境变量或密钥管理工具保存别硬编码在配置文件里。登录完之后还需要检查一下模型配置。在项目根目录创建或编辑.superpowers/settings.json里面可以指定模型名称和参数。我一般这么配{ model: gpt-5-codex, temperature: 0.2, allowedTools: [read, write, edit, terminal, search], workingDirectory: ${workspaceFolder} }temperature我习惯设成0.2写代码场景下这个值越低输出越稳定。allowedTools是给Agent的权限清单默认是全开的但建议按项目情况收紧后面会细说。配好之后用CtrlShiftP运行Superpowers: New Task随便让它读一下当前项目的README文件如果它能正确输出文件内容说明整条链路已经通了。2.3 安装过程中最容易踩的四个坑我把自己和身边同事踩过的坑列出来你对照排查。第一个是扩展装完但命令面板里找不到Superpowers相关命令这多半是版本不对或者VS Code没重载彻底关掉再开一次再不行就卸载重装。第二个是登录时跳转浏览器但回调失败大概率是默认浏览器挟持了协议换成Edge或者Chrome默认浏览器再试。第三个是登录成功了但任务一直卡在思考中先去检查本地防火墙和公司代理设置这个扩展的API请求域名如果被拦会很隐蔽——不报错就是没反应。第四个是某些老项目里有个叫superpowers的文件夹导致工作目录权限异常这个纯属玄学但我在一个遗留工程里确实遇到过把文件夹重命名就正常了。3. 实操把一个真实需求完整交给它3.1 需求拆解与自主计划能力拿一个实际的Java项目场景举例。前阵子我帮朋友搞一个Spring Boot后台需求是给现有的/api/orders接口增加按时间范围筛选和分页能力。放以前我要手动告诉AI改Controller、改Service、改Mapper、改前端调用参数至少得来回拉扯十几次。在superpowers里我只需要做一件事新建任务把需求描述粘进去然后补一句请你先分析项目结构定位所有相关文件列出改动计划。它会在几秒之内开始翻代码然后输出一个计划列表你猜怎么着它不仅找到了Controller、Service、Mapper三层还把OrderQuery.java这个我都没注意到的查询参数类也纳入了改动范围。这一步极其省心因为它自己掌握了项目的地图不用你当导游。计划确认之后它会自动进入执行阶段我可以在输出面板里实时看到它每一步在干什么——读哪个文件改哪个字段跑什么命令。整个过程中它自己调用了Maven编译第一次因为LocalDateTime的JSON格式参数没传对报错了它居然自己读异常堆栈然后去WebConfig里看了全局转换器配置最后改用了DateTimeFormat注解搞定。3.2 并行Agent模式的实际用法关于并行Agent我再说细一点。在任务输入框里用#agent标签可以手动指定要开几个Agent比如#agent2就是两个人同时干活。实践中最适合用并行模式的场景是实现 测试。我让一个Agent专心写接口实现另一个Agent同时写单元测试——两台虚拟员工不会因为文件冲突互相干扰因为它们操作的是不同的文件。最后完成时实现类和测试类几乎是同时落地整个迭代速度比之前串行快了一倍。不过并行模式有个使用前提任务模块之间要足够独立。如果两个Agent都要改同一个类的同名方法最后必然产生冲突还得花时间合并。我的经验是文件与文件之间的并行随便用类与方法级别的并行要谨慎。另外并行Agent的数量不是越多越好实测#agent3以上时回报效率和消耗的token数就不太划算了除非是大型重构那种明确可以拆分成多个子系统的任务。3.3 权限控制与终端执行的安全边界让Agent自动跑终端命令听起来就很危险对不对确实危险。默认情况下superpowers每次执行终端命令前都会弹一个确认框把要执行的命令展示给你看。我强烈建议保留这个确认机制别为了省事把它关掉。有一次我让Agent帮我修复一个构建脚本的依赖冲突它修改完pom.xml之后自作主张跑了个mvn clean install -DskipTests——命令本身没问题但当时我本地在开着另一个占用8005端口的服务它紧接着就想跑mvn spring-boot:run如果这步真执行了两个进程就会撞车。在settings.json里有requiresConfirmation相关的配置项可以单独为终端操作开白名单。比如让Agent可以在npm run test这类低风险命令上免确认但rm -rf这种命令永远要弹窗。我的策略是写操作默认允许因为可以靠Git回滚终端操作全部要确认网络搜索可以放开限制文件的删除操作要单独确认。4. 常见问题与排查技巧实录4.1 问题速查表我把这段时间实操中遇到的问题整理成表基本都是可以直接照着处理的现象可能原因解决办法扩展安装了但命令面板没有Superpowers版本不对或扩展没启用认准tobi.superpowers重载窗口登录Codex时报401API Key过期或未绑定支付方式去OpenAI后台检查key状态换成新key任务一直卡在thinking状态本地网络无法访问API域名检查防火墙和网络代理设置Agent改了文件但保存失败目录没有写入权限检查项目文件夹写权限或重新以管理员模式打开VS Code多个Agent同时输出导致内容混乱并行Agent操作了同一文件拆分任务时明确文件边界让文件级并行而非方法级并行Java项目里找不到Spring Bean定义Language Server还没完全启动先在终端跑一次mvn compile让索引生效后再发任务Token消耗速度过快模型参数或并行Agent太多调小#agent数量把temperature调到0.1~0.2偶尔出现status code: 429API限流暂停任务等一分钟再继续或切换到支持更高限流的模型档位4.2 两个值得反复说的高频坑第一个坑是Agent走出项目目录。默认情况下它的工作目录是你的项目根目录但它读文件的时候有时候会尝试访问../../之类的相对路径。遇到这种情况最好的处理方式是在配置里把workingDirectory锚定并且给只读权限。我从某次事故之后学乖了现在所有项目的.superpowers/settings.json都会加上allowWorkspaceOutside: false禁止它访问工作区以外的任何内容。这既能防止意外改错文件也是给自己的项目上了一道保险。第二个坑是它改完代码但什么都没跑。Agent默认不会主动执行构建或测试除非你在需求里明确要求改完以后跑一下测试给我看。很多人反馈说为什么我的Agent改完代码不验证就是因为漏了这句。建议把验证步骤写成固定句式完成改动后请运行mvn test或npm test如果测试失败请继续修复直到通过。这一句话的威力很大——它会让Agent自动进入改代码→跑测试→修复→再跑的闭环而不是改完就交差。4.3 关于worbuddy那个旧版扩展很多人在搜教程时会看到worbuddy怎么用superpowers这种问题。这个worbuddy其实是最初的发布账号名后来项目作者把扩展迁移到了tobi账号下老版本就归档了。你可以把它理解为同一个东西的前世今生。如果你搜到了老教程且讲的是worbuddy.superpowers里面的命令名称和操作逻辑照样通用只是安装链接需要更新成新版。遇到这个扩展已经被移除或不存在的提示别慌去GitHub仓库找最新的marketplace链接就行。核心思路是认准GitHub仓库而不是认准某个教程里的具体链接。5. 把superpowers用得更好的几个习惯5.1 任务描述的质量直接决定效果很多人在这一步栽跟头。你给AI的指令如果是帮我改一下订单接口它最多只能做到模糊地改一点点——因为你没告诉它改什么、为什么改、边界在哪。而高质量的任务描述应该包含四个要素目标、范围、约束、验证方式。举个例子订单接口增加时间范围筛选只影响/api/orders这个GET接口范围限定在Service和Mapper层前端入参DTO不动完成后跑一遍OrderControllerTest里跟筛选相关的用例。把这段粘进任务输入框你会看到完全不同的输出质量。我甚至建议你把常用的任务描述框架存成模板放进项目的docs/task-templates.md里每次直接复制改改就能用。这套方法不仅仅是给superpowers用任何AI编程工具都吃这一套。如果你现在告诉我说我让AI写的代码总是不能用那么先检查一下你的需求描述是不是只有一句话。5.2 用规则文件约束Agent的行为高级用法是给项目加一个AGENTS.md文件superpowers会自动读取它作为行为准则。你可以在这个文件里写项目规范比如所有新增接口必须包含Swagger注解工具类禁止直接注入Spring容器之类。Agent每次动手之前都会先读这个文件相当于你提前给它灌了一份团队开发规范。我在一个团队协作项目里加了这个文件之后最大的变化不是少写了代码而是少了很多代码风格争议。它写的类统一用了Lombok统一处理了空指针统一加了Slf4j日志——不是因为模型突然变聪明了而是我提前把团队的规矩写进了它的操作手册。这个文件建议放在项目根目录最好配合Git提交方便评审的人也能看到AI的行为约定。5.3 它不能做什么说了这么多好处也得说说它解决不了的事情。它不能理解你客户的真实业务意图不能替你判断一个需求该不该做、优先级多高。它没有审美写出来的代码能跑但未必优雅。它也没有商业sense不会因为一个接口涉及资金操作就主动提醒你要加幂等和日志审计。真正靠谱的用法是把它当成一个执行力极强的junior developer你需要替它把好方向关、做好Code Review。我在实际项目中奉行的原则是它写的每一个文件我都要过一遍至少看一下diff。前几次用的时候你会觉得这比手写还累但当你把任务描述的质量提上去、规矩立好了之后它的活真的能帮你省下大把时间。我现在的日常是早晨到公司先丢给它一个任务让它自己在那里折腾我去开晨会回来之后看它提交的diff有问题就打回重做。这台虚拟实习生不会喊累不会摸鱼唯一的成本就是那点token费用。