1. superpowers到底是啥为什么最近AI编程圈都在装它最近“superpowers”这个词在AI编程圈子里刷屏的频率直线上升。不管是codex cli安装superpowers、trae work cn安装superpowers skill还是workbuddy安装skill superpowers这些搜索热词背后指向的都是同一个东西——一套开源的、专门给AI编程助手用的“技能包”。先说明白superpowers不是一个新的模型也不是一个IDE更不是某个公司的商业产品。它本质上是一堆结构化的markdown文件也就是“skill”用来告诉AI编程助手“遇到什么情况该按什么流程干活”。你可以把它理解为给AI助手写的岗位手册让它在编程的时候不再是想到哪写到哪而是按照一套成熟的工作流来推进比如需求澄清、测试先行、代码审查、自动修复这些全部被封装成标准流程AI在对应场景下会自动调用。它解决的实际问题非常具体。用过AI编程助手的人多少都有体会让AI写个函数它一上来就噼里啪啦生成几百行结果连需求都没问清楚让AI重构代码它改完之后测试全挂自己还浑然不知一个稍微复杂的任务交给它做到一半逻辑就乱了前后矛盾。这些问题不是模型能力不够而是缺少一套约束AI行为的工作流。superpowers就是把这个缺失的流程补上。适合谁来装三类人最值得折腾一是正在用Codex CLI、Trae、Claude Code这类工具做日常开发的人二是想试试TDD测试驱动开发但一直没有系统落地的人三是团队里想把AI辅助编码规范化、减少“AI改坏代码”事故的人。当然如果你只是偶尔让AI写个脚本那装不装差别不大它更适合那些把AI当成正经结对编程伙伴的人。2. 安装前先搞清楚skill到底是怎么生效的很多人一上来就照着教程敲命令结果安装完发现AI毫无反应大概率是因为没搞明白skill的运行机制。这里值得花点时间把底层逻辑讲清楚。2.1 一句话解释skill机制给AI的说明书AI编程助手本身是一个通用模型它虽然会写代码但它不知道你的项目规范、不知道你偏爱什么风格、不知道遇到冲突的时候该优先保测试还是保功能。skill就是用来补上这一块的。一个skill通常是一个文件夹里面包含SKILL.md主文件和若干辅助文档。SKILL.md的开头会有frontmatter字段写明这个skill的名称、描述、适用场景AI会通过描述来“判断”当前任务是否该激活这个skill。激活之后整个文件里的流程指引、代码示例、注意事项都会作为上下文注入给AIAI就会按这套规则来执行任务。这个过程完全由模型理解markdown内容来驱动不涉及什么编译或运行所以安装的实质就是把文件放到AI能看到的位置。2.2 主流工具的skill目录和配置差异目前支持skill机制的编程助手越来越多但各自的加载路径并不完全一样。我整理了常见的几个工具skill加载位置说明Claude Code项目下.claude/skills/或用户级~/.claude/skills/最早推广skill机制的工具生态文档最全Codex CLI~/.codex/skills/或项目下.codex/skills/OpenAI的CLI工具逐步完善skill能力Trae Work CN工作区.trae/skills/或通过插件市场安装国内可用版本安装路径类似Claude Code的方案WorkBuddy通过自带skill管理命令安装它对skill做了一层管理器安装更傻瓜化这里要特别提醒这个领域变化非常快表格里的路径是写这篇文章时常见的情况你安装之前最好去对应工具的官方文档里确认一遍或者直接在项目里找找有没有.claude、.codex、.trae这些目录。很多教程失效就是因为路径变了这不奇怪生态早期就是这样。2.3 安装前的环境检查和准备清单不管你用哪个工具下面几项建议先确认好可以省掉后面一大堆问题。Node.js环境很多安装脚本是npx方式执行的node版本不要太老建议18以上。命令行敲node -v确认。git环境如果选择源码clone方式装git是必须的git --version确认。工具版本你的CLI工具尽量更新到较新版本老版本可能不认SKILL.md的frontmatter格式。网络连通性安装过程要访问GitHub仓库或npm registry确保网络通畅。先建一个测试项目不要一上来就在公司老项目里装先用空目录试一遍流程确认没问题再上真实项目。说实话装superpowers本身不复杂绝大部分问题都出在这些前置条件上。我之前遇到过装完完全没效果的情况排查了半天结果发现是Codex CLI版本太老压根不支持skill目录白白浪费一个小时。3. 实操三条主流的superpowers安装路径现在进入正题。我分别讲Codex CLI、Trae Work CN、WorkBuddy三个场景下的安装方法你可以根据自己的主力工具选择对应章节不用全看。3.1 Codex CLI下安装superpowers skillCodex CLI是目前很多人主用的终端AI编程工具在它下面装superpowers主要有两种方式一种是官方推荐的自动安装脚本一种是手动clone仓库两种我都试过分别说下。自动安装方式比较简单在项目目录下执行# 进入你的项目目录 cd your-project # 执行superpowers官方安装脚本 npx superpowerslatest install --target codex这个命令会把superpowers仓库里的skills目录放到Codex CLI的全局skill目录下通常位置是~/.codex/skills/。执行完后可以用ls ~/.codex/skills检查一下能看到superpowers相关的文件夹就说明放对位置了。如果你更喜欢手动管理也可以直接clone仓库然后自己拷目录# 拉取superpowers仓库 git clone https://github.com/obra/superpowers.git /tmp/superpowers # 把skills目录复制到Codex的skill目录 mkdir -p ~/.codex/skills cp -r /tmp/superpowers/skills/* ~/.codex/skills/ # 顺便确认一下 ls ~/.codex/skills手动方式的好处是你能清楚知道每个文件在哪儿出了问题也好排查缺点就是后续要更新的话得自己再拉一次仓库。装完之后在Codex CLI里直接开始对话就行不需要重启。你可以先输入一个简单的任务比如“帮我写一个计算斐波那契数列的函数”如果superpowers生效了AI会先问你需求细节而不是直接甩代码。这一步能快速验证是否装成功。3.2 Trae Work CN下安装superpowers skillTrae是字节出的AI IDE国内版本叫Trae Work CN很多人叫它Trae CN。在这个环境下装superpowers可以走IDE的插件系统也可以直接往工作区里放skill文件。从插件市场安装是最省事的方式打开Trae进入扩展市场搜索“superpowers”或“skill”找到对应的skill包点击安装然后重启IDE让它加载。这种方式对不熟悉命令行的朋友最友好图形化界面点到就行。如果你更想自己控制版本可以手动在工作区创建skill目录# 在你的项目根目录执行 mkdir -p .trae/skills # 从仓库只拷贝superpowers的skill子目录 git clone --depth 1 https://github.com/obra/superpowers.git /tmp/superpowers cp -r /tmp/superpowers/skills/* .trae/skills/ # 验证 ls .trae/skills注意Trae的项目级配置是跟着工作区走的.trae目录建议加进你的版本管理这样团队里其他人clone代码后也能自动加载同一套skill这件事对团队协作特别有用。另外Trae内部的AI助手在对话时你可以在输入框附近找到一个类似“引用技能”的按钮确认相关的superpowers skill已经被勾选如果没有手动勾上再发指令。3.3 WorkBuddy里通过skill管理器安装WorkBuddy是一个把多种AI工具整合到一个工作流里的桌面应用它也内置了skill管理能力而且做得比命令行工具更“傻瓜化”。安装superpowers只需要一条命令wb skill add superpowers执行完之后WorkBuddy会自动把superpowers相关skill注册到它的skill仓库。你可以继续执行wb skill list查看已安装的skill列表确认superpowers在里面。如果你拿到的WorkBuddy版本界面化程度比较高也可以在设置面板里找到“Skills”或“技能管理”入口点进去搜索“superpowers”再点安装效果一样。WorkBuddy这种管理器模式的好处是它会自动处理依赖和路径问题基本不会遇到手动clone时那种“放错目录”的低级错误。不过要注意WorkBuddy目前覆盖的任务类型更偏向工作流编排如果用它的场景主要是简单的问答和内容生成那superpowers里偏软件开发的那套流程未必会触发。这个不是安装问题而是工具定位差异不用强求。4. 装完之后它到底能干哪些事核心能力拆解安装只是开始更关键的是搞清楚superpowers带来了哪些新能力以及什么时候会触发这些能力。我以目前使用频率最高的几个核心skill为例拆开讲讲。4.1 需求澄清别让AI拿到需求就开写这是superpowers里我认为最有价值的一个skill名字叫Dr. Bones它的核心逻辑就是在AI动手写代码之前强制先做需求澄清。触发机制很简单当你给AI一个开发任务时这个skill会让AI先停下来以“需求分析师”的身份向你确认问题比如目标用户是谁、现有代码里有没有类似实现、边界条件是什么。我曾经用一个真实的small项目测试过让它给一个积分系统加上“过期积分清零”功能。没有superpowers的时候AI直接开写结果漏掉了“积分过期前30天要提醒用户”这个细节装了superpowers之后它会主动追问“积分清零前是否需要预警预警渠道是什么”这几个问题直接避免了返工。这个skill对你的要求是当AI开始提问时耐心回答别嫌烦。很多程序员习惯了AI秒回代码突然被反问会不适应。但你多答几轮之后会发现澄清完再开工的效率远高于边写边改。4.2 TDD工作流从“先写码”到“先写测试”TDDTest-Driven Development测试驱动开发是superpowers的另一个重头戏。它的流程非常清晰先写一个会失败的测试、运行测试确认失败、再写最小实现让测试通过、最后重构。这套流程在superpowers里被封装成了一个标准skill叫TDD。使用的时候你只要告诉AI“用TDD方式实现某某功能”它就会严格按红-绿-重构的节奏来推进。实测下来最大的改变不是测试覆盖率变高了而是AI生成的代码结构明显更干净因为它每写一段都要先想测试怎么描述这个行为这逼着它把逻辑拆得更合理。## 用户故事 作为一个用户我希望重置密码时能校验新旧密码不同。 ## 任务要求 请用TDD流程实现上述功能。一旦对话中出现类似意图AI就会进入TDD模式先创建测试文件运行看到红色失败再写实现看到绿色通过然后停下来问你“是否需要重构”。这个过程对评审代码的人来说非常友好因为每一步都有测试用例佐证不是凭感觉说“写完了”。4.3 子代理与任务并行把大任务切成流水线用过AI编程的人应该都遇到过这种场景任务一复杂AI就开始“精神分裂”做着做着忘了开头的要求。superpowers里有专门的技能来处理这个问题思路是引入子代理概念把一个大任务拆成设计、实现、测试、审查等多个环节每个环节由独立的子代理完成。打个比方相当于你从一个全能杂工升级成了包工头手下有专门画图纸的设计师、专门垒墙的瓦工、专门验收的质检员。设计代理产出方案实现代理照着方案写码测试代理负责跑测试验证审查代理最后把关每一环都有明确职责不会互相干扰。实际使用的时候你可以在skill的配置里指定子代理的数量和职责比如“开两个子代理一个写实现一个写测试”。这个能力特别适合那种“一次性修改多个模块”的重构任务把文件拆给不同子代理并行处理整体速度是肉眼可见的提升。当然它对模型上下文窗口的要求也更高如果你的模型本身Token上限不大建议控制在两三个子代理以内。4.4 文件监视与自动修复测试挂了它自己会修还有一个让我觉得“真香”的能力是文件监视和自动修复。以前用AI生成代码最怕的就是它跑完自己说“写好了”结果测试一跑全是红。superpowers里有一个skill专门处理这件事它会监视项目文件的变化一旦发现测试失败会自动读取失败信息定位到相关代码然后尝试修复并重新跑测试。这个机制会把“AI写代码”变成“AI写代码并保证测试通过”。我在一个Python项目上实测过故意让它改一个导出函数结果它把参数顺序写错了测试当场红掉。如果是裸的Codex CLI它可能根本不知道测试挂了继续等下一个指令。而superpowers的自动修复流程会自动介入先看报错信息定位到函数签名改回正确顺序再跑一次测试直到绿了才回来汇报“已完成”。这个过程不需要我输入任何额外指令它自己就把闭环跑完了。需要提醒的是文件监视功能对IDE或编辑器有要求最好是开启了自动保存的项目不然文件没落盘监视器也不会触发。另外如果测试非常慢或者依赖外部服务自动修复流程可能会频繁重试这时候建议在skill配置里把超时时间调短免得长时间卡住。5. 常见问题与避坑实录装不上、不生效怎么排查使用过程中总会遇到各种幺蛾子我把碰到过的、以及身边朋友反馈过的高频问题整理了一张排查表基本覆盖了大多数安装和使用阶段的问题。5.1 安装问题速查表现象可能原因解决办法执行npx安装时报错node版本太低或网络受限升级node到18换源或稍后再试安装成功但AI没有变化skill目录放错位置确认对应工具的skill加载路径重新放置对话中AI从不反问该skill不支持当前模型换更强的模型或检查skill描述是否被正确加载测试失败但AI不自动修复文件监视未开启开启项目自动保存检查对应skill是否激活装了之后代码风格反而变乱skill配置和项目规范冲突在skill配置中补充项目级AGENTS.md覆盖默认规则WorkBuddy执行wb命令报找不到命令wb命令不在PATH中重启终端或用全路径执行或从界面操作这张表不能穷尽所有问题但大多数刚上手的人遇到的问题都集中在这几个方向。如果表格里没有你的情况建议先做一次基础排查往下看。5.2 排查思路从日志到权限一步步来我自己的排查习惯是按“位置对不对、版本新不新、模型强不强、权限够不够”四步来走。位置对不对就是确认skill文件有没有放到工具实际会扫描的目录。这里有个笨办法你把skill目录的名字改错一个字母看AI是不是立刻“变傻”是的话就说明路径生效只是内容有问题这个方法我用了好多次比翻文档快得多。版本新不新说的是AI编程助手本身和superpowers仓库的更新节奏。这个项目迭代很频繁可能上周的安装方式这周就变了遇到问题先pull一遍最新代码或者重新跑一次npx安装经常能解决。模型强不强也关键。superpowers的流程引导能力依赖模型的理解能力如果你用的是很老的模型它可能压根看不出SKILL.md里的引导指令。我实测下来能力弱的模型装了superpowers之后表现提升有限它更像“读不懂说明书”的新员工你给再好的手册他也发挥不出来。权限够不够是很多人忽略的。安装脚本要写~/.codex或.trae这类隐藏目录如果终端运行时的用户权限不足可能会静默失败——看起来执行成功了实际上文件根本没写进去。处理方法是加sudo的时候谨慎一点更推荐先检查目录归属再决定权限策略不要盲目用管理员权限跑所有命令。5.3 我自己踩过的三个坑第一个坑是装错目录。我当时在Codex CLI下面安装教程里写的是~/.codex/skills我一疏忽装到了项目的.codex/skills下。因为Codex会默认加载用户级skill目录项目级目录只在特定配置下才会被读取结果就是AI完全没有反应我还以为是模型问题折腾了很久才发现。第二个坑是期望太高以为装了superpowers就能“一键写好整个项目”。实际上它的能力边界很清晰它管的是工作流和流程约束不是替你决策需求和设计架构。如果你项目本身的模块划分和接口设计一塌糊涂superpowers救不了你顶多让代码在烂结构里保持整洁。第三个坑是同时装了多个来源的skill导致冲突。有次我在Trae里既装了插件版的superpowers又手动clone了一份到.trae/skills结果同一个skill被加载了两份AI反而不知道听谁的。解决方案很简单只用一种安装方式插件和手动目录二选一别混着来。6. 使用心得怎么让superpowers真正变成你的“超能力”工具装好只是第一步用得好不好差别很大。我从自己几个项目的实际体验出发聊几个真正影响使用效果的细节。6.1 从一个中等规模的项目开始别拿玩具项目练手很多人第一次装完superpowers喜欢拿“写个贪吃蛇”这种小玩具来试结果发现AI还是三下五除二写完了没感受到太多变化就觉得这东西没用。这不是它没用而是任务太简单触发不了复杂流程。稍微复杂一点的项目比如一个带登录鉴权的Web API、一个数据迁移脚本或者一个有历史包袱的遗留系统重构这些场景下superpowers的价值才会真正体现出来。有一次我让它帮我给一个老项目的用户模块做接口分层重构它先是通过需求澄清搞清楚了现有代码的分层风格然后用TDD流程给每个接口补了测试再通过子代理并行改造整个过程比我预想的要有条理得多。玩具项目体现不出这种优势。6.2 用AGENTS.md或CLAUDE.md给superpowers做“本地化适配”superpowers是通用技能包它不知道你项目的特殊性。所以装完之后强烈建议在项目根目录写一个AGENTS.mdClaude Code下叫CLAUDE.md本质一样在里面描述项目技术栈、目录结构、代码风格约定这些信息。这样做的效果是当superpowers的skill被激活时AI同时能看到项目规范和通用工作流它就能按照你的项目语境来执行那些流程。比如你们团队约定接口返回格式统一是{code, message, data}你在AGENTS.md里写清楚AI在写新接口的时候就会自动遵守而不需要你每次对话都提醒一次。我自己的项目里AGENTS.md和superpowers是绑定在一起用的少了任何一个效果都打折扣。6.3 什么时候不该用superpowers最后说点反直觉的有些场景我真的不建议开superpowers。比如你只是临时改个配置文件、写个一次性脚本、或者调一个CSS样式这种任务开superpowers反而碍事因为AI会先“不厌其烦”地做需求澄清和流程确认把一个30秒能搞定的事拖成三分钟。我的做法是分场景使用在核心业务代码、需要长期维护的模块里全程开着superpowers让它按TDD和需求澄清的流程走在处理临时性、探索性任务时我直接关掉或绕过相关skill让AI像普通模式那样快速给结果。superpowers的核心不是“让AI变快”而是“让AI变稳”稳的代价是多了几轮确认和测试环节你要是把每一次交互都当一次性买卖那它确实是负担你要是把这些代码当长期资产那它就非常划算。另外一个小技巧如果你希望某些项目默认不用superpowers可以直接把skills目录从那个项目里移走或者通过工具的配置项关闭全球skill加载。这个切换不需要重装改个目录名就能临时禁用实测下来很灵活。我自己现在同时维护着三四个项目有的项目装了superpowers有的没装切换起来就是目录级的操作不折腾。 Superpowers技能包安装实战：从Codex CLI到Trae CN与WorkBuddy
1. superpowers到底是啥为什么最近AI编程圈都在装它最近“superpowers”这个词在AI编程圈子里刷屏的频率直线上升。不管是codex cli安装superpowers、trae work cn安装superpowers skill还是workbuddy安装skill superpowers这些搜索热词背后指向的都是同一个东西——一套开源的、专门给AI编程助手用的“技能包”。先说明白superpowers不是一个新的模型也不是一个IDE更不是某个公司的商业产品。它本质上是一堆结构化的markdown文件也就是“skill”用来告诉AI编程助手“遇到什么情况该按什么流程干活”。你可以把它理解为给AI助手写的岗位手册让它在编程的时候不再是想到哪写到哪而是按照一套成熟的工作流来推进比如需求澄清、测试先行、代码审查、自动修复这些全部被封装成标准流程AI在对应场景下会自动调用。它解决的实际问题非常具体。用过AI编程助手的人多少都有体会让AI写个函数它一上来就噼里啪啦生成几百行结果连需求都没问清楚让AI重构代码它改完之后测试全挂自己还浑然不知一个稍微复杂的任务交给它做到一半逻辑就乱了前后矛盾。这些问题不是模型能力不够而是缺少一套约束AI行为的工作流。superpowers就是把这个缺失的流程补上。适合谁来装三类人最值得折腾一是正在用Codex CLI、Trae、Claude Code这类工具做日常开发的人二是想试试TDD测试驱动开发但一直没有系统落地的人三是团队里想把AI辅助编码规范化、减少“AI改坏代码”事故的人。当然如果你只是偶尔让AI写个脚本那装不装差别不大它更适合那些把AI当成正经结对编程伙伴的人。2. 安装前先搞清楚skill到底是怎么生效的很多人一上来就照着教程敲命令结果安装完发现AI毫无反应大概率是因为没搞明白skill的运行机制。这里值得花点时间把底层逻辑讲清楚。2.1 一句话解释skill机制给AI的说明书AI编程助手本身是一个通用模型它虽然会写代码但它不知道你的项目规范、不知道你偏爱什么风格、不知道遇到冲突的时候该优先保测试还是保功能。skill就是用来补上这一块的。一个skill通常是一个文件夹里面包含SKILL.md主文件和若干辅助文档。SKILL.md的开头会有frontmatter字段写明这个skill的名称、描述、适用场景AI会通过描述来“判断”当前任务是否该激活这个skill。激活之后整个文件里的流程指引、代码示例、注意事项都会作为上下文注入给AIAI就会按这套规则来执行任务。这个过程完全由模型理解markdown内容来驱动不涉及什么编译或运行所以安装的实质就是把文件放到AI能看到的位置。2.2 主流工具的skill目录和配置差异目前支持skill机制的编程助手越来越多但各自的加载路径并不完全一样。我整理了常见的几个工具skill加载位置说明Claude Code项目下.claude/skills/或用户级~/.claude/skills/最早推广skill机制的工具生态文档最全Codex CLI~/.codex/skills/或项目下.codex/skills/OpenAI的CLI工具逐步完善skill能力Trae Work CN工作区.trae/skills/或通过插件市场安装国内可用版本安装路径类似Claude Code的方案WorkBuddy通过自带skill管理命令安装它对skill做了一层管理器安装更傻瓜化这里要特别提醒这个领域变化非常快表格里的路径是写这篇文章时常见的情况你安装之前最好去对应工具的官方文档里确认一遍或者直接在项目里找找有没有.claude、.codex、.trae这些目录。很多教程失效就是因为路径变了这不奇怪生态早期就是这样。2.3 安装前的环境检查和准备清单不管你用哪个工具下面几项建议先确认好可以省掉后面一大堆问题。Node.js环境很多安装脚本是npx方式执行的node版本不要太老建议18以上。命令行敲node -v确认。git环境如果选择源码clone方式装git是必须的git --version确认。工具版本你的CLI工具尽量更新到较新版本老版本可能不认SKILL.md的frontmatter格式。网络连通性安装过程要访问GitHub仓库或npm registry确保网络通畅。先建一个测试项目不要一上来就在公司老项目里装先用空目录试一遍流程确认没问题再上真实项目。说实话装superpowers本身不复杂绝大部分问题都出在这些前置条件上。我之前遇到过装完完全没效果的情况排查了半天结果发现是Codex CLI版本太老压根不支持skill目录白白浪费一个小时。3. 实操三条主流的superpowers安装路径现在进入正题。我分别讲Codex CLI、Trae Work CN、WorkBuddy三个场景下的安装方法你可以根据自己的主力工具选择对应章节不用全看。3.1 Codex CLI下安装superpowers skillCodex CLI是目前很多人主用的终端AI编程工具在它下面装superpowers主要有两种方式一种是官方推荐的自动安装脚本一种是手动clone仓库两种我都试过分别说下。自动安装方式比较简单在项目目录下执行# 进入你的项目目录 cd your-project # 执行superpowers官方安装脚本 npx superpowerslatest install --target codex这个命令会把superpowers仓库里的skills目录放到Codex CLI的全局skill目录下通常位置是~/.codex/skills/。执行完后可以用ls ~/.codex/skills检查一下能看到superpowers相关的文件夹就说明放对位置了。如果你更喜欢手动管理也可以直接clone仓库然后自己拷目录# 拉取superpowers仓库 git clone https://github.com/obra/superpowers.git /tmp/superpowers # 把skills目录复制到Codex的skill目录 mkdir -p ~/.codex/skills cp -r /tmp/superpowers/skills/* ~/.codex/skills/ # 顺便确认一下 ls ~/.codex/skills手动方式的好处是你能清楚知道每个文件在哪儿出了问题也好排查缺点就是后续要更新的话得自己再拉一次仓库。装完之后在Codex CLI里直接开始对话就行不需要重启。你可以先输入一个简单的任务比如“帮我写一个计算斐波那契数列的函数”如果superpowers生效了AI会先问你需求细节而不是直接甩代码。这一步能快速验证是否装成功。3.2 Trae Work CN下安装superpowers skillTrae是字节出的AI IDE国内版本叫Trae Work CN很多人叫它Trae CN。在这个环境下装superpowers可以走IDE的插件系统也可以直接往工作区里放skill文件。从插件市场安装是最省事的方式打开Trae进入扩展市场搜索“superpowers”或“skill”找到对应的skill包点击安装然后重启IDE让它加载。这种方式对不熟悉命令行的朋友最友好图形化界面点到就行。如果你更想自己控制版本可以手动在工作区创建skill目录# 在你的项目根目录执行 mkdir -p .trae/skills # 从仓库只拷贝superpowers的skill子目录 git clone --depth 1 https://github.com/obra/superpowers.git /tmp/superpowers cp -r /tmp/superpowers/skills/* .trae/skills/ # 验证 ls .trae/skills注意Trae的项目级配置是跟着工作区走的.trae目录建议加进你的版本管理这样团队里其他人clone代码后也能自动加载同一套skill这件事对团队协作特别有用。另外Trae内部的AI助手在对话时你可以在输入框附近找到一个类似“引用技能”的按钮确认相关的superpowers skill已经被勾选如果没有手动勾上再发指令。3.3 WorkBuddy里通过skill管理器安装WorkBuddy是一个把多种AI工具整合到一个工作流里的桌面应用它也内置了skill管理能力而且做得比命令行工具更“傻瓜化”。安装superpowers只需要一条命令wb skill add superpowers执行完之后WorkBuddy会自动把superpowers相关skill注册到它的skill仓库。你可以继续执行wb skill list查看已安装的skill列表确认superpowers在里面。如果你拿到的WorkBuddy版本界面化程度比较高也可以在设置面板里找到“Skills”或“技能管理”入口点进去搜索“superpowers”再点安装效果一样。WorkBuddy这种管理器模式的好处是它会自动处理依赖和路径问题基本不会遇到手动clone时那种“放错目录”的低级错误。不过要注意WorkBuddy目前覆盖的任务类型更偏向工作流编排如果用它的场景主要是简单的问答和内容生成那superpowers里偏软件开发的那套流程未必会触发。这个不是安装问题而是工具定位差异不用强求。4. 装完之后它到底能干哪些事核心能力拆解安装只是开始更关键的是搞清楚superpowers带来了哪些新能力以及什么时候会触发这些能力。我以目前使用频率最高的几个核心skill为例拆开讲讲。4.1 需求澄清别让AI拿到需求就开写这是superpowers里我认为最有价值的一个skill名字叫Dr. Bones它的核心逻辑就是在AI动手写代码之前强制先做需求澄清。触发机制很简单当你给AI一个开发任务时这个skill会让AI先停下来以“需求分析师”的身份向你确认问题比如目标用户是谁、现有代码里有没有类似实现、边界条件是什么。我曾经用一个真实的small项目测试过让它给一个积分系统加上“过期积分清零”功能。没有superpowers的时候AI直接开写结果漏掉了“积分过期前30天要提醒用户”这个细节装了superpowers之后它会主动追问“积分清零前是否需要预警预警渠道是什么”这几个问题直接避免了返工。这个skill对你的要求是当AI开始提问时耐心回答别嫌烦。很多程序员习惯了AI秒回代码突然被反问会不适应。但你多答几轮之后会发现澄清完再开工的效率远高于边写边改。4.2 TDD工作流从“先写码”到“先写测试”TDDTest-Driven Development测试驱动开发是superpowers的另一个重头戏。它的流程非常清晰先写一个会失败的测试、运行测试确认失败、再写最小实现让测试通过、最后重构。这套流程在superpowers里被封装成了一个标准skill叫TDD。使用的时候你只要告诉AI“用TDD方式实现某某功能”它就会严格按红-绿-重构的节奏来推进。实测下来最大的改变不是测试覆盖率变高了而是AI生成的代码结构明显更干净因为它每写一段都要先想测试怎么描述这个行为这逼着它把逻辑拆得更合理。## 用户故事 作为一个用户我希望重置密码时能校验新旧密码不同。 ## 任务要求 请用TDD流程实现上述功能。一旦对话中出现类似意图AI就会进入TDD模式先创建测试文件运行看到红色失败再写实现看到绿色通过然后停下来问你“是否需要重构”。这个过程对评审代码的人来说非常友好因为每一步都有测试用例佐证不是凭感觉说“写完了”。4.3 子代理与任务并行把大任务切成流水线用过AI编程的人应该都遇到过这种场景任务一复杂AI就开始“精神分裂”做着做着忘了开头的要求。superpowers里有专门的技能来处理这个问题思路是引入子代理概念把一个大任务拆成设计、实现、测试、审查等多个环节每个环节由独立的子代理完成。打个比方相当于你从一个全能杂工升级成了包工头手下有专门画图纸的设计师、专门垒墙的瓦工、专门验收的质检员。设计代理产出方案实现代理照着方案写码测试代理负责跑测试验证审查代理最后把关每一环都有明确职责不会互相干扰。实际使用的时候你可以在skill的配置里指定子代理的数量和职责比如“开两个子代理一个写实现一个写测试”。这个能力特别适合那种“一次性修改多个模块”的重构任务把文件拆给不同子代理并行处理整体速度是肉眼可见的提升。当然它对模型上下文窗口的要求也更高如果你的模型本身Token上限不大建议控制在两三个子代理以内。4.4 文件监视与自动修复测试挂了它自己会修还有一个让我觉得“真香”的能力是文件监视和自动修复。以前用AI生成代码最怕的就是它跑完自己说“写好了”结果测试一跑全是红。superpowers里有一个skill专门处理这件事它会监视项目文件的变化一旦发现测试失败会自动读取失败信息定位到相关代码然后尝试修复并重新跑测试。这个机制会把“AI写代码”变成“AI写代码并保证测试通过”。我在一个Python项目上实测过故意让它改一个导出函数结果它把参数顺序写错了测试当场红掉。如果是裸的Codex CLI它可能根本不知道测试挂了继续等下一个指令。而superpowers的自动修复流程会自动介入先看报错信息定位到函数签名改回正确顺序再跑一次测试直到绿了才回来汇报“已完成”。这个过程不需要我输入任何额外指令它自己就把闭环跑完了。需要提醒的是文件监视功能对IDE或编辑器有要求最好是开启了自动保存的项目不然文件没落盘监视器也不会触发。另外如果测试非常慢或者依赖外部服务自动修复流程可能会频繁重试这时候建议在skill配置里把超时时间调短免得长时间卡住。5. 常见问题与避坑实录装不上、不生效怎么排查使用过程中总会遇到各种幺蛾子我把碰到过的、以及身边朋友反馈过的高频问题整理了一张排查表基本覆盖了大多数安装和使用阶段的问题。5.1 安装问题速查表现象可能原因解决办法执行npx安装时报错node版本太低或网络受限升级node到18换源或稍后再试安装成功但AI没有变化skill目录放错位置确认对应工具的skill加载路径重新放置对话中AI从不反问该skill不支持当前模型换更强的模型或检查skill描述是否被正确加载测试失败但AI不自动修复文件监视未开启开启项目自动保存检查对应skill是否激活装了之后代码风格反而变乱skill配置和项目规范冲突在skill配置中补充项目级AGENTS.md覆盖默认规则WorkBuddy执行wb命令报找不到命令wb命令不在PATH中重启终端或用全路径执行或从界面操作这张表不能穷尽所有问题但大多数刚上手的人遇到的问题都集中在这几个方向。如果表格里没有你的情况建议先做一次基础排查往下看。5.2 排查思路从日志到权限一步步来我自己的排查习惯是按“位置对不对、版本新不新、模型强不强、权限够不够”四步来走。位置对不对就是确认skill文件有没有放到工具实际会扫描的目录。这里有个笨办法你把skill目录的名字改错一个字母看AI是不是立刻“变傻”是的话就说明路径生效只是内容有问题这个方法我用了好多次比翻文档快得多。版本新不新说的是AI编程助手本身和superpowers仓库的更新节奏。这个项目迭代很频繁可能上周的安装方式这周就变了遇到问题先pull一遍最新代码或者重新跑一次npx安装经常能解决。模型强不强也关键。superpowers的流程引导能力依赖模型的理解能力如果你用的是很老的模型它可能压根看不出SKILL.md里的引导指令。我实测下来能力弱的模型装了superpowers之后表现提升有限它更像“读不懂说明书”的新员工你给再好的手册他也发挥不出来。权限够不够是很多人忽略的。安装脚本要写~/.codex或.trae这类隐藏目录如果终端运行时的用户权限不足可能会静默失败——看起来执行成功了实际上文件根本没写进去。处理方法是加sudo的时候谨慎一点更推荐先检查目录归属再决定权限策略不要盲目用管理员权限跑所有命令。5.3 我自己踩过的三个坑第一个坑是装错目录。我当时在Codex CLI下面安装教程里写的是~/.codex/skills我一疏忽装到了项目的.codex/skills下。因为Codex会默认加载用户级skill目录项目级目录只在特定配置下才会被读取结果就是AI完全没有反应我还以为是模型问题折腾了很久才发现。第二个坑是期望太高以为装了superpowers就能“一键写好整个项目”。实际上它的能力边界很清晰它管的是工作流和流程约束不是替你决策需求和设计架构。如果你项目本身的模块划分和接口设计一塌糊涂superpowers救不了你顶多让代码在烂结构里保持整洁。第三个坑是同时装了多个来源的skill导致冲突。有次我在Trae里既装了插件版的superpowers又手动clone了一份到.trae/skills结果同一个skill被加载了两份AI反而不知道听谁的。解决方案很简单只用一种安装方式插件和手动目录二选一别混着来。6. 使用心得怎么让superpowers真正变成你的“超能力”工具装好只是第一步用得好不好差别很大。我从自己几个项目的实际体验出发聊几个真正影响使用效果的细节。6.1 从一个中等规模的项目开始别拿玩具项目练手很多人第一次装完superpowers喜欢拿“写个贪吃蛇”这种小玩具来试结果发现AI还是三下五除二写完了没感受到太多变化就觉得这东西没用。这不是它没用而是任务太简单触发不了复杂流程。稍微复杂一点的项目比如一个带登录鉴权的Web API、一个数据迁移脚本或者一个有历史包袱的遗留系统重构这些场景下superpowers的价值才会真正体现出来。有一次我让它帮我给一个老项目的用户模块做接口分层重构它先是通过需求澄清搞清楚了现有代码的分层风格然后用TDD流程给每个接口补了测试再通过子代理并行改造整个过程比我预想的要有条理得多。玩具项目体现不出这种优势。6.2 用AGENTS.md或CLAUDE.md给superpowers做“本地化适配”superpowers是通用技能包它不知道你项目的特殊性。所以装完之后强烈建议在项目根目录写一个AGENTS.mdClaude Code下叫CLAUDE.md本质一样在里面描述项目技术栈、目录结构、代码风格约定这些信息。这样做的效果是当superpowers的skill被激活时AI同时能看到项目规范和通用工作流它就能按照你的项目语境来执行那些流程。比如你们团队约定接口返回格式统一是{code, message, data}你在AGENTS.md里写清楚AI在写新接口的时候就会自动遵守而不需要你每次对话都提醒一次。我自己的项目里AGENTS.md和superpowers是绑定在一起用的少了任何一个效果都打折扣。6.3 什么时候不该用superpowers最后说点反直觉的有些场景我真的不建议开superpowers。比如你只是临时改个配置文件、写个一次性脚本、或者调一个CSS样式这种任务开superpowers反而碍事因为AI会先“不厌其烦”地做需求澄清和流程确认把一个30秒能搞定的事拖成三分钟。我的做法是分场景使用在核心业务代码、需要长期维护的模块里全程开着superpowers让它按TDD和需求澄清的流程走在处理临时性、探索性任务时我直接关掉或绕过相关skill让AI像普通模式那样快速给结果。superpowers的核心不是“让AI变快”而是“让AI变稳”稳的代价是多了几轮确认和测试环节你要是把每一次交互都当一次性买卖那它确实是负担你要是把这些代码当长期资产那它就非常划算。另外一个小技巧如果你希望某些项目默认不用superpowers可以直接把skills目录从那个项目里移走或者通过工具的配置项关闭全球skill加载。这个切换不需要重装改个目录名就能临时禁用实测下来很灵活。我自己现在同时维护着三四个项目有的项目装了superpowers有的没装切换起来就是目录级的操作不折腾。