如果在AI编程这件事上只能装一个skill我目前会毫不犹豫选superpowers。这个技能包可以直接装进Codex CLI、WorkBuddy、Trae等主流开发工具装上之后相当于给AI配了一套完整的工作流程它会自动拆解任务、规划步骤、选择合适的工具解决问题而不是像默认模式那样张嘴就来。这篇内容适合正在用AI写代码、但对产出质量还不够满意的开发者也适合刚听说skill这个概念、还不知道怎么下手的初学者。我会把superpowers是什么、为什么值得装、在三个常见环境里怎么装、装完之后怎么用、遇到问题怎么排查一次讲透。整个流程我自己跑过不止一遍所有命令和配置都是可以复现的你照着做基本不会踩坑。1. 先说结论superpowers到底是个什么东西1.1 从一次真实的卡壳经历说起大概一个月前我在做一个内部工具的API对接模块代码量不大但涉及两个系统之间的鉴权、重试、日志链路逻辑有点绕。我当时用的是默认配置的Codex CLI让它帮我写一个带重试机制的HTTP客户端结果它确实给了代码但一跑就挂重试策略写在for循环里退避时间全部写死日志连trace_id都没打。我说逻辑有问题它又改了一版改完倒是能跑了可代码风格和项目里其他文件完全不一致我review的时间比我自己写还长。后来一个同事提到他装了superpowers之后AI处理这类任务会先问清楚调用方式、错误码定义、超时要求然后给出一个带边界处理、可测试的完整方案。我当时的第一反应是这不就是个提示词模板嘛但实际用过之后发现它的机制比提示词模板要深得多。它不是让你去背一段万能prompt而是改变了AI处理任务的默认路径。从那一刻起我才意识到同样是Codex CLI基础配置和带技能包的差距体验完全是两个级别。1.2 superpowers能解决什么痛点先说我理解的痛点。用AI写代码常见的三种挫败感第一AI太顺着你了你说要一个功能它油门踩到底直接给代码完全不质疑需求本身有没有漏洞第二生成的东西只能在演示环境里跑换到真实项目里立刻水土不服因为你不说它就不会考虑异常分支第三它没有工作记忆上一次review时你明明告诉过它不要在controller层写业务逻辑下次它照样写。superpowers解决的就是这三个问题。它把理解需求、拆解任务、规划实现、自测验证这几个环节拆成了不同的子技能AI在调用的时候会按顺序执行并且每一步都会向你确认关键信息。装完它以后我给AI派活时感受到的变化非常明显它开始会反问会列计划会在动手前说我先确认一下这几个边界条件。这种体验上的改变没法靠一句请仔细分析需求来实现因为那只是临时指令下次对话就失效了而skill是固化在工具里的工作流只要加载了就会一直生效。1.3 它的核心机制把复杂任务的边界交给AI我自己理解这个skill的核心机制可以类比成给新入职的程序员发了一本团队工作手册。默认状态的AI相当于一个聪明但没经验的新人你交代什么它做什么不交代的事情它默认不用做superpowers相当于手册里写了接需求之后先做这几件事、做完第一件才能做第二件、遇到A情况走流程B。所以它的本质不是一份提示词而是一套可重复执行的流程定义。说人话这个skill可以拆解成几种子技能需求澄清、任务规划、代码生成、自测验证、代码审查。每次你要做一件具体的事AI会先识别你触发的是哪个子技能然后按照对应的流程往下走。这套东西的厉害之处在于你不需要每条需求都从头讲一遍请先分析需求再写代码只要装好skillAI会默认走这个流程。我一开始觉得这套机制会不会太重毕竟有些小需求根本不需要这么多环节但后来发现你完全可以通过任务描述来控制流程的深度这一点后面会专门讲。2. 安装前的准备工作先把地基打牢2.1 需要准备的工具和环境装superpowers之前你先得确认自己手头的环境能跑起来。我用下来最省心的组合是Node.js 18以上版本Python 3.10以上版本以及最新版的Codex CLI或对应的AI编程工具。为什么强调Node和Python因为skill本身是一个JavaScript/Python混合实现的项目安装脚本依赖Node运行时而子技能里有一些测试和代码分析工具依赖Python环境。如果版本太老装的时候经常会报一堆依赖冲突排查起来很浪费时间。另外建议把git配置好SSH key也配好。原因很简单superpowers的安装过程要从仓库拉取代码而后续使用中它也会以git diff为基准来做代码审查和增量修改。如果你平时习惯用HTTPS方式拉代码也问题不大但SSH方式更稳特别是在公司网络环境下HTTPS方式有时候会卡在认证环节。我自己第一次装的时候就是HTTP认证卡了十分钟换成SSH之后一条命令就过了。对了Windows用户记得装一下git for windows并且保证git命令在终端里可以直接执行不然安装脚本会在拉起依赖时找不到git的路径。2.2 版本兼容性要点这里要说一个比较重要的点superpowers对工具的版本是有要求的至少在我测试的几个版本里是这样的。Codex CLI如果版本太旧skill的加载机制就不完整装完之后AI不会自动触发子技能相当于白装。WorkBuddy这边情况类似老版本对markdown指令文件的解析支持不完整会出现skill已经安装但不可用的尴尬情况。建议安装前先跑一下工具的版本命令比如codex --version然后对比skill文档里标注的最低版本要求。如果你用的版本低于要求优先升级工具本身而不是去强行适配。我见过有人为了不升级工具手动改了skill的配置文件结果后续skill更新时直接冲突最后不得不重装。版本这块别偷懒升级工具的成本远低于排查诡异问题的成本。还有一个经验是安装完skill之后同一周内如果官方发布了新的skill版本可以顺手跟着更新一下很多bug和兼容性问题其实都是在早期版本里修掉的。2.3 建议先跑通的第一个小项目环境弄好之后别急着往正式项目里塞superpowers先用一个最小项目把流程跑通。我的做法是新建一个临时目录里面只放一个hello.py然后让AI给这个脚本加上命令行参数解析。装好superpowers之后你会发现它处理这个任务时会先问你参数格式是什么是否需要异常处理——这就代表加载成功了。这么做的目的是排除干扰因素。第一次使用你大概率会遇到某个子技能不生效AI不按流程走的问题如果此时后面还有一个真实业务项目在等你人很容易烦躁改来改去把环境搞得更乱。临时小项目的好处是流程不通你可以随时删掉重来没有心理负担问题定位也快。等小项目跑通再把superpowers引入真实项目心里基本就有底了。这一步我强烈不建议跳过因为很多人在正式项目里第一次用skill遇到问题会误以为是项目本身的问题结果花了大量时间去排查项目配置最后才发现是skill安装时目录放错了。3. 在Codex CLI中安装superpowers完整实操3.1 Codex CLI与Skill机制的配合方式Codex CLI的skill机制简单说就是通过一个特定目录加载技能定义文件AI在交互时会扫描这些文件把技能里的指令合并进上下文。所以安装superpowers的本质就是把skill文件放到Codex CLI能扫描到的目录下并确保配置里开启了对应功能。理解这一点之后安装过程你就不需要背命令了因为核心就三件事找到配置目录、放下文件、确认加载。有人可能会问为什么不能直接在系统全局装原因在于每个项目用的技术栈和代码规范不一样全局生效会带来很多误触发。比如这个项目是Python后端那个项目是前端同一个技能在两种场景下的执行细节应该不同。所以Codex CLI的设计是让skill按项目或按用户级别分别配置安装的时候先想好你要放到哪个层级别一股脑全塞到全局。如果你平时经常在多个项目里切换我建议按项目级安装这样每个项目的技能配置可以跟随代码仓库同步不会乱。3.2 安装步骤详解以下是我在Codex CLI里装superpowers的实际操作流程按步骤照做基本不会出问题# 第一步确认版本 codex --version # 如果版本低于要求先升级 codex update # 第二步在项目根目录安装superpowers codex skills add superpowers # 第三步确认技能文件已经出现 ls .codex/skills第一步确认Codex CLI的版本。在终端里执行codex --version如果显示版本号低于skill文档要求先执行codex update把工具升级到最新版。第二步进入项目根目录执行codex skills add superpowers。这一步会从技能仓库拉取最新的superpowers定义并自动安装到当前项目的技能目录。第三步在项目根目录检查.codex/skills目录里面应该能看到superpowers相关文件。第四步重新启动Codex CLI会话。这一步非常关键很多人装完不重启会话里仍然没有技能信息以为没装成功。第五步随便给AI派一个简单任务观察它是否开始追问细节。如果AI开始反问你这个模块的边界条件是什么说明技能已经成功加载。整个安装过程大概5分钟其中大部分时间是花在拉取仓库和依赖上。如果你在公司内网环境下安装网络比较慢或者有防火墙限制可以考虑设置代理环境变量但这一步根据网络环境来定不是必须的。3.3 安装后的第一件事验证是否能正常加载装完之后别急着展开正式工作先做一次加载验证。我推荐的验证方式是打开一个新会话输入列出你当前可用的技能如果AI能够把superpowers包含的子技能列出来说明加载成功。这一步的关键是要在新会话里操作不要用旧的、已经运行了很长时间的会话因为旧会话的上下文里可能没有技能信息。另外我会建议你在验证的时候顺便看两个东西一是技能的版本号和文档里的版本是否一致二是子技能列表里有没有出现重复项。重复项我遇过一次原因是之前手动拷贝过配置文件后来又用命令安装了一次两个来源的文件叠加在一起。如果出现重复清理掉多余的配置文件即可但这一步最好在真实项目开始之前处理掉不然后续很容易出现AI执行技能时行为混乱的现象。验证通过之后我一般会顺手把hello.py的临时项目清掉保持工作目录干净然后再进入正式的开发流程。4. 在WorkBuddy和Trae等场景中安装superpowers4.1 WorkBuddy中安装Skill的步骤WorkBuddy是另一类集成AI能力的办公/开发工具它的skill安装方式和Codex CLI不完全一样但思路类似。我测试的版本里WorkBuddy提供了图形化的技能管理界面不需要敲命令。安装步骤大概是打开WorkBuddy的设置面板找到技能或Skill入口点击导入选择superpowers的Skill文件然后确认启用。这里有一个需要特别注意的地方WorkBuddy对Skill文件的格式要求比较严格如果你下载的superpowers是源码包里面有多个目录导入的时候需要选择对应的manifest文件而不是把整个文件夹拖进去。我第一次导入时就是没有选对文件界面一直提示Skill格式错误排查了几分钟才明白是文件选择的问题。如果你也遇到同样提示优先检查是不是选错了文件层级。另外WorkBuddy导入完成后需要完全退出再重新打开一次我在部分版本上遇到过导入后立刻使用技能AI并没有感知到技能的情况重启之后才恢复正常。4.2 Trae Work CN中的安装方式Trae Work CN作为国内AI IDE场景的一员对skill的支持也在逐步完善。在我手头的版本里它的安装方式和Codex CLI有一点相似都是通过配置文件来引入技能。具体路径是在项目根目录下创建一个.trae/skills目录把superpowers的skill文件放进去然后在Trae的设置里开启自定义技能开关重启IDE后技能即可生效。不过要注意Trae Work CN对skill文件的编码格式有要求。如果你在Windows上编辑过配置文件文件可能是GBK编码放到Trae里解析会乱码。我的解决方案是统一用UTF-8 without BOM格式保存并且在放置文件后手动检查一遍目录结构。这类问题在Linux/macOS上基本遇不到但Windows用户最好提前注意不然插件明明放对了路径AI却始终读不到内容。另外Trae Work CN里如果同时使用了多个插件偶尔会看到插件之间的快捷键冲突虽然不影响技能加载但会干扰你调用AI功能的入口。这种情况下确认一下键盘映射配置就好。4.3 多环境共用同一套技能的思路很多人的实际工作环境不止一个公司电脑上装的是Windows家里是macOS偶尔还在Linux服务器上跑任务。如果每个环境都重新安装一遍superpowers不仅浪费时间还会出现版本不一致的问题。我的做法是把技能目录纳入git仓库管理和项目代码一起同步。这样换一台电脑clone代码之后只需要执行一条安装命令技能版本就和之前完全一致。这个方案有一个前提技能目录不要和密钥、本地配置文件混在一起。我一般会在技能目录里保留一个example.config文件但真实的token、API key之类全部放在环境变量或者额外的gitignore目录里。这样既保证了技能可以跨设备同步又不会把敏感信息带到仓库里算是我实际用下来比较稳妥的做法。顺带一提技能目录的更新最好也走git流程先在分支上验证新版本没问题再合并到主分支这样团队协作时不会有人莫名其妙用上一个不兼容的技能版本。5. 使用superpowers的几个关键技巧5.1 如何让AI真正拥有superpowers安装只是第一步让AI在对话中真正调用superpowers其实还差一层。根据我的经验新会话开启后第一条消息最好直接说明任务目标然后附上一句请使用superpowers来处理这个问题。这样做的目的不是形式主义而是明确触发对应子技能。虽然理论上AI会自动识别并调用但在复杂任务中主动声明能让技能调用路径更稳尤其是当任务同时涉及多个子技能时。另外不要在对话中途突然抛一个和当前上下文毫无关联的新任务并期望它继续用superpowers处理。我试过很多次这种跨任务切换最容易出问题AI可能还在上一个技能的工作流里结果被你拉去做另一件事整个流程就乱了。最好的做法是一个会话尽量只专注处理一个任务。如果确实要切换先开新会话再重新声明一次使用superpowers。这个习惯一旦养成你会发现AI输出的稳定性提升得非常明显因为它的上下文里少了很多干扰信息。5.2 任务拆解与技能调用的最佳实践superpowers的子技能虽然好用但也不是什么任务都需要全部走一遍流程。比如一个单纯修改变量名的小改动如果也要求AI先做需求澄清再做规划再做审查反而浪费时间。我的经验是用任务复杂度判断来决定要不要完整走流程改动范围小于一个文件的核心逻辑直接静态修改涉及接口设计、数据迁移、跨模块修改的任务才让AI完整调用superpowers的全流程。这个判断说起来简单实际操作中还是有一些模糊地带。我自己习惯在任务描述里就标明期望的工作模式比如这是一个小改动直接修改不用走完整流程或者这是一个涉及重构的任务请按superpowers的标准流程处理。AI听到之后会选择合适的路径。这种沟通方式其实就是对流程的请求级控制比每次说你现在开始用superpowers要精确得多。等你用多了会发现同一个AI、同一套技能在不同的人手里效果差异很大核心区别就在于任务描述里能不能把流程深度讲清楚。5.3 处理复杂项目时的实战策略当superpowers被用在大型项目里时最需要留意的是上下文过载。项目代码一多AI的上下文窗口再大也有限如果把整个项目的文件都塞进去技能执行到一半就可能丢失信息。我处理大型项目的方式是先把任务拆成几个独立的子任务每一个子任务单独提交给AI每个子任务只携带和该任务相关的文件而不是整个项目的上下文。配合superpowers的话我还会在任务开始时告诉AI先扫描项目结构判断哪些文件与本任务相关让它先做信息筛选再进入具体实现。这样可以显著降低上下文被无关文件占满的概率。另外大型项目里出现问题时不要留在原会话里反复问因为前期的长上下文已经让AI的注意力分散了更适合的操作是把报错信息、相关代码片段整理成简洁的材料然后在新会话里重新开始。这样做一次两次可能看不出差距项目一大效率差异非常明显。我最近处理一个多模块重构任务时就是用了这个方法每个模块单独开一个会话整体进度反而比之前一个会话硬扛完所有模块快很多。6. 常见问题与排查技巧实录6.1 典型问题速查表我整理了安装和使用superpowers过程中最常遇到的几个问题做成一个速查表方便你对照排查问题现象可能原因排查/解决办法安装后AI没有任何变化工具版本过旧技能未加载升级工具版本重启会话技能列表里找不到superpowers文件安装目录放错或文件层级不对检查技能目录确认manifest文件位置AI不反问细节直接给结果当前不支持子技能触发或你开的是旧会话新开会话重新声明使用superpowers调用技能时报语法解析错误配置文件编码或格式问题确认UTF-8编码检查缩进与嵌套技能重复加载行为混乱手动拷贝和命令安装叠加清理多余配置文件保留一份加载后某个子技能不可用skill版本和工具版本不匹配对照文档更新skill到兼容版本这张表看起来简单但每一条背后都是真实的踩坑记录。最频繁出现的是第一行安装后AI没有任何变化大部分原因是会话没有重启或者工具版本太旧导致技能文件没有被扫描到。如果你在自己的环境里也遇到同样情况先别怀疑是不是装错了按表格里的顺序排查一次大概率能在五分钟内定位问题。6.2 我实际踩过的一些坑第一个坑是版本懒升级。我一开始用的Codex CLI版本比较老直接装superpowers装完发现AI完全没反应。我以为是安装方式不对前前后后重装了三次最后升级工具版本才解决。那次给我最大的教训就是排查问题之前先看工具版本和skill版本的兼容性要求很多疑难杂症其实就是版本不匹配。第二个坑和目录结构有关。我曾在Windows的WorkBuddy里导入skill因为文件压缩包解压之后多了一层嵌套目录导致workbuddy无法识别manifest文件反复提示格式错误。后来我把目录结构整理成和文档示例完全一致之后一次就成功了。这个问题的隐蔽之处在于你以为是工具不支持其实只是目录层级差了一层。第三个坑是上下文爆炸之后技能失效。有一次我在一个很长的会话里让AI处理多个任务前三个任务都很顺利到第四个它突然变得不听话不再使用superpowers的流程直接给出最随意的答案。排查之后发现是会话上下文太长技能信息被挤出了有效范围。从那以后我给自己定了一个规矩一个会话最多处理两个相关任务第三个任务无论多简单都新开会话。这个规矩执行下来AI的输出稳定程度明显提高。最后再分享一个我自己的使用习惯把superpowers当成一个入门教练来用而不是替代你思考的机器。我刚开始用的时候几乎每个任务都依赖它的完整流程时间长了它会反复做的那几件事——拆解需求、确认边界条件、自测验证——慢慢变成了我自己的习惯。这个时候再回到默认状态哪怕没有superpowers我对AI输出质量的判断力也和以前完全不一样了。如果你装完它第一次跑任务时也遇到AI突然变笨的感觉别着急先按上面第6节排查一遍大概率是会话或版本的问题。等这套流程在你手里稳定下来你可能会和我一样开始期待每天打开终端的时刻。