← 全部文章

编辑样稿 / CODEX · SKILLS · 7 MIN · 实践笔记

Codex 安装 Skills 之后,才真正从「会写代码」变成「会做事」

提示词解决一次任务,Skill 开始积累一套能够重复执行的工作方法。

最近我一直在 Codex 里做几件事,改个人网站,整理知识,搭跨境电商流程,还要反复检查页面和内容有没有真的完成。

一开始,我也是有什么需求就写一段提示词。写得短了,Codex 容易漏掉步骤。写得长了,下一次还得把同一套要求重新贴一遍。最麻烦的不是多打几行字,而是每次都要重新解释,资料从哪里来,哪些东西不能猜,做完以后用什么证明。

做着做着我发现,提示词更像一次口头交代。它可以解决眼前的问题,却很难自然变成下一次还能复用的工作方法。

Skills 刚好补上了这一层。

按照 OpenAI Docs 的定义,一个 Skill 可以把任务说明、参考资料、模板和脚本放在一起。Codex 看到任务与 Skill 的用途相符时,可以自动选择它,也可以由我们用名称明确调用。它不是给 Codex 多装一个按钮,而是把一套做事方法交给 Codex。

提示词告诉 Codex 这次做什么,Skill 告诉它这类事情以后都该怎么做。

如果你刚开始使用 Skills,我觉得不用一上来就自己写。Codex 已经提供了 Skill Installer。在 Codex 里输入 $skill-installer,说明你想安装的 Skill,或者直接给出精选 Skill 的名称。官方示例是 $skill-installer linear。安装后 Codex 通常会自动识别,如果没有出现,再重启一次 Codex。

在 ChatGPT 桌面端,也可以从侧边栏的 Skills 页面查看和探索已经创建的 Skills。在 Codex CLI 或 IDE 扩展里,可以运行 /skills,也可以输入 $ 选择并调用某个 Skill。

安装只是开始,真正有意思的是把自己的工作变成 Skill。

我现在判断一个流程是否值得做成 Skill,会看一个很朴素的信号。同样的要求,我是不是已经解释过三次了?如果答案是肯定的,差不多就该动手了。

可以直接调用 $skill-creator。你要告诉它这项工作什么时候触发,从哪里读取资料,要经过哪些步骤,最终产出什么,以及哪些事情绝对不能做。一个最小的 Skill 其实就是一个目录和一份 SKILL.md。需要确定性处理时再加 scripts,需要长期参考的规则再加 references,需要复用模板时再加 assets。

这块看着简单,实际最容易犯的错是贪大。我早期也会想把研究、写作、生成图片、发布和复盘全塞进同一个 Skill。结果说明越来越长,边界越来越模糊,Codex 反而不知道哪一步才是主任务。

后来我更愿意让一个 Skill 只负责一件事。产品事实确认是一个,标题生成是一个,图片审核是一个,发布验证又是一个。它们可以串起来,但每一个都要有清楚的输入、输出和停止条件。

还有一点很重要,装得多不等于能力强。Skill 的 description 决定 Codex 什么时候会想到它。如果描述太宽,什么任务都可能误触发。如果描述太窄,真正需要时又找不到。所以装完以后最好拿一个真实任务测试,看它是否在该出现的时候出现,在不该出现的时候保持安静。

我自己的感受是,Skills 最有价值的地方并不是省下几段提示词。它开始让经验拥有结构,让一次踩坑变成下一次的检查项,让一个人的做法有机会变成团队可以复用的流程。

这才是我理解的 Codex。

不只是会写代码,而是能够在清楚的规则、资料和验证标准里,把一件事情做完。本文关于安装、调用和目录结构的说明,依据 OpenAI Docs 的 Build skills 文档