Skip to content

22 · Agent Skills 技能:把一套活儿打包,教会 Codex 自己接

Skill 是把一套成熟流程打包。

你现在这个教程网站就很适合未来做 Skill:每篇文章都要小白视角、步骤化、可复制提示词、常见错误、检查清单、构建验证。

这套流程如果每次都手动说,很烦。 做成 Skill 后,Codex 就更容易自动按流程走。

Agent Skills 工作方式

先判断:这套流程是否重复出现?

Skill 不是给一次性任务用的。

满足这 3 个条件,再考虑做 Skill:

  1. 这件事你会反复做。
  2. 步骤已经跑顺。
  3. 有固定检查清单。

还没跑顺的流程,先不要打包。

先拿你的网站流程做判断

比如这个教程网站,下面这套流程就很适合以后做成 Skill:

  1. 文章要面向小白。
  2. 开头要有行动卡。
  3. 中间要有步骤和提示词。
  4. 后面要有常见错误和检查清单。
  5. 修改后要构建和预览检查。

因为它会反复出现,而且标准已经清楚。

但如果只是今天临时写一篇感想,就不值得做 Skill。 先把流程跑稳定,再打包。

01 先搞懂:Skill 到底是个什么东西

Skill 不是插件,也不是模型。 它更像一份“专项工作说明书”。

适合 Skill 的事情:

  1. 经常重复。
  2. 有固定步骤。
  3. 有固定检查清单。
  4. 需要参考模板或脚本。

不适合 Skill 的事情:

  1. 临时想法。
  2. 只做一次的任务。
  3. 还没跑顺的流程。

02 命门:渐进式披露,省上下文的秘密

一个好 Skill 不应该一上来把所有资料都塞进上下文。

它应该先告诉 Codex:

  1. 什么时候用。
  2. 先读哪份说明。
  3. 需要时再打开哪些参考资料。

这叫渐进式披露。 小白可以理解成:先看目录,需要时再翻具体页。

03 两种触发方式:显式喊名字 vs 隐式自动匹配

显式调用:你点名喊它

比如:

text
请使用“教程文章写作”这个 Skill 来改第 18 篇。

这最稳。

隐式调用:它按描述自己匹配

比如你说:

text
请把这篇文章改成小白能照着做的教程。

如果 Skill 描述写得好,Codex 可能自动匹配。

但隐式触发更依赖描述质量。 新手先用显式调用。

04 放哪决定谁能用:.agents/skills 那套目录

Skill 放的位置决定作用范围。

你可以先问:

text
请告诉我 Codex Skills 通常放在哪些目录。
用户级和项目级有什么区别?
只解释,不要创建文件。

小白先优先用户级或项目级,不要到处乱放。

05 上手:用 $skill-creator 生成、$skill-installer 安装、按需禁用

造:优先用内置的 $skill-creator

如果要创建 Skill,先让工具帮你生成骨架。

text
请使用 skill-creator 帮我设计一个“普通人 AI 教程写作”Skill。
先给设计草案,不要直接创建。

装:用 $skill-installer 拉现成的

如果有现成 Skill,可以安装。 但安装前先看用途和来源。

禁用:不删文件,关掉就行

不想用了,先禁用。 不要一上来删除。

进阶:关掉隐式触发

如果某个 Skill 老是误触发,可以考虑关闭隐式触发。 这属于进阶,先知道有这个选项。

06 动手:3 分钟造一个 Skill,看它“自己被叫出来”

练习流程:

  1. 建一个最小 Skill。
  2. 写清楚适用场景。
  3. 写清楚操作步骤。
  4. 启动 Codex 确认它识别。
  5. 分别测试显式和隐式触发。

第一步:建用户级技能目录

先让 Codex 说明目录,不要直接动手。

第二步:写一个最简单的 SKILL.md

内容只要包含:

  • 什么时候用。
  • 按什么步骤做。
  • 完成前检查什么。

第三步:启动 Codex,确认它认得这个 Skill

确认识别后再测试。

第四步:不点名,用“人话”隐式触发它

看它是否自动匹配。

第五步:对比 $ 显式点名

显式点名更稳定,适合教程演示。

07 小结

Skill 的价值是把成熟流程沉淀下来。

你这个网站后面最值得做的第一个 Skill,就是“普通人 AI 教程写作 Skill”。