最重要文件是SKILL.md通过这个SKILL.md文件告诉AI agent遇到哪类任务时我们进行调用这个skill遵守什么样的流程使用哪些工具需要参考哪些文件以何种形式输出image-20260716152050269SKILL.md文件详解#基本模版name: your-skill-namedescription: 一句话描述该 Skill 的功能和使用场景Skill 名称使用指引[给 AI 的分步骤行为指引]示例[该 Skill 的具体使用示例]References/#该文件夹用于存放较长的 参考资料、规则文档、资料清单等。例如可能ai搜索的数据集等信息链接不可用或者失效我们则可以创建一个datasets.md文档放到这个里面里面存放常用的一些数据集下载链接。Agents/openai.yaml#该文件主要用于配置codex app的ui展示、调用策略通常放在Skill目录下的agent/文件夹中。Skill的触发机制#显式指定用户直接在对话窗口中通过斜杠命令或者$快捷符显式调用隐式调用根据任务语义自动匹配即使用户没有明确调用该Skill只要任务明显符合某个Skill的适用场景codex也会自动使用多Skill协同使用可以在一个复杂任务skill中说明该任务需要调用其他多个skill用户可以明确要求不使用某个SkillSkill设计原则#目标明确一个Skill最好只解决一类问题通常skill拆的更细会更省token也更容易准确触发但最佳拆法也不是越碎越好而应该是让每个Skill对应一个清晰、常见、规则独立的任务边界清晰要说明Skill做什么也要说明不做什么步骤可执行Skill不能只写理念要写具体动作输入输出规范要明确用户需要提供什么以及最终返回什么