Skills

用 agent skills 以特定任务的能力扩展 Codex。skill 把指令、资源和可选脚本打包起来，让 Codex 能可靠地遵循某个工作流。Skills 是可复用工作流的编写格式；插件（plugins）通过 ChatGPT 和 Codex 共用的通用插件目录分发可复用的 skills 和连接器。用 skills 来设计工作流本身，想让别人安装时再把它打包成插件。独立的 skills 在 ChatGPT 桌面应用、Codex CLI 和 IDE 扩展里可用。

渐进式披露

Skills 用渐进式披露高效管理上下文：Codex 一开始只看到每个 skill 的名字和描述，决定使用某个 skill 时才加载完整的 SKILL.md 指令。在 Codex 里，初始列表还包含每个 skill 的文件路径；为了避免挤占提示的其余部分，这个列表最多占用模型上下文窗口的 2%（上下文窗口未知时是 8,000 个字符）。装了很多 skills 时，Codex 先缩短 skill 描述；skill 集很大时，Codex 可能从初始列表里省略一些 skill 并显示警告。这个预算只适用于初始 skills 列表，Codex 选中某个 skill 时仍读取它完整的 SKILL.md。

一个 skill 是带有 SKILL.md 文件的目录，外加可选的脚本和参考资料。SKILL.md 必须包含 name 和 description。

如何调用

Codex 可以用两种方式激活 skill：

1. 显式调用：在提示里直接包含 skill。在 Codex CLI 或 IDE 扩展里运行 /skills 或输入 $ 来提及某个 skill
2. 隐式调用：任务与 skill 的 description 匹配时，Codex 可以自己选择该 skill

因为隐式匹配取决于 description，要写简洁、范围和边界清晰的描述，把关键用例和触发词放在前面，这样即使描述被缩短，宿主仍能匹配到这个 skill。

创建 skill

如果你已经知道工作流，演示比描述更容易，可以用 Record & Replay：录制器捕获工作流、检查步骤，并根据演示起草可复用的 skill。如果你想用描述的方式，用内置的创建器，在 Codex 里这样调用：

$skill-creator

创建器会询问 skill 做什么、何时触发、以及它是只含指令还是还要包含脚本（默认只含指令）。也可以手动创建：建一个含 SKILL.md 文件的文件夹，文件以 YAML frontmatter（name、description）开头，正文写指令。在 ChatGPT 桌面应用里，侧边栏的 Skills 可以查看和探索你在各个项目里创建的 skills。skills 在插件里的分发方式（插件目录、安装、构建插件）见官方 Plugins 和 Build plugins 页。