AI Agent #blog#ai#agent#skill 4,406 字 · 约 12 分钟
写了几十个Skill之后，我总结出这套工程方法：从「触发不了」到「生产可用」
一套把 Skill 写对、写稳、能长期维护的工程方法，来自写完几十个 Skill 的实践总结。Skill 是三层而不是一个文件：L1 元数据负责路由，L2 正文控制行为，L3 资源提供事实与确定性。绝大多数 "触发不了" 是路由失败，靠写清 "做什么、何时用、何时不用" 的 description 解决；执行漂移靠编号步骤、停止条件、"规则 + 原因" 的写法解决。护栏把 "应该" 变成可机器校验的检查点，失败处理分级。拆合看 "变化原因" 而非文件长度。四个评估指标（路由、步骤遵循、检查点、任务成功率）直接定位该改哪里。文末附版本化、trace 调试流程与可直接抄的检查清单。