Agent Skill 创作的系统化最佳实践

是什么 文章讨论的不是把提示词写长，而是如何把可复用的领域能力封装成边界清晰、可触发、可验证的 Agent Skill。它把高质量 Skill 的来源锚定在真实任务、项目文档、代码评审、故障记录与版本历史，而不是泛化的“最佳实践”知识。

核心方法 先通过一次真实协作记录成功步骤、人工纠偏、输入输出和项目约束，再综合现有材料形成初稿；随后在真实任务中执行，连同成功结果、遗漏、误触发和无效路径一起复盘。内容组织上，Skill 应覆盖一个连贯工作单元，保留 Agent 缺失的知识，删除它本来就会的常识；大型 Skill 则将细节移到 references/，按条件渐进加载。

关键洞察 指令的精确程度应匹配任务脆弱性：允许多种解法时解释目的，风险高或易错处才规定步骤。给出默认路径比罗列菜单更能减少犹豫；程序性指导、gotchas、输出模板、检查清单和“计划—验证—执行”闭环，能把隐性经验转成稳定行为。

边界与风险 过窄会迫使多个 Skill 同时加载，过宽则难以准确激活；过度详尽会稀释重点、挤占上下文并诱发无关操作。文中给出的参考约束是 SKILL.md 控制在 500 行、5,000 tokens 内，但真正标准仍是执行效果：如果没有 Skill，Agent 已能稳定完成任务，就不应继续堆叠规则。