1. 三个满分Skill到底在解决什么问题先把话说在前头Codex的Skill机制本质上就是给AI装“外挂大脑”。你平时用Codex写代码、查资料、做分析它默认只有通用能力遇到特定领域的活儿就容易泛泛而谈。Skill就是把你反复要用的那套流程、规范、知识打包成一个可复用的模块让Codex在需要的时候自动调用。我用了大半年Codex前前后后装了二十多个Skill踩过的坑比写过的代码还多。有的Skill装完就吃灰有的用两次就发现逻辑有硬伤真正能称得上“满分”的掰着手指头数也就三个。这三个分别解决三类核心痛点信息检索的精准度、任务执行的工程化、Skill本身的批量生产能力。为什么是这三个因为大部分人的工作流就卡在这三环上。你让Codex帮你查个技术方案它给你编一堆看起来合理但根本跑不通的答案——这是检索层的问题。你让Codex帮你重构一个模块它东一榔头西一棒子改完A文件忘了B文件——这是执行层的问题。你想自己写个Skill把团队规范固化下来结果发现写Skill比写业务代码还费劲——这是元能力的问题。这三个Skill分别对应Any Search解决检索Superpowers解决执行Skill Creator解决Skill的生产。它们不是孤立的串起来就是一条完整的“输入-处理-输出”链路。下面我会把每个Skill拆开揉碎讲清楚它为什么能拿满分、怎么装、怎么配、怎么用、以及我踩过的那些坑。注意Skill的安装和配置高度依赖你的Codex版本和运行环境。我用的环境是Codex CLI配合本地配置文件如果你用的是桌面版或者网页版部分路径和配置项需要对应调整。下文所有操作都基于我实测可用的方案但你的环境可能有差异遇到问题先检查版本号。2. Any Search把“搜得到”变成“搜得准”2.1 为什么默认检索总是不靠谱Codex自带的检索能力说白了就是“广撒网”。你问它一个技术问题它会从训练数据里捞出一堆相关片段然后拼凑成一个看起来像那么回事的答案。问题在于训练数据有截止日期而且它分不清“官方文档”和“某个博客里的错误示范”。我试过问一个API的调用方式它给我返回了一个三年前就已经废弃的参数名还信誓旦旦地说“这是标准用法”。Any Search这个Skill的核心思路是把检索从“模型内部记忆”切换到“外部实时查询结构化过滤”。它内置了一套检索策略先判断问题类型再选择对应的数据源最后对结果做可信度排序。听起来简单但实现起来有几个关键设计。第一个设计是查询改写。你输入的自然语言问题会被拆解成多个检索关键词组合。比如你问“Python里怎么优雅地处理大文件读取”它会生成“Python large file reading best practices”、“Python memory efficient file processing”、“Python generator file read”等多组查询然后并行检索。这样做的好处是避免单一查询的偏差坏处是消耗更多token。我实测下来对于技术类问题查询改写带来的准确率提升大概在40%左右。第二个设计是来源分级。Any Search内置了一个来源可信度表官方文档、GitHub高星仓库、Stack Overflow高赞回答的权重最高个人博客和论坛帖子的权重较低。这个分级不是写死的你可以通过配置文件自定义。我一般会把公司内部Wiki的权重调到最高这样查内部规范的时候特别准。第三个设计是结果去重与交叉验证。多个查询返回的结果会有重叠Any Search会做语义去重然后对同一事实的不同表述做交叉验证。如果三个来源都说A是对的一个来源说B是对的它会优先采信A。这个机制在查API用法的时候特别有用能有效过滤掉那些过时的、错误的用法。2.2 安装与配置的实操细节Any Search的安装方式取决于你的Codex版本。我用的CLI版本安装命令是codex skill install any-search装完之后配置文件在~/.codex/skills/any-search/config.yaml。默认配置能用但要想发挥最大效果有几个参数必须调。search: max_queries: 5 # 单次检索最多生成几个查询 timeout: 15 # 单个查询超时时间秒 source_weights: official_docs: 1.0 github: 0.9 stackoverflow: 0.85 personal_blog: 0.5 forum: 0.4 cross_validation: true # 是否开启交叉验证 dedup_threshold: 0.85 # 语义去重阈值max_queries这个参数我建议设在3到5之间。设太小检索覆盖面不够设太大token消耗飙升而且边际收益递减。我试过设到8结果每次检索要等将近半分钟而且返回的结果里有大量重复。3到5是甜点区。timeout设15秒是保守值。如果你的网络环境好可以降到10秒如果经常查一些冷门资料可以提到20秒。但别设太高否则一个查询卡住会拖垮整个流程。source_weights是最关键的配置。默认权重适合通用场景但如果你有特定需求一定要改。比如你做学术研究可以把arxiv的权重调到1.0你做企业内部开发把内部Wiki调到1.0。权重是相对的不是绝对的系统会自动归一化。dedup_threshold控制去重的严格程度。0.85意味着语义相似度超过85%的结果会被合并。设太低会误杀不同但相关的结果设太高会留下大量重复。0.85是我试了七八个值之后觉得最平衡的。提示改完配置文件后需要重启Codex会话才能生效。我一开始不知道改完直接问问题发现还是老样子折腾了半小时才发现要重启。2.3 实际使用中的效果与边界Any Search最擅长的场景是技术方案调研和API用法查询。我拿它查过Kubernetes的NetworkPolicy配置、React的useEffect依赖数组规则、PostgreSQL的索引优化策略准确率明显高于默认检索。特别是查那些“官方文档写得很绕但实际用法很简单”的东西Any Search能直接从GitHub的示例代码里找到最简洁的写法。但它不是万能的。有两类问题它处理不好一是主观判断类问题比如“哪个框架更好”这种问题没有标准答案Any Search会返回一堆对比文章但不会给你一个明确结论二是时效性极强的信息比如“今天发布的某个版本有什么新特性”如果外部数据源还没更新它也查不到。还有一个坑是查询语言。Any Search对英文查询的支持最好中文查询的效果会打折扣。我试过用中文问“怎么配置Nginx的反向代理”返回的结果质量明显不如英文查询。所以我的习惯是技术类问题一律用英文问生活类问题才用中文。2.4 常见问题速查问题现象可能原因解决方法检索结果全是过时信息数据源权重配置不当调高官方文档和GitHub权重检索速度极慢max_queries设太大或网络问题降到3检查网络连接返回结果重复率高dedup_threshold设太低调到0.85到0.9之间中文查询效果差查询语言与数据源不匹配改用英文查询配置文件改了不生效未重启Codex会话退出当前会话重新进入3. Superpowers让Codex真正“会干活”3.1 从“能说”到“能做”的跨越如果说Any Search解决的是“知道什么”那Superpowers解决的就是“怎么做到”。默认的Codex有个毛病你让它改一个功能它会给你一段代码但不会告诉你这段代码要放在哪个文件、要改哪些依赖、要跑什么测试。你得自己把这些碎片拼起来拼错了它也不负责。Superpowers的核心是一套任务分解与执行框架。它把一个大任务拆成多个可执行的子步骤每个子步骤都有明确的输入、输出和验证条件。然后它按顺序执行这些子步骤每完成一步就验证一步验证不通过就回滚重试。这套机制听起来像CI/CD流水线实际上它的设计灵感确实来自工程化的持续集成理念。我拿它做过一个实际项目把一个用Flask写的旧API迁移到FastAPI。这个任务涉及路由重写、依赖注入改造、请求验证替换、测试用例更新等多个环节。如果手动做我得一个个文件改改完还得跑测试确认没破坏现有功能。用Superpowers我只需要描述清楚迁移目标它会自动生成任务分解然后一步步执行。3.2 任务分解的底层逻辑Superpowers的任务分解不是简单的“把大任务切成小任务”而是基于依赖图的拓扑排序。它会先分析任务涉及的所有文件和模块构建依赖关系图然后找出没有前置依赖的节点先执行逐步推进到最终目标。这个过程中有几个关键机制。第一个是影响面分析。当你要求修改某个函数时Superpowers会先扫描整个代码库找出所有调用这个函数的地方评估修改的影响范围。如果影响面太大它会提示你“这个修改会影响X个文件是否继续”。这个机制救过我好几次有一次我想改一个工具函数的返回值类型它提示我有47个调用点我一看就放弃了改用新增函数的方式。第二个是增量验证。每完成一个子步骤Superpowers会运行相关的测试用例。如果测试通过继续下一步如果失败它会尝试自动修复修复不了就暂停并报告问题。这个机制的好处是问题在早期就被发现不会等到最后才爆雷。我试过让它改一个涉及五个模块的功能它在第三个模块就发现了一个类型不匹配的问题如果手动做这个问题可能要等到运行时才会暴露。第三个是回滚机制。如果某个子步骤执行失败且无法自动修复Superpowers会把已经修改的文件恢复到执行前的状态。这个机制依赖Git所以你的项目必须在Git版本控制下。我建议在执行任何Superpowers任务之前先commit当前状态这样即使回滚出问题你还有手动恢复的余地。3.3 配置与使用步骤Superpowers的安装命令codex skill install superpowers配置文件在~/.codex/skills/superpowers/config.yamlexecution: max_retries: 3 # 单个子步骤最大重试次数 auto_fix: true # 是否开启自动修复 rollback_on_failure: true # 失败时是否回滚 test_command: pytest # 测试命令 dry_run: false # 是否只模拟不执行 analysis: max_impact_files: 20 # 影响面超过这个数就提示 dependency_depth: 3 # 依赖分析深度max_retries设3是合理的。设1的话遇到偶发错误就直接失败设5以上可能会在同一个问题上反复卡住。3次重试足够覆盖大部分临时性问题。test_command必须根据你的项目配置。Python项目用pytestJavaScript项目用jest或vitestGo项目用go test。如果你没有测试用例Superpowers的增量验证机制就失效了它会退化成普通的代码生成。所以我强烈建议用Superpowers之前先把测试写好。dry_run模式我建议在第一次用的时候开启。它会模拟整个执行过程输出每一步会做什么修改但不实际改文件。你可以先看看它的计划是否合理确认没问题再关掉dry_run正式执行。使用的时候直接在Codex里描述任务即可用Superpowers帮我完成以下任务将src/api/目录下的所有Flask路由迁移到FastAPI保持接口路径和参数不变更新对应的测试用例。Superpowers会先输出一个任务分解计划包括涉及的文件列表、执行顺序、每步的验证方式。你确认后它才开始执行。3.4 我踩过的坑与应对策略第一个坑是测试覆盖不足导致验证失效。我有个项目测试写得比较糙只覆盖了主流程。Superpowers改完代码后跑测试通过了但上线后发现边界情况挂了。后来我学乖了用Superpowers之前先补测试特别是边界情况的测试。第二个坑是依赖分析深度不够。默认的dependency_depth: 3对于小型项目够用但对于大型项目依赖链可能长达五六层。我有个项目改一个底层工具函数影响到了第四层的一个模块但Superpowers只分析了三层没发现那个问题。后来我把深度调到5虽然分析时间变长了但准确率上来了。第三个坑是自动修复引入新问题。Superpowers的自动修复有时候会“过度修复”比如把一个类型错误改成强制类型转换虽然编译通过了但运行时可能出问题。我的策略是对于核心模块关掉auto_fix让它报告问题我来手动修对于边缘模块开着自动修复省事。注意Superpowers执行过程中会频繁读写文件如果你的项目在机械硬盘上可能会比较慢。我换到SSD之后执行速度大概快了三倍。3.5 与其他工具的配合Superpowers可以和Any Search联动。当Superpowers在执行过程中遇到不确定的API用法时它会调用Any Search去查最新文档。这个联动需要额外配置integration: any_search: true search_on_uncertainty: true开启后Superpowers在遇到不确定的调用方式时会先查再写减少瞎编的概率。我实测下来这个联动对于使用第三方库的项目特别有用能有效避免“用了废弃API”的问题。4. Skill Creator批量生产Skill的Skill4.1 为什么需要“造Skill的Skill”前两个Skill解决的是使用问题Skill Creator解决的是生产问题。你可能会想我直接用现成的Skill不就行了为什么要自己造答案是现成的Skill解决的是通用问题你的具体问题只有你自己知道。举个例子你们团队有一套代码规范比如“所有API必须返回统一的响应格式”、“数据库查询必须走ORM不能拼SQL”、“日志必须包含trace_id”。这些规范Codex默认不知道你每次都要在prompt里重复一遍烦不烦写个Skill把这些规范固化下来以后Codex自动遵守一劳永逸。但写Skill本身是有门槛的。你需要理解Skill的配置文件格式、触发条件、执行逻辑、参数定义。Skill Creator就是把这个门槛降到最低你用自然语言描述你想要什么Skill它帮你生成完整的Skill配置。4.2 Skill Creator的工作原理Skill Creator的核心是一个模板引擎代码生成器。它内置了多种Skill模板覆盖了常见的Skill类型检索类、执行类、校验类、转换类。你描述需求后它会匹配最合适的模板然后根据你的描述填充参数和逻辑。这个过程分三步。第一步是需求解析它把你的自然语言描述拆解成结构化的需求点。比如你说“我想要一个Skill每次我写Python函数时自动检查是否有类型注解”它会解析出触发场景是“写Python函数”检查项是“类型注解”动作是“自动检查并提示”。第二步是模板匹配。根据解析出的需求点它从模板库中选择最接近的模板。上面的例子会匹配到“代码校验类”模板。第三步是参数填充与代码生成。它把需求点映射到模板的参数上生成完整的Skill配置文件。你拿到配置文件后可以手动微调也可以直接安装使用。4.3 从零创建一个Skill的完整流程我拿一个实际需求来演示我想要一个Skill每次我让Codex写SQL查询时自动检查是否使用了参数化查询防止SQL注入。第一步在Codex里调用Skill Creator用Skill Creator帮我创建一个Skill当我要求写SQL查询时自动检查生成的SQL是否使用了参数化查询如果使用了字符串拼接就提示风险。第二步Skill Creator会输出一个需求确认需求解析 - 触发场景生成SQL查询代码 - 检查项是否使用参数化查询 - 风险条件字符串拼接方式构造SQL - 动作提示风险并建议修改 请确认是否准确你确认后它生成Skill配置文件name: sql-injection-checker version: 1.0.0 description: 检查SQL查询是否使用参数化查询 trigger: patterns: - 写.*SQL - 查询.*数据库 - SELECT.*FROM languages: - python - javascript - java check: rules: - id: parameterized-query pattern: execute\\(.*%s.*\\)|execute\\(.*\\.*\\)|f\SELECT.*\\{.*\\}\ message: 检测到可能的SQL注入风险建议使用参数化查询 severity: warning action: on_violation: suggest_fix fix_template: 使用参数化查询cursor.execute(SELECT * FROM table WHERE id %s, (user_id,))第三步安装这个Skillcodex skill install ./sql-injection-checker.yaml装完之后每次你让Codex写SQL它都会自动检查并提示。我实测下来这个Skill帮我避免了好几次潜在的安全问题。4.4 进阶技巧组合多个SkillSkill Creator生成的Skill可以和其他Skill组合使用。比如你把sql-injection-checker和Superpowers组合Superpowers在执行数据库相关任务时会自动调用sql-injection-checker做校验。组合配置在Superpowers的config里integration: skills: - sql-injection-checker - any-search这种组合的威力在于它把“生成-校验-修复”串成了一条自动化流水线。Superpowers生成代码sql-injection-checker校验发现问题Superpowers自动修复。我拿这套组合做过一个数据迁移脚本从生成到校验到修复全自动我只在最后review了一遍。4.5 常见问题与排查问题现象可能原因解决方法Skill不触发触发模式写得太窄放宽patterns增加同义词误报太多检查规则太宽泛收紧pattern增加排除条件生成的Skill报错模板参数不匹配检查Skill Creator版本更新模板库组合Skill冲突多个Skill同时触发调整触发优先级设置互斥条件修复建议不适用fix_template太通用根据项目实际情况自定义模板5. 三个Skill的协同工作流5.1 一条完整的自动化链路把三个Skill串起来可以构建一条从“需求理解”到“代码交付”的完整链路。我拿一个实际场景来演示我需要给一个现有的Python项目添加一个新的API接口这个接口要从数据库查询数据并返回JSON。第一步Any Search介入。我描述需求后Any Search先去查项目现有的API规范、数据库连接方式、JSON序列化库的用法。它返回了项目的API路由结构、数据库ORM的用法示例、以及推荐的序列化方式。第二步Skill Creator介入。根据Any Search返回的信息Skill Creator生成一个针对这个项目的API生成Skill固化了项目的API规范比如响应格式、错误码、日志格式。第三步Superpowers介入。它根据生成的Skill自动创建路由文件、模型文件、测试文件然后运行测试验证。如果测试失败它调用Any Search查错误原因然后自动修复。整个流程我只需要描述一次需求剩下的全自动。实测下来一个中等复杂度的API接口从描述到测试通过大概需要3到5分钟。手动做的话至少半小时。5.2 配置协同的关键参数要让三个Skill协同工作需要在各自的配置里开启联动Any Search的配置integration: expose_to_superpowers: true cache_results: true cache_ttl: 3600Superpowers的配置integration: any_search: true skill_creator: true auto_install_generated_skills: trueSkill Creator的配置integration: auto_analyze_context: true inherit_project_conventions: truecache_results和cache_ttl是Any Search的缓存配置。开启后相同的查询在1小时内会直接返回缓存结果减少重复检索。我实测下来缓存命中率大概在30%左右对于反复查同一类问题的场景很有用。auto_install_generated_skills让Skill Creator生成的Skill自动安装省去手动安装的步骤。但要注意自动安装的Skill会立即生效如果生成的Skill有问题可能会影响后续操作。我建议在开发环境开启这个选项生产环境手动确认后再安装。5.3 性能与资源消耗三个Skill同时运行资源消耗是单个Skill的三倍左右。主要体现在token消耗和执行时间上。我实测了一组数据场景单Skill耗时三Skill协同耗时Token消耗倍数简单查询5秒12秒2.5x代码生成15秒45秒3.2x复杂重构60秒180秒4.1x从数据看协同工作的开销是显著的。所以我的策略是简单任务用单个Skill复杂任务才开启协同。判断标准是如果任务涉及三个以上的文件修改或者需要查外部资料就开启协同否则单Skill就够了。提示如果你的Codex是按token计费的协同工作流的成本要提前算好。我有个朋友没注意跑了一下午协同任务账单出来吓了一跳。6. 实操心得与避坑指南6.1 安装顺序有讲究三个Skill的安装顺序会影响协同效果。我试过不同的安装顺序发现先装Any Search再装Superpowers最后装Skill Creator的效果最好。原因是Any Search是基础检索层Superpowers依赖它做信息查询Skill Creator生成的Skill可能依赖前两者的能力所以最后装。如果顺序装反了比如先装Skill Creator它生成的Skill可能引用不到Any Search的接口导致运行时报错。虽然可以手动改配置修复但不如一开始就按正确顺序装省事。6.2 版本兼容性检查Codex的Skill机制还在快速迭代不同版本之间的配置格式可能有差异。我遇到过两次因为版本不兼容导致Skill失效的情况。一次是Codex升级后Skill的trigger配置从patterns改成了triggers我没注意Skill一直不触发。另一次是Superpowers的test_command参数从字符串改成了数组我的旧配置直接报错。所以我的习惯是每次升级Codex后先跑一遍Skill的自检命令codex skill doctor这个命令会检查所有已安装Skill的配置是否与当前Codex版本兼容并给出修复建议。我建议你也养成这个习惯能省去很多排查时间。6.3 日志与调试Skill出问题的时候第一手信息在日志里。Codex的Skill日志默认在~/.codex/logs/skills/目录下每个Skill一个日志文件。日志级别可以在配置里调logging: level: debug max_size: 10MB max_files: 5调试的时候把level调到debug能看到详细的执行过程。但平时建议用info级别debug日志量太大容易把磁盘写满。我试过开着debug跑了一整天日志文件涨到了2GB。6.4 安全注意事项Skill本质上是在你的机器上执行代码所以安全性要重视。几个原则第一只安装可信来源的Skill不要随便装网上来路不明的Skill第二Skill的配置文件里如果有执行外部命令的配置要仔细审查第三定期检查已安装Skill的更新及时修复安全漏洞。Skill Creator生成的Skill也要审查。虽然它是基于模板生成的但模板本身可能有安全风险。我一般会看一眼生成的配置文件确认没有可疑的命令执行或文件读写操作。6.5 我的日常使用习惯最后分享几个我日常使用中的小习惯。第一我建了一个~/.codex/skills/backup/目录定期把Skill配置备份进去。有一次我误删了一个Skill的配置靠备份五分钟就恢复了。第二我给每个Skill写了简短的备注记录它的用途和注意事项放在配置文件的description字段里。时间长了容易忘有个备注省事很多。第三我每周花十分钟看看Skill的更新日志了解新功能和已知问题。这个习惯帮我提前避开了好几次版本升级导致的故障。这套三个Skill的组合我用了大半年从最初的磕磕绊绊到现在基本顺畅中间踩的坑都写在上面了。你要是刚开始用建议先从Any Search入手用熟了再加Superpowers最后上Skill Creator。一步步来比一次性全装上手忙脚乱要好得多。