如何写好一个 Skill
如何写好一个 Skill？如果只从表面看，Skill 很容易被理解成更长的 Prompt。但实际用下来，Skill 更像是给 Agent 装上的一块可复用能力模块：它告诉模型什么时候应该使用这套方法、具体该怎么执行、执行到什么程度算完成、如何验证自己做对了。 因此，写好一个 Skill 的关键，不是把经验全部塞进 SKILL.md，而是把一类任务中真正会影响结果的知识，组织成 Agent 能稳定调用的工作流。 暂时无法在飞书文档外展示此内容 Skill 是什么？在 Agent Skill 的定义里，一个 Skill 本质上是一个文件夹，里面至少包含一个 SKILL.md 文件。SKILL.md 里会写元信息，比如 name 和 description，也会写具体的执行说明。除此之外，一个 Skill 还可以附带脚本、参考文档、资产文件等资源。 一个典型结构大概是这样： my-skill/ ├── SKILL.md ├── scripts/ ├── references/ └── assets/ 这个结构背后有一个很重要的设计思想：渐进式披露。 Agent 启动时不会把所有 Skill 的完整内容都塞进上下文，而是只读取每个 Skill 的 name 和 description。当用户任务匹配某个 Skill 的描述时，Agent 才会加载完整的 SKILL.md。如果执行过程中还需要更详细的资料，再按需读取 references/、assets/ 或执行 scripts/ 里的内容。 所以，Skill 的第一个门槛不是“内容写得多不多”，而是：它能不能在正确的时机被触发。 description 是触发器，不是简介Skill 写得再好，触发不了等于零。Agent 只在启动时加载每个 Skill 的 name 和 description，靠这两行决定"要不要把这个 Skill 拉进来"。描述写不好，Skill 永远不会被调用。 很多人会把 description 写成 Skill 简介： ...