最重要文件是SKILL.md

通过这个SKILL.md文件告诉AI agent：

遇到哪类任务时，我们进行调用这个skill
遵守什么样的流程
使用哪些工具
需要参考哪些文件
以何种形式输出
image-20260716152050269

SKILL.md文件详解#
基本模版：

name: your-skill-name
description: 一句话描述该 Skill 的功能和使用场景

Skill 名称

使用指引

[给 AI 的分步骤行为指引]

示例

[该 Skill 的具体使用示例]

References/#
该文件夹用于存放较长的 参考资料、规则文档、资料清单等。

例如：可能ai搜索的数据集等信息链接不可用或者失效，我们则可以创建一个datasets.md文档放到这个里面，里面存放常用的一些数据集下载链接。

Agents/openai.yaml#
该文件主要用于配置codex app的ui展示、调用策略，通常放在Skill目录下的agent/文件夹中。

Skill的触发机制#
显式指定：用户直接在对话窗口中，通过斜杠命令或者$快捷符，显式调用
隐式调用：根据任务语义自动匹配：即使用户没有明确调用该Skill，只要任务明显符合某个Skill的适用场景，codex也会自动使用
多Skill协同使用：可以在一个复杂任务skill中，说明该任务需要调用其他多个skill
用户可以明确要求不使用某个Skill

Skill设计原则#