如何写出智能体真正会加载的 SKILL.md

先写名称、描述和何时使用。 多数智能体在打开正文之前，只读这三处。一份永远不会被加载的漂亮流程是死重量。

写作清单

1. 选小写字母、数字和连字符组成的 slug，控制在 64 个字符以内。
2. 描述以触发语开头：“当…时使用”。写上用户真会打出来的名词。
3. 写明技能不覆盖什么，免得抢走无关任务。
4. 步骤用短编号。每步一个动作。
5. 长示例放进 references/。让 SKILL.md 一屏就能加载完。
6. 提交前跑一遍校验器。

会真正被加载的描述

• 好：当用户要合并、拆分或填写 PDF（包括扫描件）时使用。
• 弱：面向现代团队的强大 PDF 工具箱。它没说何时。

用 SKILL.md 生成器出一份草稿，再改触发句，直到陌生人也能判断该不该调用它。