Codex Skills是什么?Codex 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 的核心优势

• 可靠运行特定工作流：涵盖集成任务管理工具、自动修复 CI 失败等用途。
• 便于共享：Skill 可由团队或社区便捷分发，并支持跨平台（如从 Claude 迁移到 Codex）。
• 高效利用上下文：不会干扰主提示，仅在有需要时激活。
• 具备扩展性：可以加入可选脚本、参考文档及资源文件。

plan（规划复杂任务）、skill-creator（创建新 Skill）与 skill-installer（安装 Skill），都是 Codex 自带的系统 Skill。

二、Skills 的创建方法

2.1 内置 skill-creator 的使用

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

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

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

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

2.2 手动创建

先在适当目录中建立一个文件夹，文件夹名称就是 Skill 名称，再向其中加入 SKILL.md 文件。其基本格式如下：

---
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 自动化工作流，可参考本文的新建文件夹完整实操。此前文章依次说明显式调用和自动匹配两种使用方式、多优先级存放目录，以及手动编写配置与内置指令生成两种创建方案；同时还梳理了 Codex Skills 的技能定义、规范、低耗加载等核心优势，并介绍自带的规划、创建、安装等系统技能。