如果你正在使用 Codex CLI，却发现自己一遍又一遍地重复编写相同的指令，那么你很可能没有充分发挥这个工具的潜力。Codex 提供了一项强大的功能——Skills（技能），它允许你将可复用的工作流打包封装，并按需赋予 AI 代理新的能力。本文将带你全面了解 Codex Skills 的原理、结构和使用方法。

什么是 Codex Skills？

Codex Skill 是一个封装了可复用工作流的文件夹。你只需将常用指令写入一次，保存在 Skill 中，之后每次调用即可自动执行，无需重复输入。

Skills 的核心价值在于：

• 扩展 Codex 的能力：为 AI 代理注入特定领域的专业知识。
• 提升效率：避免重复劳动，节省时间。
• 保持上下文干净：只在需要时加载相关内容，减少 token 消耗。

Skills 如何工作？——渐进式披露（Progressive Disclosure）

Codex Skills 采用一种称为 渐进式披露（Progressive Disclosure） 的机制，以优化性能和资源使用：

• 启动阶段（Startup）：Codex 仅加载所有技能的名称和描述。
• 按需加载（On Demand）：当你请求某个技能时，Codex 才会完整加载其 SKILL.md 文件。
• 高效运行（Efficient）：仅在实际使用时消耗 tokens，保持上下文简洁、响应迅速。

技能的存储位置（Skill Scopes）

Skills 可以存放在多个层级，适用于不同范围的使用场景：

范围	说明
系统级（System Level）	Codex 内置的默认技能
全局级（Global Level）	对所有项目生效
用户级（User Level）	仅对当前用户可用
仓库级（Repository Level）	仅限于当前项目目录

这种分层设计让你可以灵活管理技能的可见性和复用性。

如何安装现有技能？

在安装或创建技能前，请确保你的 Codex CLI 已更新至最新版本。旧版本可能不支持 Skill Creator 或 Skill Installer 功能。

安装步骤：

1. 在终端中启动 Codex。
2. 输入 $。
3. 选择 Skill Installer。
4. 输入技能名称，或粘贴 GitHub 仓库 URL。
5. Codex 将自动完成安装。
6. 重启 Codex。
7. 再次输入 $，即可看到新安装的技能。

💡 提示：安装完成后务必重启 Codex，否则新技能不会生效。

如何创建自定义技能？

Codex 提供两种创建技能的方式：

方法 A：使用 CLI 创建器（Skill Creator）

1. 启动 Codex，输入 $。
2. 选择 Skill Creator。
3. 输入技能名称。
4. 输入主指令（instruction）。
5. Codex 会通过交互式问答帮你完善技能结构。

⚠️ 注意：如果生成的技能未保存在 .codex/skills/ 目录下，你需要手动安装（参考上一节“安装现有技能”的流程）。

方法 B：手动创建（推荐）

手动创建能让你完全掌控技能结构，适合高级用户。一个标准的 Skill 目录结构如下：

my-skill/
├── skill.md          # 必需：主指令文件
├── scripts/          # 可选：用于执行逻辑的脚本（如 Python、Shell）
├── references/       # 可选：参考文档、模板等
└── assets/           # 可选：图片、配置文件等资源

skill.md 模板示例：

如果觉得自己写的skill不好，请遵循以下指南：

一技一能。每个技能应专注于单一任务。
零上下文假设。技能不应依赖之前的消息，必须自成一体。
优化描述。若技能未被触发，需调整其描述和示例。
优先使用指令而非脚本。在复杂代码脚本前，优先采用文本说明。

结语

Codex Skills 是提升开发效率、实现提示工程自动化的关键工具。通过封装常用工作流，你不仅能减少重复劳动，还能构建可共享、可维护的 AI 工作单元。无论是安装社区技能，还是创建自己的专属技能，Codex 都为你提供了灵活而强大的支持。

立即升级你的 Codex CLI，开始构建你的第一个 Skill 吧！

---