Skill基础介绍
skill基本组成
通过这个SKILL.md文件告诉AI agent：
- 遇到哪类任务时，我们进行调用这个skill
- 遵守什么样的流程
- 使用哪些工具
- 需要参考哪些文件
- 以何种形式输出
SKILL.md文件详解
基本模版：
bash
---
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设计原则
- 目标明确：一个Skill最好只解决一类问题
- 通常skill拆的更细，会更省token，也更容易准确触发
- 但最佳拆法也不是越碎越好，而应该是让每个Skill对应一个清晰、常见、规则独立的任务
- 边界清晰：要说明Skill做什么，也要说明不做什么
- 步骤可执行：Skill不能只写理念，要写具体动作
- 输入输出规范：要明确用户需要提供什么，以及最终返回什么