iShane.cn

skill规范详解(10)— examples目录

2026/05/11
11
0

是什么

存放少样本(few-shot)输入输出示例,帮助Agent理解"输入长什么样、输出应该长什么样"。

为什么需要它

对于输出格式复杂、风格要求严格的Skill(如代码生成、文档撰写),光靠文字描述"输出格式"往往不够精确。直接给Agent看几个真实的输入输出样例,效果远好于长篇大论的规则描述:

## 示例
以下是标准的单元测试模式,请参考:
- `examples/unit-test.ts`:标准单元测试写法
- `examples/integration-test.ts`:API 集成测试写法

编写规范

  • 每个示例文件应自包含,包含完整的输入和预期输出
  • 文件名应体现示例的场景或类型
  • 示例数量控制在 2–5 个,过多会浪费 Token

相关文章

认识Agent skill
skill规范详解(1)— 目录结构和name字段
skill规范详解(3)— license字段
skill规范详解(3)— license字段
skill规范详解(4)— metadata字段
skill规范详解(5)— allowed-tools字段
skill规范详解(6)— content正文部分
skill规范详解(7)— scripts目录
skill规范详解(8)— references目录
skill规范详解(9)— assets目录
skill规范详解(10)— examples目录
skill规范详解(11)— tests目录