Codex Skills是什么?Codex Skills高效扩展自动化任务的完整教程

作为 Codex 扩展任务能力的核心机制，Codex Skills 依照开源标准，用文件夹封装指令、脚本和资源。渐进式加载机制既能节约 Token，也可提高运行效率。本文将完整说明 Skills 的定义与核心优势，逐步演示内置工具创建和手动搭建两种方式，再介绍技能调用方法，并结合创建文件夹的实战案例，帮助开发者快速掌握 Codex 技能扩展。

一、Skills

什么是 Codex Skill?

一个文件夹连同其中的指令、脚本和资源，共同构成面向特定任务的能力包 Skills；其采用的开源标准为 http://agentskills.io。

一个 Skill 的核心是 SKILL.md 元数据与详细指令均写入文件，编写时采用 Markdown 格式。

Skills 采用了巧妙的“渐进式加载”（progressive disclosure）机制：初始上下文中，Codex 只加载 Skill 的名称与简短描述，以免浪费 token；直到确有需要时，才会读取完整指令。因此，面对长任务时 Codex 仍可高效运行。

Skills 的主要优势

• 可靠执行特定工作流：例如集成任务管理工具、自动修复 CI 失败等。
• 易共享：Skill 能在团队或社区中便捷分发，也支持跨平台，例如从 Claude 迁移到 Codex。
• 上下文高效：仅在需要时激活，不会污染主提示。
• 可扩展：可选择加入脚本、参考文档及资源文件。

plan（规划复杂任务）、skill-creator（创建新 Skill）以及 skill-installer（安装 Skill），都属于 Codex 自带的几个系统 Skill。

二、如何创建 Skills

2.1 内置 skill-creator 的使用

在 Codex 中直接调用 $skill-creator，然后描述你想要的 Skill 功能。

例如：“使用 pdfplumber 库，创建一个处理 PDF 文件的 Skill，从中提取文本和表格。”

文件夹结构和 SKILL.md 模板会由 Codex 自动生成。

你还可以先用 $plan Skill 规划，再结合 skill-creator 完善。

2.2 手动创建

添加 SKILL.md 文件前，需选定合适目录并新建文件夹；该文件夹的名称就是 Skill 名。以下为基本格式：

---
name: your-skill-name
description: 当用户提到 XXX 时使用这个 Skill，帮助完成 YYY。
metadata:
    short-description: 可选的简短用户可见描述
---
# Skill 标题
这里写详细指令：一步步指导 Codex 如何执行任务。
- 使用哪些工具或库
- 处理边缘情况
- 输出格式要求
- 示例等

还可选择添加子文件夹：

• scripts/：用于存放可执行脚本。
• references/：用于存放参考文档。
• assets/：用于存放模板或其他资源。

Skill 的存放位置按优先级由高到低排列如下：

• 项目当前目录：.codex/skills/（适用于当前 repo 专用场景）。
• 项目根目录：repo_root/.codex/skills/（供团队共享）。
• 个人全局：~/.codex/skills/（属于默认位置）。
• 系统内置：由 Codex 自带，不能覆盖。

更高优先级的 Skill 会覆盖同名低优先级 Skill，便于自定义覆盖。

三、如何使用 Skills

Skills 的使用方式共有两种：

显式调用（推荐用于精确控制）：

• 直接在提示中写入 $.skill-name（例如 $.linear）。
• 或者在 CLI/IDE 中使用 /skills 命令进行选择。

自动选择（使用起来更自然）：description 字段是否写得准确，决定了 Codex 能否从任务描述中作出智能判断，并加载相匹配的 Skill。

要查看 Skills，可先用 codex 完成启动，之后输入一个斜杠。

输入 /skills 打开技能菜单，随后输入 skill-creator。也能直接通过 $ 唤起功能菜单。

四、实战案例

4.1 输入命令

$skill-creator firstskill

4.2 输出内容

由于你明确要求创建新技能 firstskill，我将使用 skill-creator。

请简短地用中文作答，以便进入第 1 步并明确触发场景与用途：

1. 这个 skill 具体用于解决什么任务？
2. 以“用户会怎么提问”为内容，写出 2–3 句触发语句示例。
3. 如果需要固定内容，请说明是流程、脚本还是参考资料，并标明其类型（scripts / references / assets）；如果不需要，也请回答。
4. 期望输出采用什么形式，例如文字说明、命令或模板文件？

技能命名、目录结构以及最小 SKILL.md 草案，将在确认完成后由我给出。

输入内容：

已收到，将继续使用 skill-creator。

请先确认触发方式与命名，简短回复即可：

1. 触发示例：请提供 2–3 条用户可能提出的问题，使用中文即可。
2. 技能名称：建议 make-folder 或 create-folder，你倾向于选择哪一个？
3. 是否需要脚本？若只通过命令行创建目录，也可以不添加 scripts/。你是否希望加入脚本？

输入内容：

触发演示例子：请帮我创建文件夹test，我要创建一个文件夹，创建文件夹等；名字就叫makefolder；我希望包含脚本。

4.3 输出内容

精简可用的 makefolder 技能骨架及脚本已经建成，创建过程遵循 skill-creator。

变更说明

• 新增 skills/makefolder/SKILL.md，其中包括触发描述和使用规则
• 新增 skills/makefolder/scripts/make_folder.ps1，作用是在当前项目中新建单一文件夹

文件位置

• skills/makefolder/SKILL.md
• skills/makefolder/scripts/make_folder.ps1

下一步建议

运行脚本试用：./skills/makefolder/scripts/make_folder.ps1 test

如果需要改为中文说明，或希望增加更多校验规则，请告诉我你的偏好。

完成后，项目目录下便会出现一个 Skills。

在 Skills 下方有一个名为 makefolder 的子文件夹。

其具体目录结构如下：

skills/
└── makefolder/
    ├── SKILL.md
    └── scripts/
        └── make_folder.ps1

总结

从技能的定义、规范和低耗加载等核心优势入手，本文系统梳理 Codex Skills，并说明其自带的规划、创建、安装等系统技能。创建部分涵盖手动编写配置和内置指令生成两种方案，随后整理多优先级存放目录及自动匹配、显式调用两类使用方式。最后以新建文件夹为案例完成全流程实操，让读者能够灵活拓展 Codex 自动化工作流。