最近跟同行聊AI编程工具的时候很多人都在提一个叫“superpowers”的开源项目。这名字起得挺霸气的好奇心驱使我专门去研究了一下从GitHub仓库一路摸到实际安装使用折腾了一天多把整个流程跑了不止一遍。这篇文章我不打算写那些官方README里已经有的废话而是认认真真把“这玩意到底解决什么问题”“怎么一步步装好”“装好之后怎么让它真的干活用”讲清楚顺便把我踩过的坑也一并交代了。1. 先搞清楚superpowers到底是什么1.1 它不是“一个软件”而是一套技能包很多人第一眼看到superpowers会下意识把它当成一个独立软件来理解这种思路一开始就偏了。严格来说superpowers是一个面向AI编程助手的技能集skills set说得更直白一点它是一堆经过整理的提示词模板、工作流规则、代码处理约定和自动化脚本的集合体。传统AI编程工具比如命令行里的Codex CLI本身能力并不弱但它的工作方式更接近于“你问什么我答什么”。你让它写函数它就给你写一个函数你让它重构代码它就按默认思路去重构缺少一套稳定的操作规范。superpowers做的事情就是给这类AI工具预先装上一套“职业习惯”——比如先分析再动手、测试先行、分步提交、自动化验证——让它从“一个聪明的问答机器人”变成“一个懂规矩的程序员”。1.2 为什么“技能包”这个思路能火其实在superpowers之前市面上已经有不少类似的项目比如给AI工具定制system prompt、维护一份超长指令模板之类的做法。但这些方案都有一个通病零散、难维护、换台机器就失效。superpowers把这一套系统化了。它把技能拆分成一个个独立的模块每个模块对应一种使用场景。比如代码审查、调试排错、性能优化、架构设计都有对应的技能文件。你按需启用不需要一次性全装上。这种模块化设计的思路非常像VS Code的插件生态只不过它加载的不是编辑器插件而是AI助手的“行为模式”。另外值得说的一点是这个项目同样保留了人工审查的可能。每个技能文件都是可读的文本你可以打开看它到底给AI灌输了什么指令不会有那种“黑盒”感。1.3 GitHub仓库里到底长了些什么打开GitHub上superpowers的项目主页你会看到一套清晰的目录结构。最核心的是skills目录里面按照类别做了划分比如code-review、debugging、refactoring这些子目录。每个子目录通常包含一份SKILL.md主文件外加示例、模板或脚本。这套命名和结构本身也是国外类似项目的通用惯例好处是如果未来你想自己写技能只需要照着这个结构新建一个文件夹不用改任何核心代码。这点我后面会专门讲。2. 安装前的准备与判断2.1 前置环境你需要哪些基础工具在动手安装前我先说清楚需要准备的东西免得你装到一半才发现缺环境。这里我给出一份经我实测的清单依赖工具用途版本要求Node.js运行命令行工具及脚本建议18Git用于克隆项目仓库无特别要求Codex CLIAI编程助手的命令行客户端建议安装最新版HomebrewmacOS或等效包管理器装依赖更省事可选可能有人会问为什么需要Node.js因为superpowers的安装脚本和部分技能工具是用JavaScript写的没有Node环境很多命令跑不起来。如果你之前没装过Node建议先解决这个前置依赖。2.2 先确定你的Codex CLI能用起来superpowers是以“附加技能包”的形式增强Codex CLI的所以你的Codex CLI本身得先正常工作。我见过一些人跳过这一步结果技能装完了一运行发现根本调不起来排查到最后才发现是Codex CLI本身就没配好。你在终端里输入codex --version能正常输出版本号说明这层没问题。另外建议把登录态也确认一下比如运行codex whoami不同版本命令存在差异以你本机的帮助信息为准确保账户状态正常因为后续所有技能最终都要通过Codex CLI去执行。提示不同版本的Codex CLI命令可能存在差异安装前先跑一下codex --help看看当前支持的子命令比盲目抄网上教程靠谱得多。2.3 安装前想清楚总比装完后悔强superpowers提供的技能很多全量安装不是不行但对大多数人来说没必要。比如你是做前端开发的后端调试技能大概率用不上你是写Python脚本的Java相关的约定也跟你没多大关系。我的建议是第一次安装可以按官方默认方式来先把它跑通建立体感之后再做减法只保留跟你日常工作强相关的技能。这样既能快速上手又不会因为技能文件太多导致每次调用都要读入大量上下文影响响应速度。3. superpowers的完整安装过程3.1 第一步把项目克隆到本地为了后续管理的方便我建议给superpowers建一个独立目录别跟其他项目混在一起。我在自己的开发目录下新建了一个tools文件夹专门用来放这类辅助工具。mkdir -p ~/dev/tools cd ~/dev/tools git clone https://github.com/your-repo/superpowers.git cd superpowers这里要注意cloning之后先别急着操作先看一下项目的README。因为这种迭代比较快的开源项目文档更新时间可能赶不上代码变化README里说的安装方式可能跟你拉下来的版本有出入。3.2 第二步跑安装脚本多数这类项目都会提供一个自动化安装脚本superpowers也不例外。在项目根目录下通常能找到install相关的脚本文件有些是.sh有些是Makefile执行的内部命令。一个典型的安装命令是./install.sh执行之前我建议你先打开脚本文件看一眼内容。别嫌麻烦这一步能避免很多不确定性。主要看三件事它把文件复制/链接到了哪些目标路径它是否会覆盖你已有的配置比如settings.json它需不需要你预先设置某些环境变量。我看过太多这类项目的安装脚本有的会往全局配置目录写入文件有的会尝试建立软链接。如果你之前已经手动改过Codex CLI的配置看一眼脚本内容能有效防止配置被冲掉。3.3 第三步处理Codex CLI的配置目录superpowers的安装脚本背后有一个核心动作——把技能文件挂载到Codex CLI能够读取的目录。这个目录在不同操作系统上不一样通常位于~/.codex/或~/Library/Application Support/Codex/之类的路径下。挂载方式通常有两种复制文件直接拷贝到配置目录的skills子文件夹里简单粗暴但后续更新麻烦。建立软链接在配置目录里创建一个指向你本地仓库的符号链接更新时只需git pull配置目录里的“文件”会自动同步到最新版本。我推荐第二种方式因为superpowers这类项目更新频率不低用软链接能省掉反复复制的烦恼。具体命令大致是ln -s ~/dev/tools/superpowers/skills ~/.codex/skills需要提醒的是软链接的路径一定要写成绝对路径写相对路径会导致识别失败。这个细节坑过不少人我一开始也栽在这里。3.4 第四步让Codex CLI识别技能配置好目录之后重启Codex CLI让新技能列表加载生效。然后你可以用一个简单的方式验证加载是否成功直接问Codex CLI“你能使用哪些技能”或者让它根据superpowers推荐的一个技能比如代码审查示范一次工作流。它在执行时通常会读取对应的技能文件表现为回答会变成“根据superpowers的代码审查技能我先分析变更范围……”。当看到这样带有明确流程结构的回答时就说明技能已经被真正加载了。3.5 使用Trae这类AI IDE做图形化安装除了在终端里跟Codex CLI打交道现在很多桌面级AI IDE也支持类似技能机制比如Trae这类工具通常会提供一个图形化的技能管理面板你在搜索或和AI对话时能直接看到已安装的技能。通过IDE内置的“技能”管理功能来安装superpowers的好处是不用敲命令、不用手工管目录UI会把这层细节隐藏起来。你需要做的基本就是找到技能的导入入口把从GitHub获取的仓库地址或技能压缩包导进去然后在技能列表界面确认它处于启用状态。提示由于这类工具版本迭代很快截图和菜单名称大概率会变化。遇到找不着入口的情况直接在IDE的文档中心里搜“导入技能”关键词以官方教程为准比问任何博主都稳。4. 技能装上之后怎么让它真正给你干活4.1 理解“技能”可以被动态加载而非总是全量生效安装完成后你可能会抱着一种期待让AI干任何事都能展现出superpowers加持后的专业水准。实际情况并不是这样。superpowers的设计哲学是“按需触发”。也就是说不是每个技能在任何对话里都自动生效而是在你触发特定场景时才会加载对应的技能内容。举个例子你让它做代码审查它会去读代码审查技能你让它调试某个诡异Bug它才去读调试技能。这带来一个很重要的使用习惯你需要把任务的意图表达清楚最好直接点出你希望它用哪个技能来处理。比如你可以说“用代码审查技能查看我最近的提交”而不是笼统地“帮我看看代码”。前者能让AI快速定位技能文件执行效果和稳定性都会好很多。4.2 从“会说”到“会做”技能包擅长的典型场景我自己长期用的是这几个场景篇幅有限挑三个典型的说说。场景一代码审查。让我比较有感触的是它在审查时会先要求确认变更范围然后按文件逐个过最后汇总问题清单并给出优先级建议。跟平时“甩一堆代码让AI点评”的体验完全不一样。它不再泛泛而谈“代码还可以更优雅”而是会具体指出哪个函数职责过重、哪块缺少边界处理粒度明显细很多。场景二自动化调试。它内置了一套比较严格的调试流程强制要求先复现问题、再定位原因、最后提修复方案并验证。对于容易看到错误就想当然乱改代码的人来说相当有用。场景三重构。重构成败的关键在于“别破坏现有行为”。superpowers会要求先跑测试、理清依赖关系再提出分步重构计划每一步都尽量小且可回滚完全是一套正规团队里的重构纪律。4.3 想扩展技能四条实用路径用了一段时间之后你大概率会有“要是它能做XXX就好了”的想法这很正常。superpowers本身就是给动手能力强的人设计的扩展它的方式大致有四种扩展方式适合人群成本修改现有技能的提示词所有用户低复制一个技能目录再改有基本文件操作能力低为某个技能增加示例数据想提升稳定性的用户中给核心技能写辅助脚本会写代码的用户高我个人从“改提示词”这一步入门的。比如我团队内部约定代码用中文注释、某些文件名禁止出现拼音我就直接在对应技能文件里追加一条行为约束下次调用时AI就会自动遵守省得每次在对话里重复叮嘱。4.4 技能和普通对话的关系两者如何分工还有一点值得单独说superpowers并不会接管你所有的AI交互。你仍然可以像以前一样问一些零散的知识性问题让它帮你想个名字、解释一个概念、写一段临时脚本这些都用不着技能。技能的定位是标准作业程序适合反复出现、需要稳定产出的任务。日常使用中我这样区分临时任务直接对话流程型任务指定技能。按这套逻辑长期用下来AI输出的稳定性明显提升我花在“检查AI有没有乱来”上的精力也少了不少。5. 安装和使用过程中我踩过的那些坑5.1 典型问题一技能列表里空空如也有次我明明把技能文件放进了配置目录但Codex CLI硬是一个技能都看不到。排查过程复盘如下先检查目录位置是否正确我用的命令是ls -l ~/.codex/skills结果发现这个软链接指向的路径根本不存在。原因是我之前把仓库目录移动过导致软链接变成了死链。解决办法删掉旧软链重新创建并且这次用绝对路径。顺手在~/.codex下写了段初始化脚本以后仓库移动了直接重跑一遍就行。注意配置升级之后某些版本会重置配置目录的相关选项导致自定义技能路径被忽略。如果你之前能正常用某个技能某天突然失效优先检查配置里与skills相关的设置项是否被改动。5.2 典型问题二技能文件内容不全某个技能能正常被识别但AI执行到一半就停住或者表现得像没加载一样最后发现原因在技能文件本身。有的技能不止一个SKILL.md还依赖目录里的模板文件或辅助脚本。我在克隆项目后用了自定义方式只把SKILL.md链接过去结果依赖文件缺失导致技能执行得七零八落。解决办法不要在文件级别玩花活。把整个技能目录原样链接过去是维护成本最低的方案。5.3 典型问题三子命令不存在或参数对不上前面提到过不同版本的Codex CLI支持的命令存在差异。早期我把旧版CLI的配置带到新版环境执行的某个配置命令在新版里已经改名导致配置不生效。解决办法以codex --help给出的最新的帮助信息为准别迷信网上教程里的具体命令。快速确认版本信息后到项目官方更新日志里看更换点是最快的路径。5.4 给新手的建议分步验证比一把梭更值得很多新手容易照着一整套教程从头敲到尾如果中途报错就手足无措。我的建议是安装前先花几分钟把前置依赖确认完环境差异在工作中非常常见这五到十分钟的“检查”几乎总能避免后续排查的苦头。6. 综合使用体感与进阶玩法全部搞定、连续高强度用了一周之后说点我的真实感受。第一步安装流程顺利的话十来分钟就能跑通。但“跑通”只是开始真正让它增值的关键在于后续的“调教”——你越是愿意投入时间微调技能文件、补充语境信息、打磨提示词它越能还给你一个更靠谱的AI协作者。这跟工具本身是否复杂无关更多的是一种工作方式的转移从“每次都要从头交代需求”转变为“把规矩定好让AI按规矩办事”。对于有开发能力的朋友我比较推荐你看看skills目录下的脚本类技能是怎么写的。不少技能不只是文本提示还包含自动化校验脚本它们能在AI完成任务后自动检查输出质量。看懂这套设计你就掌握了把自己的经验沉淀成资产的方法。有个晚上我把团队代码规范整理成一个自定义技能文件第二天让Codex CLI按这套规范审查了新写的接口模块它给出的几处改进意见确实是我自己容易忽视的边界情况。那一刻你会觉得工具本身从命令行搬进了你的工作流搬进了团队的日常约束里。superpowers目前更新节奏较快文档和功能都在演进。这篇文章只代表现阶段的有效做法你上手的时候如果发现差异记得以官方仓库最新的README和帮助文档为准。