做了这么多年AI辅助开发我一直有个感受工具链越来越强但大多数人的用法还是停留在聊天机器人阶段。你问一句它答一句它给你一段代码你复制粘贴完全没有把AI的能力放大到极致。直到我接触到superpowers这个skill包才意识到差距在哪——它不是给你多一个功能而是给AI助手装上了一套完整的工作方法论。简单说superpowers是一组打包好的职业技能专门给Codex CLI、Trae、WorkBuddy这类支持skill机制的AI编程工具用。装上之后AI不再是只会接话的问答机器而是一个会先规划、再动手、边写边测、出错会自己排查的协作工程师。这篇文章我不打算讲虚的直接把我从安装到落地的完整过程、踩过的坑、以及真正好用的几个核心技能全部分享出来。1. superpowers是什么给AI助手装上职业能力包先花点时间把概念讲清楚。很多第一次接触的人会问superpowers到底是个插件、一个模型、还是一个独立软件答案是都不是。它本质上是一套skill文件也就是用Markdown写成的操作手册AI助手在对话时会把这份手册读进去按上面规定的流程和步骤来执行任务。1.1 为什么需要skill这种机制你可能已经习惯了直接对AI说帮我写个登录功能然后它啪的一下给你一段几百行的代码。问题是这段代码真的符合你的项目结构吗测试写了吗边界情况考虑了吗错误处理完整吗大概率没有。因为默认状态下大模型倾向于最短路径回答——你让它写代码它就只写代码不会主动去理解你的业务、不会自己写测试、更不会在动手之前先验证自己的方案。这不是模型笨而是缺少约束和流程。skill机制就是来解决这个问题的。它相当于在你和AI之间加了一层工作交底书告诉AI接到任务后先做什么、再做什么、每个阶段产出什么、采用什么质量标准。而superpowers就是把一整套资深工程师的工作习惯固化成了这层交底书。1.2 superpowers到底解决了什么痛点我用了很长一段时间的Codex CLI一开始的体验其实挺分裂的。简单任务比如给我写个解析JSON的函数它完成得很好但一遇到稍大一点的任务就开始失控改了一个文件引起另外三个文件报错、加了功能但没加测试、代码风格跟项目现有代码对不上……所有问题都要我来兜底AI更像是一个高并发打字员而不是协作者。装上superpowers之后最直观的变化是AI的行为模式完全不同了。它接到一个需求会先让我确认需求的边界然后自己读一遍相关代码文件给出实施计划计划我确认了才动手。写代码的时候会自动带上单元测试跑不过就自己调试修复而不是把报错丢给我处理。这个转变用我同事的话说就是像从一个刚入职但很聪明的新人变成了一个有五年经验、做事有章法的工程师。1.3 社区生态与工具适配情况superpowers不是某个大厂的官方产品而是社区驱动的开源skill集合。它的适配性做得相当好凡是支持SKILL.md或者AGENTS.md约定的工具理论上都能用。目前在Codex CLI、Trae、WorkBuddy这几个主流环境里都有成熟的安装路径而且安装方式各有特色下面我会分别展开讲。2. 我实测的三个安装环境Codex CLI、Trae、WorkBuddy先别急着抄命令安装之前得搞清楚你的主力环境是哪个。不同的工具skill目录结构、加载机制、配置方式都不一样选错了路径装完发现没生效是最浪费时间的。我把三个环境逐个跑过一遍这里直接说结论和对比。2.1 Codex CLI最贴近终端原教旨的选择Codex CLI是我日常工作用得最多的环境也是superpowers适配得最完整的一个。它的skill加载机制很直接你只需要把superpowers的整个仓库克隆到本地的skills目录下Codex CLI启动时会自动扫描并加载里面的skill定义。实际操作下来它对superpowers里那套TDD工作流支持得最好因为Codex CLI本身就跑在终端里执行测试命令、查看输出、再回头改代码这个循环非常顺滑。如果你日常就是跟终端打交道多、习惯用命令行管理一切Codex CLI superpowers会是最顺手的一套组合。不过Codex CLI也不是没有学习成本。它默认的策略、模型参数、权限控制都需要自己调整新手第一次配置时容易摸不着头脑。我个人建议先用默认配置跑通一个简单项目再慢慢调一上来就追求完美配置反而容易被各种参数劝退。2.2 Trae图形界面下的skill体验Trae是AI原生IDE它的设计思路是在图形界面里嵌入AI辅助能力。它同样支持skill机制但加载方式和Codex CLI不太一样——它的技能目录是独立的需要你在IDE的设置界面里指定路径或者把skill文件放到它约定的全局技能目录下。在Trae里用superpowers体验和终端环境有很明显的区别。它的优势是可视化的文件树和diff视图AI在按照superpowers流程执行规划、编码、测试时你可以非常直观地看到每一步改了哪些文件、每个改动是什么内容。特别是在做代码审查类的任务时这种可视化体验比纯终端要好很多。劣势也很明显Trae的图形界面在处理长时间运行的测试时体验一般而且IDE本身的资源占用比终端要高不少。我的建议是如果项目以IDE为主用Trae版如果你的工作流里有很多脚本执行、自动化操作Codex CLI更合适。2.3 WorkBuddy把skill玩成工作流自动化WorkBuddy是三者里最特殊的一个。它不太像一个传统的编程工具更像是一个AI工作流编排器。它的卖点是把各种skill包装成可复用的工作流节点你这个项目里用到的流程、步骤、提示词都可以沉淀下来下次一键复用。在WorkBuddy里安装superpowers与其说是装一个工具不如说是导入一套流程模板。装好之后superpowers里的每一个环节需求澄清、规划、实现、测试、复盘都会变成可视化的流程节点你可以拖拽调整顺序甚至可以插入自己的自定义步骤。这对喜欢折腾流程的人非常友好。但它有个让我不太适应的地方因为WorkBuddy的编排能力太强反而容易让人陷入过度流程化的陷阱。有时候一个简单的需求在superpowers的规划下可能需要好几步流程才能完成操作感比较重。如果你追求的是一句话搞定小任务的轻便体验WorkBuddy反而不推荐。2.4 三个环境的横向对比环境加载机制适合场景上手难度我的推荐指数Codex CLIskills目录自动加载终端重度用户、自动化脚本中等五星Trae全局技能目录/设置指定IDE可视化操作低四星WorkBuddy工作流模板导入流程编排、项目复盘较高三星我把WorkBuddy排在三颗星不是它不好而是它的流程管理能力更适合团队leader、项目经理这类角色做过程管理纯粹写代码的话直接用Codex CLI就够了。3. 安装superpowers全流程实录以Codex CLI为例这一节我按最主流的Codex CLI环境把安装的完整流程拆开讲。我尽量把每一步背后的原因也讲明白这样你在其他环境安装时也能举一反三。3.1 安装前的环境准备先说前提条件。Codex CLI本身需要Node.js环境版本建议在18以上。安装Codex CLI这一步各平台有差异macOS上可以用HomebrewLinux上可以用npm全局安装Windows上我建议直接用WSL原生Windows环境的兼容性问题比较多我自己踩过不少坑。准备工作的核心是确认Codex CLI能正常工作。装完后先跑一个最简单的对话比如让它解释一段代码确认它能正常调用模型。这一步很关键很多人在这一步就卡住了——有的网络环境问题有的是API Key没配好有的是模型权限没开。这些基础问题不解决后面装superpowers也没意义。3.2 获取superpowers skill文件Codex CLI加载skill走的是本地目录扫描机制。先找到你的Codex CLI配置目录在你用户目录下的.codex文件夹里。打开看看正常情况下里面会有config.toml和AGENTS.md之类的文件。如果config.toml存在Codex CLI默认配置已经就绪接着看目录下有没有skills文件夹有的话直接用它没有的话就手动创建一个。然后从GitHub上把superpowers仓库克隆下来。克隆的位置是关键我不建议直接克隆到任意路径再复制粘贴而是直接克隆到skills目录下让仓库本身成为skills的子目录。这样以后拉取更新也方便直接在仓库目录里git pull就行。这一步做完理论上Codex CLI下次启动时就能自动识别到superpowers里的技能了。3.3 验证安装是否成功装完之后怎么知道到底生效了没有有一个很笨但很有效的验证方法直接在当前项目里打开Codex CLI输入一句请给我看看你掌握了哪些技能。如果安装成功AI会列出一串技能清单比如系统设计、规划、测试驱动开发、调试、重构之类的。如果你问它的时候它一脸茫然或者直接说我没有技能之类的话那大概率是加载路径不对。我的排查经验是先确认仓库文件确实在skills目录下其次确认文件权限没问题目录要有可读权限最后确认你当时所在的项目目录的AGENTS.md没有覆盖掉全局的skill声明。多数情况下路径问题占了八成。3.4 快速配置建议默认安装完能用但想用得舒服最好再花几分钟调整一下配置。我自己的经验是改两个地方第一把Codex CLI的默认模型调成编码能力更强的那一档这个不影响skill加载但会让后续代码生成的代码质量更高第二在config.toml里调整一下权限模式——superpowers里的TDD技能会频繁执行测试命令如果权限开得太紧AI每次跑测试都要跟你确认一次体验会很差。权限这个东西真的要自己平衡好开太松有安全风险开太紧又严重影响效率。我的做法是给当前项目目录设置自动批准全局保持默认确认模式。这样既不耽误干活又不至于让AI在没经过你同意的情况下动系统级文件。3.5 Trae和WorkBuddy的安装差异Trae的安装思路其实类似只是不用手动克隆仓库而是在IDE的技能管理界面里点导入然后选择你下载好的superpowers文件夹。它内部会自己拷贝到全局技能目录不需要你管路径。WorkBuddy则是导入一个打包好的流程文件更像是在安装一个预设模板装好之后在技能面板里能看到所有节点。三个环境我都试过感受差异最大的地方是加载粒度。Codex CLI是全局加载无论你在哪个项目里问它它都知道superpowers的技能Trae是按工作区加载切了工作区就得确认一下WorkBuddy则是按流程加载每次用之前得先选对应的流程。理解了这一点你在不同环境之间切换就不会觉得是不是装坏了。4. superpowers里的核心技能哪些最值得用装好只是第一步真正有价值的是里面的技能怎么用。我用了大概三周时间把superpowers里的技能挨个过了一遍这里挑四个我个人觉得最能改变工作方式的展开讲讲。4.1 系统规划让AI先把事情想清楚以前我让AI干活都是直接给指令帮我做一个用户登录功能。现在有了superpowers它的处理方式完全不一样。它会先问我一系列问题这个登录是给谁用的内部系统还是C端产品需要支持第三方登录吗密码策略是什么Session过期时间怎么定一开始我觉得有点烦心想你直接写不就完了吗问这么多干嘛。但试了两次之后我服了——它写出来的东西真的不一样。不是那种看起来能跑的代码而是考虑到了后续扩展性、错误处理、安全性边界的代码。这背后其实是一个很朴素但很多人忽略的道理需求不澄清代码写多深都是白搭。系统规划技能最适合用在项目启动阶段、或者接手一个陌生模块的时候。让AI先读一遍相关代码再出一份设计方案你审一遍方案再让它动手这个先想后做的过程能节约大量返工时间。4.2 TDD工作流测试先行带来的安全感TDDTest-Driven Development在superpowers里是重头戏也是我觉得最值回票价的一个技能。按照传统做法TDD对开发者的自律性要求极高——你得先忍住写实现代码的冲动老老实实把测试写了。但有了AI之后这个问题被大大弱化了因为AI可以严格执行红-绿-重构的循环而人只需要做监督和把关。实际跑起来是这样的AI先写一个会失败的测试跑一遍给你看红色然后写最简代码让测试通过绿色接着重构代码让结构更优雅同时保证测试仍然全绿。整个过程它自己循环推进不需要你在旁边盯着每一行。我要做的就是偶尔看一眼方向对不对、需求理解有没有跑偏。最让我惊叹的是TDD技能改变的不只是写代码的习惯还有调试的效率。以前代码出bug我得开调试器一步步追现在AI按照TDD流程写出来的代码bug率明显下降即使出了问题测试输出也能很快定位到具体模块。4.3 调试排查从瞎猜到有章法superpowers里的调试技能本质上是教AI用二分定位法来排查问题。什么问题都可以拆先根据报错信息定位到大概模块再在模块里二分定位到具体函数然后检查输入输出最终锁定根因。这个过程效率极高因为AI不会像人一样靠经验和感觉瞎猜它靠的是逻辑排除。举个我真实遇到的例子有个任务调度器经常在凌晨三点崩溃日志里面只有一条Connection reset。我一开始一头雾水后来让superpowers进入调试模式它先分析了任务调度器的日志然后列出了一堆可能的原因把最可疑的拎出来逐一排除最后定位到是某个第三方服务的空闲连接过期策略导致的。整个过程花了大概二十分钟换成我手动查起码得两三个小时。4.4 重构优化给旧代码体面地翻新接手老项目最怕的是什么怕乱改改坏了。superpowers里的重构技能很巧妙地避开了这个坑它会先确保现有功能有测试覆盖然后才动手重构。每一次小的重构都会跑一遍测试确认没破坏行为这种安全网式的重构体验大幅降低了对旧代码动手的恐惧感。我有一块很头疼的遗留代码五百多行的一个函数层层嵌套的条件判断看都看不下去。按照superpowers重构技能的指引AI花了大概一个下午的时间把那个函数拆成了十来个小的、职责单一的函数全程测试都是绿的功能行为完全没有变化。改完之后再看到那段代码心情愉悦多了。说实话如果你只是想找个快捷助手帮你写点小脚本superpowers的价值可能没那么明显。但一旦你的项目复杂度上来、需要长期维护这四项技能的价值就会完全释放出来。5. 使用superpowers的常见问题与排查实录任何工具都不会一路顺风superpowers也一样。这一节我把使用过程中遇到的高频问题和解决办法整理出来方便你少走弯路。5.1 问题速查表现象问题原因解决办法安装后AI不认识superpowers技能skill目录路径不对或权限不够检查目录路径、确认仓库可读TDD流程中AI频繁要求确认命令权限模式设置过严在config.toml中放宽项目目录权限生成的代码风格与项目不一致缺少项目上下文在项目根目录补充AGENTS.md说明规范流程过于繁琐技能粒度与任务不匹配小任务跳过规划直接用默认对话模式多工具间切换时技能丢失加载粒度不同确认当前工具的技能加载范围5.2 最容易被忽略的上下文配置很多人装了superpowers之后觉得也就那样我观察下来八成是没配好项目上下文。superpowers的skill是通用的工作流手册但它不了解你的项目具体规范——你的目录结构是什么、用的什么框架、代码风格怎样、测试框架是什么。你需要在项目根目录放一个项目说明文件把这些信息告诉AI。这个文件配置到位之后superpowers才能从通用工作流进化成你项目的专属工作流。我的习惯是只要是新项目第一步先让AI读一遍项目结构、写一份简明扼要的项目说明然后我再补充一些它没注意到的细节。这个动作只用几分钟但能减少后面几十次无效对话性价比极高。5.3 我的使用原则最后分享三个我自己总结的使用原则。第一小任务不要杀鸡用牛刀——改个文案、修个样式直接普通对话模式就行别让AI走完整套流程不然你会被它问得崩溃。第二任务越大越要监督——AI确实是按照规划在执行但规划本身需要你把关方向错了执行得越认真越危险。第三善用复盘——让AI在完成任务后自己总结一下哪里做得好哪里不好这既是帮它记忆也是帮你自己理解整个开发过程。我一直觉得AI编程工具的未来不是更强的话痨而是更可靠的工程师。superpowers的价值正是把后者具象化了。它逼着AI也逼着你按工程规范来做事而不是想到哪写到哪。如果你最近正好在折腾Codex CLI、Trae、WorkBuddy这些工具真的建议花半小时装个superpowers试试感受一下会规划、会测试、会自己修的AI和只会聊天的AI之间差距到底有多大。