iShane.cn

是什么 存放Skill的测试用例和评估规则，用于验证Skill的执行结果是否符合预期。 适合放什么 tests/ ├── test_cases.md # 测试场景描述 ├── fixtures/ # 测试输入数据 │ ├── input.csv │ └──

是什么 存放少样本（few-shot）输入输出示例，帮助Agent理解"输入长什么样、输出应该长什么样"。 为什么需要它 对于输出格式复杂、风格要求严格的Skill（如代码生成、文档撰写），光靠文字描述"输出格式"往往不够精确。直接给Agent看几个真实的输入输出样例，效果远好于长篇大论的规则描述：

是什么 存放Skill执行过程中需要的模板文件、样例文件、字体、图片等静态资源。与references/的区别在于：references/是给Agent阅读的文档，assets/是给Agent使用的素材。 适合放什么 资源类型 示例 用途 文档模板 report_template.docx Agen

是什么 存放按需加载的详细参考文档。当Agent在执行过程中需要查阅专业知识时，才去读取这些文件，而不是在激活Skill时一次性全部加载。 为什么需要它 SKILL.md正文有500行/5000tokens的软限制。如果把所有参考资料都塞进正文，会导致： 超出上下文预算，Agent无法完整读取 无关

好，现在我们来系统讲解Skill 的目录结构。前面我们讲的SKILL.md是Skill的"大脑"，而目录结构则是Skill的"身体"——它决定了脚本、参考文档、模板等资源如何组织，以及Agent在执行时如何按需加载它们。 一、整体结构总览 最小可用结构 一个 Skill 最少只需要一个文件： my-

Body Content（正文）是SKILL.md的核心灵魂，本质上是写给 Agent的SOP说明书。它位于frontmatter之后，负责告诉Agent激活后具体如何执行任务，并严格遵循≤500行（硬校验）、≤5000tokens（软校验）的篇幅限制，超出内容必须剥离至references/目录。

allowed-tools字段 allowed-tools字段是SKILL.md中唯一直接控制 Agent 运行时行为的字段：它本质上是在为Skill划定一个"工具沙箱"，决定Agent激活这个 Skill后能用什么、不能用什么。如果说description控制的是"什么时候激活"，那allowed

metadata 字段 metadata字段是SKILL.md中的**"万能收纳箱"**：当其他5个标准字段（name、description、license、compatibility、allowed-tools）装不下你的信息时，所有额外内容统统往这里塞。 metadata是什么 metadat

license字段 license用于声明该Skill的开源许可协议，告诉使用者"这个技能可以怎么用、能不能商用、需不需要署名"等法律问题。 规范 可选字段，不填也不会影响 Skill 的正常运行 填写内容为许可证名称或对捆绑许可证文件的引用 无字符数限制说明，但建议保持简短 常见写法 # 方式一：

description字段 description是SKILL.md中最具战略价值的字段——它直接决定了Agent能不能找到你、会不会用你。如果说name是Skill的"身份证号"，那description就是它的"简历摘要"，Agent在海量 Skill中筛选时，完全依赖它来判断"这个Skill跟