superpowers这个词乍看像个中二少年给项目起的名字但只要你最近在折腾 Codex CLI、Trae 这类 AI 编程工具大概率会刷到它。它不是某个语言框架也不是什么新出的 IDE而是一套专门给 AI 编程助手用的技能集skills目标很直接让 AI 编码从能跑变成可靠地跑完一个完整任务。我先说结论如果你已经受够了 AI 助手写代码时那种给了需求就闷头输出、跑挂了再修、修不完就摆烂的状态Superpowers 值得你花一个下午装起来试试。它适合已经在用 AI 写代码的开发者尤其是每天在终端里跟 Codex CLI、Claude Code 这类工具打交道的人。今天这篇就把它的原理、安装、实际使用和踩坑记录一次性讲清楚。1. 这套技能集到底解决了什么问题1.1 从对话式写码到任务式交付的转变先聊个背景。用过 Codex CLI 或者直接在终端里调 AI 写代码的朋友应该都有这种感觉AI 处理单点问题很强比如帮我写个 debounce 函数这个报错怎么看但一旦你说把这个模块重构一下处理好边界条件再加上测试它就容易飘。要么理解错需求要么只改了表面代码没动深层逻辑要么试了几次发现太复杂直接给你个半成品。问题出在哪不是模型能力不够而是交互方式不对。普通对话式编程里AI 没有一套固定的工作方法它是走一步看一步的。碰到复杂任务它既不会先把需求拆清楚也不会在动手前先审视一下现有代码更不会主动想到要跑测试来验证。说白了AI 不缺知识缺的是流程。Superpowers 这套技能集就是来解决这个问题的。它给 AI 助手预设了一套结构化的工作技能每个技能都是一份精心设计的提示词模板告诉 AI当你接到这类任务时应该按什么步骤执行。比如接到一个开发任务AI 会先启动任务分解技能把需求拆解成可执行的步骤清单然后启动代码分析技能去读现有代码写代码时走测试驱动流程最后用代码审查技能自查一遍。这等于给 AI 立了一套 SOP不再是东一榔头西一棒子。1.2 为什么偏偏是 Codex CLI 这个生态你可能会问现在各家 AI IDE 都在做 Agent 能力为什么这套技能集主要在 Codex CLI 和 Trae 里火我的理解是这类终端型工具或者支持 skill 机制的编辑器本质上给了用户一个改造 AI 行为的入口。在 Codex CLI 里技能是以 Markdown 文件形式存放在指定目录下的AI 在回答时会根据你的指令自动加载对应的技能文件。这就像给 AI 装了一本本操作手册它接到任务时不是凭感觉发挥而是先翻手册、按手册执行。Superpowers 把一堆实战验证过的操作手册打包好装进去就能用省得自己从零琢磨提示词。这个设计思路其实跟 Anthropic 提出的 Agent Skills 概念很接近但 Superpowers 更聚焦编程实战技能颗粒度更细。2. 核心设计拆解技能包里面到底装了什么2.1 技能集的整体组织方式Superpowers 不是单一文件而是一个技能集目录每个技能对应一个文件夹里面通常包含一个或多个 Markdown 文件。文件名就是技能的名字内容则是技能的执行指令。AI 加载技能后会按文件里的步骤行动。这种组织方式有个很实际的好处按需加载。不是把所有指令都塞进上下文而是遇到什么类型的任务就加载对应的技能文件。这样既省 token又不会让 AI 因为指令太多而精神分裂。我用了几个星期体感最大的变化是 AI 的行为变得有章法了它会在动手前先把任务拆好、把风险列出来然后再开始写代码。技能包里的技能不是随意堆砌的它们构成了一条完整的开发工作流收到需求后先拆解任务明确目标和边界动手前先读代码、做影响面分析开发时遵循测试优先TDD策略完成后跑自查、审查代码质量遇到报错时系统化排查而不是盲目修。2.2 几个核心技能逐一拆解以我实际用下来的感受有几个技能属于用了就回不去的。任务拆解技能它要求 AI 收到复杂指令后先不急着写代码而是把任务拆成若干个可独立验证的子任务并按照前置依赖排序。比如你让 AI给现有项目加一个用户登录模块它会先拆分出设计数据表、写认证逻辑、做 Session 管理、写测试用例等步骤然后按顺序执行。这个技能的价值在于它最大程度避免了一上来就写一堆代码结果方向跑偏的灾难。测试优先TDD技能这可能是整个技能集里最反直觉但最有效的一个。它要求 AI 在写业务代码之前先把测试用例写好。注意这里不是简单的写完代码顺便写个测试而是先写一个会失败的测试然后写代码让测试通过。这逼着 AI 把完成的定义具体化了——什么叫功能做好了测试全绿才算。我自己试过几次加了这道工序之后AI 交付的代码质量问题明显减少。代码审查技能在 AI 完成一轮开发后它会启动一个自查流程逐行检查自己的代码找出潜在 bug、遗漏的边界条件、不合理的设计。这个技能有点像让 AI 回头再看一眼实际用下来能拦截不少低级错误。Bug 排查技能碰上疑难杂症时AI 会按照复现问题 → 定位根因 → 验证修复 → 补充回归测试的路径来处理。跟普通对话模式里那种瞎试完全不一样它会更像有经验的工程师做事。2.3 为什么这种流程化设计比单纯堆提示词更可靠这里多说一句底层逻辑。很多人都试过自己写提示词比如在 system prompt 里写你是一个资深工程师请一步一步思考。这种简单提示在实际使用中之所以不稳定是因为一步一步思考只是一句口号AI 并不知道针对当前这个具体技术任务哪几步才算是有效步骤。Superpowers 的做法是把步骤具体化、模板化了。它不泛泛地说你要先分析再动手而是规定在改动超过 5 个文件的重构任务里必须先将依赖关系列出来按从底层到上层的顺序逐个修改且每完成一个模块都要跑对应测试。这类颗粒度的指令是模型真正能执行的、稳定的行为约束。这跟给新手一份待办清单和告诉新手你加油之间的差别是一样的。3. 安装与快速配置两个主流工具的实际操作3.1 在 Codex CLI 里安装 Superpowers先说 Codex CLI。安装之前请确保你的 Codex CLI 已经更新到较新版本旧版本可能不支持 skill 的自动加载机制。详细的步骤是这样的# 1. 找到 Codex CLI 的配置目录 cd ~/.codex # 2. 克隆或下载 superpowers 技能集 git clone https://github.com/your-source/superpowers.git superpowers # 3. 确认目录结构 ls -la ~/.codex/superpowers/下载完成之后还要确认 Codex CLI 的配置文件一般在~/.codex/config.toml里设置了技能目录的加载路径。如果用的是支持 AGENTS.md 约定的版本也可以在项目的AGENTS.md文件里添加一行声明## Skills 请在执行任务前参考 ~/.codex/superpowers/ 目录下的技能定义尤其注意任务拆解、测试优先与代码审查技能。上面这段声明的作用是告诉 Codex CLI每次处理当前项目时记得把 Superpowers 技能集纳入参考。不写这个声明的话AI 可能根本不会主动去翻技能目录。配置完成以后你可以先跑一个简单任务验证技能是否生效。比如让 Codex CLI 写一个只有两个数字相加的函数但明确要求先写测试再写实现。如果它老老实实先创建了一个测试文件再补上实现说明技能加载成功了。3.2 在 Trae Work CN 中安装 SkillTrae Work CN 的 skill 安装方式更适合习惯可视化操作的人。它的机制是在项目配置或人设设定里指定 skill 的存放路径AI 在回答时会读取这些 skill 的说明文件。操作流程大致是打开 Trae进入项目设置找到技能或扩展技能相关的面板选择导入技能将下载好的 Superpowers 技能文件夹导入导入后可以在技能列表里看到所有技能项确认它们处于启用状态回到对话窗口简单问一句你会怎么处理一个包含数据库迁移和接口开发的任务看看它是否按照技能集里定义的步骤回答。如果回答里出现了先拆解任务、再评估影响面、然后写测试这类结构化描述那就说明技能已经生效。3.3 配置选项与个性化调整装好之后我建议你先别急着直接用默认配置花几分钟理解几个关键设置项。一是技能加载的优先级。如果多个技能文件同时对同一个场景给出指令AI 可能不知道听谁的。Superpowers 内部一般会通过文件名编号或者AGENTS.md的引用顺序来定义优先级改配置的时候别让自定义技能跟它冲突。二是自定义项目的补充指令。Superpowers 的技能是通用性的但你的项目可能有专属约定比如代码风格、禁止使用某个库、目录结构要求。这些应该写在自己项目的AGENTS.md里作为技能之上的更高优先级指令。我一般是这么安排的项目级规范AGENTS.md Superpowers 技能集 模型默认行为。这样既保证通用流程又保留了项目的特殊性。三是 token 控制。技能文件会在必要时被加载进上下文消耗 token。如果你用的是有上下文窗口限制的小模型建议只保留最常用的几个技能把不用的技能文件移出目录避免 AI 频繁加载无用指令白烧 token。4. 实操演示一次完整的任务复盘4.1 需求案例给一个待办应用加上归档功能为了让你直观看到装与不装的区别我拿一个真实任务来复盘。任务是给一个已有的命令行待办应用增加归档功能用户可以把已完成的待办放进归档列表归档后不再出现在主列表但可以随时查询。我把这个需求发给装了 Superpowers 的 Codex CLI它的处理过程大概是这样的。第一阶段它没有直接改代码而是先启动任务拆解技能输出了一份计划先读取现有数据结构确认待办项的状态字段在存储层增加归档状态修改列表查询逻辑默认过滤掉归档项新增一个归档查询命令为上述每个步骤补单元测试。第二阶段它开始逐个执行计划。在修改存储层之前它先写了测试验证新状态能否正确保存和读取测试跑通后再改业务代码。整个过程我没有干预它靠测试结果自行判断这一步完成了继续下一步。第三阶段全部完成后它启动代码审查技能复盘自己的改动并主动指出一个潜在问题查询归档列表时没有做排序可能导致输出顺序不稳定。然后它自己把这个修掉了。整个任务从开始到结束大约四分钟。我去 review 代码的时候发现结构清晰、注释到位、测试覆盖了正常路径和边界情况。这种交付质量在没用 Superpowers 之前我很少在 AI 编程助手上见到。4.2 案例对比同样的需求普通模式怎么翻车作为对照我在同一个项目里用普通对话模式重新提交了一遍同样需求假装没装过技能。AI 的反应是直接开写一口气改了存储层、业务层、命令层看起来挺齐全。但当我让它跑测试时发现两个问题旧的待办数据没有做迁移历史数据里没有归档状态字段读取时报错归档后主列表过滤条件写反了归档项依然显示未归档项反而被过滤掉了。这就是典型的没提前分析数据结构和兼容性导致的翻车。AI 一看需求就写代码压根没想到历史数据和边界条件。Superpowers 的任务拆解和测试优先技能恰好就是在用流程约束避开这两类问题。4.3 实操里的小技巧用了一段时间之后我总结出几个能让 superpowers 发挥最大效力的使用习惯。把大需求拆成几个明确的小指令发。虽然 Superpowers 自己有任务拆解能力但如果你能先把大方向说清楚它拆出来的子任务会更精准。我一般会这么下指令按标准流程为项目新增归档功能重点是迁移旧数据和过滤逻辑完成后跑全部测试。它就会按照技能集流程结合你给的提示推进。多用按标准流程这个触发词。Superpowers 的很多技能需要合适的触发条件才会激活你用按标准流程按技能定义执行这类表述能明显提高技能加载的概率。如果你不想每次都打字可以在项目的 AGENTS.md 里写死常规开发任务必须使用 superpowers 技能集效果等同。关键节点多让 AI 做总结。在完成一步后让它用 3-5 条要点说明改了什么、为什么这么改、有没有遗留风险。这一步能让你在 review 时省大劲也逼着 AI 梳理逻辑。5. 常见问题与排查技巧实录5.1 技能加载失败怎么办症状下了技能集但 AI 好像毫无反应行为跟以前一模一样。排查思路先确认技能目录路径是否被正确引用。Codex 的配置里如果没写路径AI 是找不到技能文件的。再看 AGENTS.md 的写法建议用绝对路径或者相对于项目根的路径别用~这种需要展开的符号。我见过不少案例是路径写错了技能文件压根没被读到。还有一种情况技能文件名里带有特殊字符导致解析异常。建议技能文件命名只用字母、数字、短横线别用空格和中文。5.2 token 消耗突然变大症状装完之后对话的 token 消耗明显上涨。这通常是 AI 每次都把所有技能文件读了一遍。解决方法是精简技能目录只保留当前项目用得上的技能。尤其是用第三方 API 转接服务跑模型的时候token 成本直接跟钱包挂钩该省就得省。5.3 技能行为不符合项目预期症状AI 遵循技能定义走得很死板比如非要先写测试但你只是想快速写个一次性脚本。这不是 bug是技能集的工作方式决定的。遇到这种情况可以在 AGENTS.md 里声明例外项比如临时脚本任务可以跳过测试优先流程。灵活性是这套体系最大的优势项目规范永远可以覆盖技能默认行为。5.4 版本更新带来的兼容问题症状升级 Codex CLI 或者更换模型后原来稳定的技能行为开始变异。不同模型对 Markdown 指令的遵循程度有差异强模型可能执行得很到位弱模型则可能忽略细节。另外某些模型的 System Prompt 里自带了任务处理方法论这跟技能集里的指令可能会有冲突。遇到这种情况建议查看模型供应商更新公告或者在提示词里特别说明以技能定义为准。6. 如何根据自己的场景微调技能6.1 技能文件改写的正确姿势Superpowers 的技能文件不是只读的你可以按需修改或新增。我自己的做法是把每次踩坑后总结出的新流程写成一个新技能文件放进技能目录。比如我负责的项目有大量数据库存储过程默认的任务拆解技能不会考虑到存储过程的依赖关系。我就新增了一个数据库变更技能规定 AI 在涉及数据库脚本修改时必须先查看所有引用该对象的存储过程列出影响清单再动手。这个小改造非常管用从此数据库变更类的任务出问题的概率大幅下降。改技能文件有个原则要守住指令措辞尽量无歧义宁可多写细节也不要让 AI 去猜。给 AI 的指令是检查所有引用该列的地方并逐个更新比注意联动影响好用一百倍。6.2 把团队规范融进去如果你在团队里推广这个技能集最划算的做法是把团队开发规范揉进技能定义。举个例子团队要求所有对外接口必须带版本号、必须写 OpenAPI 文档那就新增一个接口开发技能把这些要求写得清清楚楚。团队新成员用 AI 开发时AI 会替你把规范执行到位相当于团队的工程经验被固化成了 AI 的行为准则。我自己在团队里推过一次两周后收到的反馈是AI 生成的代码很懂规矩review 时省了很多口舌。这套东西本质上是把隐性知识显性化。6.3 调试技能文件时的小技巧改完技能文件建议先在简单任务上验证别直接上复杂需求。比如你改了代码审查技能先让它审查一个已知有 bug 的小函数看它能不能按新的要求找出问题。确认行为符合预期后再放回真实任务。另外建议给技能文件加版本号或者日期。改多了之后你不一定记得当前行为是哪一版技能定义出来的。加个版本号排查起来会省很多时间。7. 聊聊这套方案的边界与个人感受Superpowers 不是万能的。它解决的是AI 在复杂任务中行为不稳定的问题但它不能替你理解需求也不能弥补业务逻辑本身的混乱。如果你的需求描述本身就是一团糨糊再强的技能集也无能为力。它也不适合所有任务。快速写个一次性脚本、临时查个 API 用法、改个文案这些场景没必要走完整技能流反而显得笨重。技能集最适合的是有一定复杂度、需要多步骤完成、且后续要维护的代码任务。我个人最大的收获是它让我重新理解了 AI 编程助手的定位。以前我总把它当一个很聪明的结对程序员有事问一下、没事聊两句。用了 Superpowers 之后我更像是在带一个很有潜力但还不太懂规矩的新人我给它定好流程、立好规矩它负责执行得有板有眼。这个思维转变比工具本身更值钱。如果你打算入坑我的建议是先装好默认技能集跑一周什么也别改感受一下流程化开发带来的变化一周后再按自己的项目特点微调。那些网上流传的技能列表最佳实践都是别人项目的沉淀你的项目长什么样、团队约定是什么只有你自己试了才知道。 Superpowers技能集：让AI编程从“能跑”到“可靠交付”
superpowers这个词乍看像个中二少年给项目起的名字但只要你最近在折腾 Codex CLI、Trae 这类 AI 编程工具大概率会刷到它。它不是某个语言框架也不是什么新出的 IDE而是一套专门给 AI 编程助手用的技能集skills目标很直接让 AI 编码从能跑变成可靠地跑完一个完整任务。我先说结论如果你已经受够了 AI 助手写代码时那种给了需求就闷头输出、跑挂了再修、修不完就摆烂的状态Superpowers 值得你花一个下午装起来试试。它适合已经在用 AI 写代码的开发者尤其是每天在终端里跟 Codex CLI、Claude Code 这类工具打交道的人。今天这篇就把它的原理、安装、实际使用和踩坑记录一次性讲清楚。1. 这套技能集到底解决了什么问题1.1 从对话式写码到任务式交付的转变先聊个背景。用过 Codex CLI 或者直接在终端里调 AI 写代码的朋友应该都有这种感觉AI 处理单点问题很强比如帮我写个 debounce 函数这个报错怎么看但一旦你说把这个模块重构一下处理好边界条件再加上测试它就容易飘。要么理解错需求要么只改了表面代码没动深层逻辑要么试了几次发现太复杂直接给你个半成品。问题出在哪不是模型能力不够而是交互方式不对。普通对话式编程里AI 没有一套固定的工作方法它是走一步看一步的。碰到复杂任务它既不会先把需求拆清楚也不会在动手前先审视一下现有代码更不会主动想到要跑测试来验证。说白了AI 不缺知识缺的是流程。Superpowers 这套技能集就是来解决这个问题的。它给 AI 助手预设了一套结构化的工作技能每个技能都是一份精心设计的提示词模板告诉 AI当你接到这类任务时应该按什么步骤执行。比如接到一个开发任务AI 会先启动任务分解技能把需求拆解成可执行的步骤清单然后启动代码分析技能去读现有代码写代码时走测试驱动流程最后用代码审查技能自查一遍。这等于给 AI 立了一套 SOP不再是东一榔头西一棒子。1.2 为什么偏偏是 Codex CLI 这个生态你可能会问现在各家 AI IDE 都在做 Agent 能力为什么这套技能集主要在 Codex CLI 和 Trae 里火我的理解是这类终端型工具或者支持 skill 机制的编辑器本质上给了用户一个改造 AI 行为的入口。在 Codex CLI 里技能是以 Markdown 文件形式存放在指定目录下的AI 在回答时会根据你的指令自动加载对应的技能文件。这就像给 AI 装了一本本操作手册它接到任务时不是凭感觉发挥而是先翻手册、按手册执行。Superpowers 把一堆实战验证过的操作手册打包好装进去就能用省得自己从零琢磨提示词。这个设计思路其实跟 Anthropic 提出的 Agent Skills 概念很接近但 Superpowers 更聚焦编程实战技能颗粒度更细。2. 核心设计拆解技能包里面到底装了什么2.1 技能集的整体组织方式Superpowers 不是单一文件而是一个技能集目录每个技能对应一个文件夹里面通常包含一个或多个 Markdown 文件。文件名就是技能的名字内容则是技能的执行指令。AI 加载技能后会按文件里的步骤行动。这种组织方式有个很实际的好处按需加载。不是把所有指令都塞进上下文而是遇到什么类型的任务就加载对应的技能文件。这样既省 token又不会让 AI 因为指令太多而精神分裂。我用了几个星期体感最大的变化是 AI 的行为变得有章法了它会在动手前先把任务拆好、把风险列出来然后再开始写代码。技能包里的技能不是随意堆砌的它们构成了一条完整的开发工作流收到需求后先拆解任务明确目标和边界动手前先读代码、做影响面分析开发时遵循测试优先TDD策略完成后跑自查、审查代码质量遇到报错时系统化排查而不是盲目修。2.2 几个核心技能逐一拆解以我实际用下来的感受有几个技能属于用了就回不去的。任务拆解技能它要求 AI 收到复杂指令后先不急着写代码而是把任务拆成若干个可独立验证的子任务并按照前置依赖排序。比如你让 AI给现有项目加一个用户登录模块它会先拆分出设计数据表、写认证逻辑、做 Session 管理、写测试用例等步骤然后按顺序执行。这个技能的价值在于它最大程度避免了一上来就写一堆代码结果方向跑偏的灾难。测试优先TDD技能这可能是整个技能集里最反直觉但最有效的一个。它要求 AI 在写业务代码之前先把测试用例写好。注意这里不是简单的写完代码顺便写个测试而是先写一个会失败的测试然后写代码让测试通过。这逼着 AI 把完成的定义具体化了——什么叫功能做好了测试全绿才算。我自己试过几次加了这道工序之后AI 交付的代码质量问题明显减少。代码审查技能在 AI 完成一轮开发后它会启动一个自查流程逐行检查自己的代码找出潜在 bug、遗漏的边界条件、不合理的设计。这个技能有点像让 AI 回头再看一眼实际用下来能拦截不少低级错误。Bug 排查技能碰上疑难杂症时AI 会按照复现问题 → 定位根因 → 验证修复 → 补充回归测试的路径来处理。跟普通对话模式里那种瞎试完全不一样它会更像有经验的工程师做事。2.3 为什么这种流程化设计比单纯堆提示词更可靠这里多说一句底层逻辑。很多人都试过自己写提示词比如在 system prompt 里写你是一个资深工程师请一步一步思考。这种简单提示在实际使用中之所以不稳定是因为一步一步思考只是一句口号AI 并不知道针对当前这个具体技术任务哪几步才算是有效步骤。Superpowers 的做法是把步骤具体化、模板化了。它不泛泛地说你要先分析再动手而是规定在改动超过 5 个文件的重构任务里必须先将依赖关系列出来按从底层到上层的顺序逐个修改且每完成一个模块都要跑对应测试。这类颗粒度的指令是模型真正能执行的、稳定的行为约束。这跟给新手一份待办清单和告诉新手你加油之间的差别是一样的。3. 安装与快速配置两个主流工具的实际操作3.1 在 Codex CLI 里安装 Superpowers先说 Codex CLI。安装之前请确保你的 Codex CLI 已经更新到较新版本旧版本可能不支持 skill 的自动加载机制。详细的步骤是这样的# 1. 找到 Codex CLI 的配置目录 cd ~/.codex # 2. 克隆或下载 superpowers 技能集 git clone https://github.com/your-source/superpowers.git superpowers # 3. 确认目录结构 ls -la ~/.codex/superpowers/下载完成之后还要确认 Codex CLI 的配置文件一般在~/.codex/config.toml里设置了技能目录的加载路径。如果用的是支持 AGENTS.md 约定的版本也可以在项目的AGENTS.md文件里添加一行声明## Skills 请在执行任务前参考 ~/.codex/superpowers/ 目录下的技能定义尤其注意任务拆解、测试优先与代码审查技能。上面这段声明的作用是告诉 Codex CLI每次处理当前项目时记得把 Superpowers 技能集纳入参考。不写这个声明的话AI 可能根本不会主动去翻技能目录。配置完成以后你可以先跑一个简单任务验证技能是否生效。比如让 Codex CLI 写一个只有两个数字相加的函数但明确要求先写测试再写实现。如果它老老实实先创建了一个测试文件再补上实现说明技能加载成功了。3.2 在 Trae Work CN 中安装 SkillTrae Work CN 的 skill 安装方式更适合习惯可视化操作的人。它的机制是在项目配置或人设设定里指定 skill 的存放路径AI 在回答时会读取这些 skill 的说明文件。操作流程大致是打开 Trae进入项目设置找到技能或扩展技能相关的面板选择导入技能将下载好的 Superpowers 技能文件夹导入导入后可以在技能列表里看到所有技能项确认它们处于启用状态回到对话窗口简单问一句你会怎么处理一个包含数据库迁移和接口开发的任务看看它是否按照技能集里定义的步骤回答。如果回答里出现了先拆解任务、再评估影响面、然后写测试这类结构化描述那就说明技能已经生效。3.3 配置选项与个性化调整装好之后我建议你先别急着直接用默认配置花几分钟理解几个关键设置项。一是技能加载的优先级。如果多个技能文件同时对同一个场景给出指令AI 可能不知道听谁的。Superpowers 内部一般会通过文件名编号或者AGENTS.md的引用顺序来定义优先级改配置的时候别让自定义技能跟它冲突。二是自定义项目的补充指令。Superpowers 的技能是通用性的但你的项目可能有专属约定比如代码风格、禁止使用某个库、目录结构要求。这些应该写在自己项目的AGENTS.md里作为技能之上的更高优先级指令。我一般是这么安排的项目级规范AGENTS.md Superpowers 技能集 模型默认行为。这样既保证通用流程又保留了项目的特殊性。三是 token 控制。技能文件会在必要时被加载进上下文消耗 token。如果你用的是有上下文窗口限制的小模型建议只保留最常用的几个技能把不用的技能文件移出目录避免 AI 频繁加载无用指令白烧 token。4. 实操演示一次完整的任务复盘4.1 需求案例给一个待办应用加上归档功能为了让你直观看到装与不装的区别我拿一个真实任务来复盘。任务是给一个已有的命令行待办应用增加归档功能用户可以把已完成的待办放进归档列表归档后不再出现在主列表但可以随时查询。我把这个需求发给装了 Superpowers 的 Codex CLI它的处理过程大概是这样的。第一阶段它没有直接改代码而是先启动任务拆解技能输出了一份计划先读取现有数据结构确认待办项的状态字段在存储层增加归档状态修改列表查询逻辑默认过滤掉归档项新增一个归档查询命令为上述每个步骤补单元测试。第二阶段它开始逐个执行计划。在修改存储层之前它先写了测试验证新状态能否正确保存和读取测试跑通后再改业务代码。整个过程我没有干预它靠测试结果自行判断这一步完成了继续下一步。第三阶段全部完成后它启动代码审查技能复盘自己的改动并主动指出一个潜在问题查询归档列表时没有做排序可能导致输出顺序不稳定。然后它自己把这个修掉了。整个任务从开始到结束大约四分钟。我去 review 代码的时候发现结构清晰、注释到位、测试覆盖了正常路径和边界情况。这种交付质量在没用 Superpowers 之前我很少在 AI 编程助手上见到。4.2 案例对比同样的需求普通模式怎么翻车作为对照我在同一个项目里用普通对话模式重新提交了一遍同样需求假装没装过技能。AI 的反应是直接开写一口气改了存储层、业务层、命令层看起来挺齐全。但当我让它跑测试时发现两个问题旧的待办数据没有做迁移历史数据里没有归档状态字段读取时报错归档后主列表过滤条件写反了归档项依然显示未归档项反而被过滤掉了。这就是典型的没提前分析数据结构和兼容性导致的翻车。AI 一看需求就写代码压根没想到历史数据和边界条件。Superpowers 的任务拆解和测试优先技能恰好就是在用流程约束避开这两类问题。4.3 实操里的小技巧用了一段时间之后我总结出几个能让 superpowers 发挥最大效力的使用习惯。把大需求拆成几个明确的小指令发。虽然 Superpowers 自己有任务拆解能力但如果你能先把大方向说清楚它拆出来的子任务会更精准。我一般会这么下指令按标准流程为项目新增归档功能重点是迁移旧数据和过滤逻辑完成后跑全部测试。它就会按照技能集流程结合你给的提示推进。多用按标准流程这个触发词。Superpowers 的很多技能需要合适的触发条件才会激活你用按标准流程按技能定义执行这类表述能明显提高技能加载的概率。如果你不想每次都打字可以在项目的 AGENTS.md 里写死常规开发任务必须使用 superpowers 技能集效果等同。关键节点多让 AI 做总结。在完成一步后让它用 3-5 条要点说明改了什么、为什么这么改、有没有遗留风险。这一步能让你在 review 时省大劲也逼着 AI 梳理逻辑。5. 常见问题与排查技巧实录5.1 技能加载失败怎么办症状下了技能集但 AI 好像毫无反应行为跟以前一模一样。排查思路先确认技能目录路径是否被正确引用。Codex 的配置里如果没写路径AI 是找不到技能文件的。再看 AGENTS.md 的写法建议用绝对路径或者相对于项目根的路径别用~这种需要展开的符号。我见过不少案例是路径写错了技能文件压根没被读到。还有一种情况技能文件名里带有特殊字符导致解析异常。建议技能文件命名只用字母、数字、短横线别用空格和中文。5.2 token 消耗突然变大症状装完之后对话的 token 消耗明显上涨。这通常是 AI 每次都把所有技能文件读了一遍。解决方法是精简技能目录只保留当前项目用得上的技能。尤其是用第三方 API 转接服务跑模型的时候token 成本直接跟钱包挂钩该省就得省。5.3 技能行为不符合项目预期症状AI 遵循技能定义走得很死板比如非要先写测试但你只是想快速写个一次性脚本。这不是 bug是技能集的工作方式决定的。遇到这种情况可以在 AGENTS.md 里声明例外项比如临时脚本任务可以跳过测试优先流程。灵活性是这套体系最大的优势项目规范永远可以覆盖技能默认行为。5.4 版本更新带来的兼容问题症状升级 Codex CLI 或者更换模型后原来稳定的技能行为开始变异。不同模型对 Markdown 指令的遵循程度有差异强模型可能执行得很到位弱模型则可能忽略细节。另外某些模型的 System Prompt 里自带了任务处理方法论这跟技能集里的指令可能会有冲突。遇到这种情况建议查看模型供应商更新公告或者在提示词里特别说明以技能定义为准。6. 如何根据自己的场景微调技能6.1 技能文件改写的正确姿势Superpowers 的技能文件不是只读的你可以按需修改或新增。我自己的做法是把每次踩坑后总结出的新流程写成一个新技能文件放进技能目录。比如我负责的项目有大量数据库存储过程默认的任务拆解技能不会考虑到存储过程的依赖关系。我就新增了一个数据库变更技能规定 AI 在涉及数据库脚本修改时必须先查看所有引用该对象的存储过程列出影响清单再动手。这个小改造非常管用从此数据库变更类的任务出问题的概率大幅下降。改技能文件有个原则要守住指令措辞尽量无歧义宁可多写细节也不要让 AI 去猜。给 AI 的指令是检查所有引用该列的地方并逐个更新比注意联动影响好用一百倍。6.2 把团队规范融进去如果你在团队里推广这个技能集最划算的做法是把团队开发规范揉进技能定义。举个例子团队要求所有对外接口必须带版本号、必须写 OpenAPI 文档那就新增一个接口开发技能把这些要求写得清清楚楚。团队新成员用 AI 开发时AI 会替你把规范执行到位相当于团队的工程经验被固化成了 AI 的行为准则。我自己在团队里推过一次两周后收到的反馈是AI 生成的代码很懂规矩review 时省了很多口舌。这套东西本质上是把隐性知识显性化。6.3 调试技能文件时的小技巧改完技能文件建议先在简单任务上验证别直接上复杂需求。比如你改了代码审查技能先让它审查一个已知有 bug 的小函数看它能不能按新的要求找出问题。确认行为符合预期后再放回真实任务。另外建议给技能文件加版本号或者日期。改多了之后你不一定记得当前行为是哪一版技能定义出来的。加个版本号排查起来会省很多时间。7. 聊聊这套方案的边界与个人感受Superpowers 不是万能的。它解决的是AI 在复杂任务中行为不稳定的问题但它不能替你理解需求也不能弥补业务逻辑本身的混乱。如果你的需求描述本身就是一团糨糊再强的技能集也无能为力。它也不适合所有任务。快速写个一次性脚本、临时查个 API 用法、改个文案这些场景没必要走完整技能流反而显得笨重。技能集最适合的是有一定复杂度、需要多步骤完成、且后续要维护的代码任务。我个人最大的收获是它让我重新理解了 AI 编程助手的定位。以前我总把它当一个很聪明的结对程序员有事问一下、没事聊两句。用了 Superpowers 之后我更像是在带一个很有潜力但还不太懂规矩的新人我给它定好流程、立好规矩它负责执行得有板有眼。这个思维转变比工具本身更值钱。如果你打算入坑我的建议是先装好默认技能集跑一周什么也别改感受一下流程化开发带来的变化一周后再按自己的项目特点微调。那些网上流传的技能列表最佳实践都是别人项目的沉淀你的项目长什么样、团队约定是什么只有你自己试了才知道。