Codex CLI Skills

Skills（技能）是 Codex CLI 的扩展机制，允许你创建自定义的工作流程和自动化任务。通过技能，你可以定义 Codex 在特定场景下的行为方式。

什么是技能？

技能是一种可配置的行为模式，它告诉 Codex 如何处理特定类型的任务。你可以创建自己的技能来：

1. 自动化常见的开发任务
2. 定义特定领域的处理流程
3. 定制代码审查的标准
4. 创建项目特定的模板和规则

技能系统让 Codex 能够适应不同项目和工作流程的需求，就像为你的团队分配了一位专职开发助手。

技能目录

Codex 会从以下位置加载技能：

配置技能目录

自定义技能目录

技能文件结构

每个技能是一个独立的文件夹，包含以下文件：

skill-name/├── skill.md          # 技能定义文件（必需）└── (可选的辅助文件)

skill.md 文件格式

技能定义示例

技能元数据

每个技能文件的开头必须包含 YAML 格式的元数据：

当你的输入匹配技能的 trigger 时，Codex 会自动使用该技能来处理任务。

创建自定义技能

让我们创建一个简单的技能作为示例：

步骤 1：创建技能目录

创建技能文件夹

步骤 2：编写技能定义

创建 skill.md

步骤 3：使用技能

现在，当你输入包含"测试"相关的内容时，Codex 会自动使用这个技能：

触发技能

内置技能

Codex 自带了一些常用技能：

你可以覆盖内置技能的行为，创建符合项目需求的版本。

技能优先级

当多个技能匹配时，Codex 按以下优先级选择：

1. 精确匹配（完全一致的触发词）
2. 包含匹配（输入包含触发词）
3. 语义匹配（AI 判断相关性）

强制使用特定技能

你可以通过斜杠命令强制使用某个技能：

强制使用技能

高级技能配置

条件触发

你可以通过配置让技能在特定条件下触发：

条件触发示例

多步骤任务

技能可以定义复杂的多步骤流程：

多步骤技能

技能最佳实践

命名规范

1. 使用清晰、描述性的名称
2. 名称应该表达技能的功能
3. 避免使用中文名称（可能导致编码问题）

触发词选择

1. 选择常用的关键词
2. 避免过于宽泛的触发词
3. 考虑用户的自然表达方式

技能粒度

1. 保持技能职责单一
2. 一个技能解决一类问题
3. 复杂流程可以通过技能组合实现

好的技能应该让用户感觉"Codex 懂我的需求"，而不是需要学习特殊语法。

管理技能

列出可用技能

查看技能列表

禁用技能

如果你不想使用某个技能，可以删除对应的文件或移动到其他目录。

更新技能

修改技能文件后，需要重启 Codex 才能生效。

技能示例库

OpenAI 官方提供了一些预制技能供你参考和使用：

访问 GitHub 仓库查看更多示例：https://github.com/openai/codex/tree/main/skills

常见问题

Q: 技能不触发？

检查技能文件的元数据格式是否正确，确保 YAML 头部格式正确且文件以 .md 结尾。

Q: 如何调试技能？

可以在 Codex 中使用 /debug 命令查看技能匹配的详细信息。

Q: 技能会影响 Codex 的正常行为吗？

技能只是提供指导方针，Codex 仍然会进行独立判断。如果技能配置不当，Codex 会使用默认行为。