🔥小龙报：个人主页
🎬作者简介：C++研发，嵌入式，机器人，AI等方向学习者
❄️个人专栏：《Codex应用实战》
✨ 永远相信美好的事情即将发生

---

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）。
• 上下文高效：不污染主提示，只在需要时激活。
• 可扩展：支持可选脚本、参考文档和资源文件。

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 如何执行任务。
- 使用哪些工具或库
- 处理边缘情况
- 输出格式要求
- 示例等

可选添加子文件夹：

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

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

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

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

三、如何使用 Skills?

使用 Skills 有两种方式：

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

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

2. 自动选择（更自然）：

   • 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 技能骨架与脚本，保持精简可用。

变更说明

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

文件位置

• skills/makefolder/SKILL.md
• 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 自动化工作流。