快速掌握 Codex 渐进加载 Skills,高效拓展自动化工作流

本文围绕快速掌握 Codex 渐进加载 Skills,高效拓展自动化工作流整理关键信息和实用建议，帮助读者快速了解主题重点。

Codex Skills 是 Codex 拓展任务能力的核心机制，遵循开源标准，以文件夹形式封装指令、脚本与资源。依托渐进式加载机制，它可节约 Token、提升运行效率。本文完整讲解 Skills 定义、核心优势，手把手演示内置工具创建与手

Codex Skills 是 Codex 拓展任务能力的核心机制，遵循开源标准，以文件夹形式封装指令、脚本与资源。依托渐进式加载机制，它可节约 Token、提升运行效率。本文完整讲解 Skills 定义、核心优势，手把手演示内置工具创建与手动搭建两种方式，同时介绍技能调用方法，并搭配创建文件夹实战案例，帮助开发者快速掌握 Codex 技能拓展。

一、Skills

什么是 Codex Skill?

Skills 是任务特定的能力包，本质上就是一个文件夹，包含指令、脚本和资源。它遵循开源标准 http://agentskills.io。

一个 Skill 的核心是 SKILL.md 文件，用 Markdown 格式编写，包含元数据和详细指令。

Skills 的设计非常聪明：采用“渐进式加载”（progressive disclosure）机制。Codex 在初始上下文只加载 Skill 的名称和简短描述（避免浪费 token），只有当真正需要时，才读取完整指令。这让 Codex 在处理长任务时保持高效。

Skills 的主要优势：

1. 可靠执行特定工作流：如自动修复 CI 失败、集成任务管理工具等。
2. 易共享：团队或社区可以轻松分发 Skill，支持跨平台（如从 Claude 迁移到 Codex）。
3. 上下文高效：不污染主提示，只在需要时激活。
4. 可扩展：支持可选脚本、参考文档和资源文件。

Codex 自带几个系统 Skill，如 plan（规划复杂任务）、skill-creator（创建新 Skill）和 skill-installer（安装 Skill）。

二、如何创建 Skills?

2.1 使用内置 skill-creator

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

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

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

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

2.2 手动创建

在合适的目录下创建一个文件夹（文件夹名即 Skill 名），然后添加 SKILL.md 文件。基本格式如下：

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

可选添加子文件夹：

1. scripts/：存放可执行脚本。
2. references/：参考文档。
3. assets/：模板或其他资源。

Skill 存放位置（优先级从高到低）：

1. 项目当前目录：.codex/skills/（适合当前 repo 专用）。
2. 项目根目录：repo_root/.codex/skills/（团队共享）。
3. 个人全局：~/.codex/skills/（默认位置）。
4. 系统内置：Codex 自带，无法覆盖。

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

三、如何使用 Skills?

使用 Skills 有两种方式：

1. 显式调用（推荐精确控制）：
   1. 在提示中直接写 $.skill-name（例如 $.linear）。
   2. 或在 CLI/IDE 中使用 /skills 命令选择。
2. 自动选择（更自然）：
   1. Codex 会根据你的任务描述，智能判断并加载匹配的 Skill（依赖 description 字段写得准确）。

输入 codex 启动，然后打一个斜杠，就可以看到 Skills 了。

输入 /skills 进入技能菜单，然后输入 skill-creator。也可以直接通过 $ 触发功能菜单。

四、实战案例

4.1 输入命令：

$skill-creator firstskill

4.2 输出内容：

我将使用 skill-creator，因为你明确要创建一个新技能 firstskill。先进入第 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 输出内容：

已按 skill-creator 建好 makefolder 技能骨架与脚本，保持精简可用。

变更说明

1. 新增 skills/makefolder/SKILL.md，包含触发描述与使用规则
2. 新增 skills/makefolder/scripts/make_folder.ps1，用于在当前项目创建单一文件夹

文件位置

1. skills/makefolder/SKILL.md
2. skills/makefolder/scripts/make_folder.ps1

下一步建议

1. 试用脚本：./skills/makefolder/scripts/make_folder.ps1 test
2. 如果你想改成中文说明或加入更多校验规则，告诉我偏好。

然后项目目录下，就会有一个 Skills 了。Skills 下面有一个子文件夹叫 makefolder。具体目录结构如下：

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

总结

本文系统介绍 Codex Skills 相关知识，先阐明技能的定义、规范与低耗加载等核心优势，自带规划、创建、安装等系统技能。文章讲解内置指令生成、手动编写配置两种创建方案，说明多优先级存放目录，介绍显式调用与自动匹配两种使用方式，并以新建文件夹为例完整实操演示，帮助读者灵活拓展 Codex 自动化工作流。

以上内容可作为基础参考，实际处理时再结合具体场景灵活调整。