最近在后台和几个同行群里被提到最多的一个词就是superpowers。说实话我第一次看到这个词的时候也愣了一下以为又是哪个营销号在拿“AI超能力”做噱头直到有人在群里甩了一条终端输出Codex CLI把一份技能清单列出来我才意识到这是一套真正改变AI编码工作方式的东西。如果你最近也在折腾AI编程工具尤其用过Codex CLI或者Trae这类带Agent能力的环境你大概率刷到过“superpowers使用教程”“codex cli安装superpowers”这种热词。它本质上不是某个具体的独立应用而是一组可以被AI编码助手加载的“技能包”skills。装上它你的Agent在处理需求、写测试、做代码审查这些环节时会有一套更规范的流程而不是上来就闷头写代码。这篇分享我就把我从安装到实测再到踩坑的全过程完整写出来适合两类人看一类听说这个名词想搞明白它到底是什么另一类已经装上但觉得没效果、不知道问题出在哪。1. 先搞明白superpowers到底给Codex这类Agent加了什么1.1 AI编码Agent其实不缺聪明缺的是流程感先讲一个观察。我接触过不少用Codex CLI的人他们最常抱怨的事情不是“这模型写不出代码”而是“它写代码太随意了”。比如让它实现一个用户注册接口它往往直接开始写handler写到一半才想起来还要处理参数校验然后又手动补一个。最后你追问一下发现自己没提的边界条件它根本没考虑。这不是模型能力的问题而是缺了一套“干活的方法”。你可以理解成你招了一个非常聪明的实习生这个实习生只要你把需求说清楚他能很快上手写代码但他不知道你们团队提交代码之前要走代码审查、不知道改完一个函数要跑哪些回归测试、不知道接到模糊需求的时候应该先把方案列出来和你对齐再动手。superpowers这类技能包本质就是给这个“天才实习生”塞了一摞SOP手册遇到什么类型的任务就按哪一套流程来走。Codex CLI本身已经是一个很能打的终端Agent但它默认更像一张白纸。模型很聪明会写代码、会用工具可它不知道你当前项目应该优先采用什么工作流。技能包在这种场景下补上的恰恰就是“工作流”这一层——它不是让模型变得更聪明而是让模型的动作更有章法。1.2 打开技能包里面到底有什么我装过几个不同作者维护的聚合技能包虽然每个包的侧重点不一样但目录结构逻辑是统一的根目录下会有一个说明文件然后每个子目录是一个独立技能每个技能目录里有自己的入口文件通常是SKILL.md里面写着这个技能的名称、触发场景、执行步骤和输出要求。以常见的技能集合为例大致会覆盖这些方向需求拆解与方案设计将一句模糊的话术拆成可执行的任务清单先输出技术方案再写代码。测试驱动开发强制“先写失败测试再写最小实现最后重构”的节奏避免裸写代码。代码审查从设计合理性、可读性、性能风险、安全隐患等维度给修改建议而不是简单说“这段代码还行”。调试排错沿着“稳定复现、缩小范围、定位根因、修复验证”的路径排查问题。重构小步重构保持外部行为不变每做一步都可以回到可运行状态。安全审计对依赖清单、鉴权逻辑、输入输出做一轮专项体检。每个技能的description写得越清晰Agent越容易在合适的场景自动触发它。这一点后面细说也是很多人的误区所在技能能不能被触发很大程度取决于描述文件写得好不好而不是你把目录放进去了就行。1.3 不是装得越多越强关于技能包我最想先泼一盆冷水它不是插件市场里那种“能装多少装多少”的东西。技能包的底层实现本质上还是提示词加流程脚本。模型在会话开始时通常会扫描可用的技能目录把技能描述加载到上下文里供自己判断用不用。技能装得越多占用上下文窗口的内容就越多模型做决策时被干扰的信息也越多。我见过一个极端例子朋友把找到的所有技能全部复制进Codex技能目录结果一次很简单的“帮我清个临时目录”请求模型先输出一长串技能选择流程对话延迟明显增加回答也开始跑偏。正确做法是保持克制。默认只保留当前项目阶段用得上的几个技能让其他技能保持“未加载但可手动触发”的状态。这个思路会在后面的裁剪部分具体展开。2. 安装前先理清这三件事能省掉80%的折腾2.1 先确认Codex CLI版本和技能目录约定很多人安装失败第一原因不是操作问题而是环境对不上。Codex CLI的技能支持经历了几个版本的演进不同版本的CLI对“技能目录放哪里、怎么放”的定义不一样。开始之前先跑一下codex --version如果版本偏老建议先升级再处理技能。目前主流做法是在用户主目录下的.codex里面维护一个skills目录每个技能对应其中一个子目录~/.codex/skills/ ├── code-review/ │ ├── SKILL.md │ └── ... ├── tdd/ │ ├── SKILL.md │ └── ...这是很多社区技能包约定俗成的布局你装完之后也可以随时用ls ~/.codex/skills确认是否就位。另外技能里的很多辅助脚本是由Agent来执行的所以本机最好具备基本的Node.js或Python运行环境具体取决于你用到的技能这一点容易被忽略。2.2 想清楚要解决什么问题而不是先收集技能动手之前先问自己一句当前工作流里最让我头痛的是什么这个问题比选哪个技能包更重要。根据我自己的经验可以简单对照一下当前痛点优先关注的技能方向优先级写测试总漏、补丁反复打测试驱动开发、代码审查高需求说得很模糊AI经常理解错需求拆解、方案设计高老项目改一处崩一处重构、调试排错高代码质量参差不齐评审全靠肉眼代码审查中项目刚起步技术方案没人把关系统设计中这个表格不是标准答案而是一种思考方式技能包是用来解决问题的不是用来“集邮”的。装之前想清楚优先级比装十个技能然后一个个试有用得多。2.3 先把版本管理和卸载路径准备好安装技能包之前我强烈建议先建一个“中央仓库”目录比如~/dev/skills-src/把所有技能集clone到这里。这么做有两个好处一是不会直接污染Codex的技能目录二是方便后续升级和卸载。常见的技能包都是以Git仓库形式发布的clone时最好固定到某个已验证的commit避免上游更新带来行为变化。如果你在一个目录里看不到git、看不到明确的版本号那这个技能包的管理方式很可能不太可靠尽量少用。3. 在Codex CLI里安装superpowers的实操记录3.1 克隆技能仓库并检查目录结构以我最近一次安装为例。我先把技能包clone到一个专门的目录mkdir -p ~/dev/skills-src cd ~/dev/skills-src git clone 你找到的superpowers仓库地址 superpowers然后第一时间看一下项目里有什么ls -la superpowers这一步非常重要。很多聚合技能包并不是要求你把整个仓库硬塞进Skills目录而是先让你看清它有哪些子技能、每个技能目录的结构是什么样子。可以直接看主入口文件的内容它会告诉你这个技能包推荐的使用方式是“全部复制”还是“按需启用”。顺带说一句如果你拉取代码时遇到网络问题先检查自己的网络环境是否正常这不是本文要解决的事情自己想办法处理一下就行。3.2 按需复制或软链接到Codex技能目录常见的安装方式有两种我分别说下适用场景。第一种把整个技能包复制到~/.codex/skills/下然后再删除不需要的子技能。这种方式干净直接适合只在一台机器上使用的人。但缺点是上游更新后你要重新拉取再复制一遍。第二种用软链接把技能目录指过去mkdir -p ~/.codex/skills ln -s ~/dev/skills-src/superpowers/code-review ~/.codex/skills/code-review ln -s ~/dev/skills-src/superpowers/tdd ~/.codex/skills/tdd这样更新只需要到~/dev/skills-src/superpowers拉一次代码Codex这边能立刻感知。我个人的习惯是用软链接因为维护起来省事也不容易在多个技能包之间搞混。无论用哪种方式装完之后都建议重新打开终端或重启Codex会话让CLI重新扫描技能目录。3.3 第一轮验证怎么确认技能真的生效了安装完最怕的是什么装了个寂寞。确认技能是否生效其实有比较简单的方法你不需要去看安装日志直接让Agent“点名”执行某个技能就完事了。比如我刚装完代码审查技能时就在一个简单的Node项目上输入“用代码审查技能检查一下src/index.js按你该技能的流程来”。如果技能生效它会先说明自己的审查步骤再逐个维度输出建议如果技能没生效它大概率只会泛泛而谈甚至回复“我没有这个技能”。还有一个进阶的验证方法查看CLI的调试输出看会话启动时加载了哪些技能文件。不同版本的Codex CLI查日志的方式略有差异如果你熟悉自己用的CLI可以打开verbose模式后重新发起一次对话再在日志里搜索skills字样能看到技能目录的加载记录。这一步能精确定位到底是“没装对路径”还是“装上了但触发条件不合适”。4. 在Trae这类带界面的IDE里装技能路径和坑都不太一样4.1 先找到技能入口别急着敲命令Codex CLI是在终端里操作路径很直接。但很多同学实际是在Trae这类图形化IDE里用Agent这时候安装方式就不是一条命令那么简单了。Trae的Agent功能有自己独立的产品逻辑。以我装过一次的经验来看你需要在IDE里先找到Agent相关的设置面板一般在左侧的活动栏会有Agent或技能相关的图标点进去会看到技能管理的入口。有的版本支持从应用市场直接安装现成技能有的版本则允许你导入本地目录。不同版本的Trae入口位置差异很大我这边的菜单路径在你那边可能完全不同。记住一个通用的判断标准就行只要设置里出现了“技能根目录”或者“导入技能”之类的选项它的本质就是这个IDE支持的Agent技能约定你把自己需要的superpowers子技能目录指进去大概率就能识别。4.2 界面工具最常见的三个坑在图形界面环境下装技能有三个坑出现的频率特别高。第一个是路径问题。很多人下载技能包后放在桌面或者下载目录路径里带了中文和空格Agent在主目录解析时直接失败。解决办法很简单把技能包转移到一个纯英文无空格的目录里再导入。第二个是缓存问题。IDE类工具普遍有缓存机制技能导入后不会立刻生效需要重启IDE或新建会话。不要在导入之后马上开喷先重启一次再验证。第三个是执行权限问题。部分IDE的Agent运行在一个受限环境里技能包里的辅助脚本可能没有执行权限或者无法访问系统API。如果你发现技能包被识别了但技能步骤里的脚本执行不起来就需要在系统设置里给IDE放权或者选择不带脚本的轻量技能。我在Trae里排查问题时最常用的验证方式还是那句话发一句话让Agent按某个技能干活看输出是否包含技能规定的流程。这一步和Codex CLI里是完全一样的。4.3 多工具共用一套技能版本漂移问题要重视不少人是CLI和IDE混着用的。Codex里装一份superpowersTrae里又装一份结果git pull一次更新CLI这边用了新版本IDE那边还是旧版本两边表现不一致排查问题的时候很容易把自己搞懵。我的建议是把技能包的“唯一真源”放在中央目录也就是前面说的~/dev/skills-srcCLI用软链接IDE尽量也配置成引用同一个目录。如果IDE只支持复制式导入那就在每次更新后同步到IDE时在笔记里记录一个版本号避免凭感觉认为两边一定一样。5. 实测下来哪些技能值得留哪些建议关掉5.1 提效最明显的三类技能我实际用了两个多月感受最明显的是三类。第一类是代码审查技能。以前我让Codex帮我看代码它给的意见停留在“这里函数太长可以拆一下”这种水平开启技能后它会按设计一致性、可维护性、性能、安全几个维度逐项过输出的Review结果可以直接贴在PR里用。这个变化不是模型变强了而是技能给了它一套评审方法论。第二类是测试驱动开发技能。它对“先写测试再写实现”这件事的执行力非常强。如果你有自控力弱、写着写着就跑偏的问题这个技能相当于一个强制检查点让Agent每完成一步都停下来验证。第三类是调试排错技能。面对一个诡异bug默认状态下Agent经常会给出一堆可能性而在技能引导下它会先要求你提供完整复现步骤然后才逐步缩小根因范围。虽然步骤多了一些但最终定位问题的速度和准确率都高不少。5.2 默认开启反而帮倒忙的场景有三类技能我个人建议别默认全开。一类是“全流程级”技能。有些技能会在每次会话开始时强制要求先输出完整方案再进入评审最后才写代码。对一个只有十几个文件的小工具来说这套流程完全是负担改一个bug也要先写八百字方案实在熬人。另一类是依赖外部命令的技能。技能里的脚本如果需要调用某个CLI工具而当前项目压根没装那个工具Agent就会卡住反复尝试执行失败的命令白白消耗上下文。还有一类是和团队规范冲突的技能。比如你所在的团队代码风格已经有一套评审标准外来的技能按另一套标准输出结果就是每次Review结论都要人工二次处理。这种技能适合按需手动触发不适合自动启用。5.3 一个可参考的裁剪思路基于上面的经验我给不同项目类型整理了一套裁剪思路你可以用它做初始配置项目类型建议保留建议关闭一次性脚本或小工具代码审查、调试排错重型方案设计、全流程工作流中型业务服务需求拆解、方案设计、代码审查、TDD全局重构、安全审计可手动触发老代码库维护重构、调试排错、回归验证强制TDD全流程这套配置不是标准答案但能帮你在第一次使用时不至于被过量的“流程感”淹没。先用一段时间再根据实际触发频率微调。6. 让技能包真正融入工作流的三个协作细节6.1 把技能清单写进项目说明省得每次都重新解释技能包装好之后还有一个很低成本但回报很大的操作在项目里的AGENTS.md或README里加一段“本项目可用技能说明”。比如## AI 辅助约定 - 代码变更请使用 code-review 技能进行审查 - 新功能实现优先遵循 tdd 技能流程 - 定位线上问题请使用 debug-skill这样每次Agent启动时会自动看到这段信息不用你在对话里反复解释也减少“你明明装了技能却不知道该用哪个”的尴尬。我试过之后发现这个简单的动作能让技能触发率提升不止一个档次。6.2 更新时锁定commit别让技能行为突变成惊吓技能包这种东西更新频繁不代表一定变好。我踩过一次坑某次git pull之后代码审查技能的输出格式整个变了和我团队的PR模板对不上导致我花了一晚上重新调整提示语。从那以后我养成了固定commit的习惯cd ~/dev/skills-src/superpowers git log --oneline -5 # 确认当前版本稳定后记录这个 commit 值需要升级时先看看上游的变更说明确认改动内容再决定是否跳到一个新commit。这样技能包的行为虽然会变但变化是可控、有预期的不会在某个早晨突然给你来一记偷袭。6.3 定期给技能包做“瘦身”和做项目复盘一样重要最后分享一个我现在还在坚持的习惯每两到三周我会翻一下过去几天的会话记录看哪些技能被真实触发过哪些从未被用到。一次都没触发过的技能说明要么描述写得让Agent识别不了要么根本不适合我的工作流果断把它从默认加载里移除需要时再手动触发。团队协作的情况下我还会把这份“实际有效技能清单”同步给同事让他们在各自的IDE和CLI里按同一个标准裁剪。工具一直在迭代技能包的玩法也在变但有一个原则不会变技能包是为你服务的而不是让你去适应它的。如果你这会儿正盯着一个superpowers技能包不知道从哪下手我的建议是别再往下翻教程了先跑一条codex --version然后把你手头最烦的那个问题写下来照着第二节的清单先选一个技能装上。装完跑一轮验证比我在这看十遍经验都管用。