AI Engineer World's Fair 2026
Building Great Agent Skills: The Missing Manual
Matt Pocock · AI Hero
摆脱「skill 地狱」的检查清单:触发(谁来调用、承担什么负载)、结构(步骤与参考分开,分支内容放在指针后面)、引导(用「垂直切片」这类引导词)、修剪(单一事实来源、清理沉积、删掉无效指令)。
内容概要
skills 不缺,缺的是判断哪些有效、怎样组合。Matt 提出四个维度。触发:模型调用的 skill 把描述放进上下文当作「上下文指针」,方便但持续占 token、增加选择不确定性(上下文负载);用户调用的 skill 不占上下文,但要操作者记得何时用(认知负载)。结构:把 skill 拆成步骤和参考,例如 to-prd skill 的步骤是找上下文、和用户确认测试接缝、写 PRD,参考是「什么是测试接缝」和 PRD 模板;只在某个分支用到的模板放在指针后面。引导:用简洁有分量的引导词并在 skill 里反复出现(例如反复强调 vertical slice 而不是长篇警告「不要横向实现」),再看推理轨迹里是否采用;如果 agent 总是草草带过某个中间阶段,就把它拆成独立 skill。修剪:大 skill 是其他设计问题的症状,去重、清理多人追加形成的沉积、删掉删除后行为不变的「空操作」。
幻灯片截图
截图来自原视频,仅用于评论与学习。
要点(点击时间跳到原视频)
- 0:51
「skill 地狱」:能下载、贡献、组合很多 skills,却说不清它们如何协作、哪些真有效;组织想把操作规程交给 agent,也不知道怎样写成有效 skill。
- 4:23
模型调用 vs 用户调用:前者的描述进入上下文成为「上下文指针」,带来上下文负载和选择不确定性;后者让操作者承担认知负载。要有意识地选择。
- 7:22
把 skill 拆成「步骤」和「参考」。to-prd 例子:步骤 = 找相关上下文、与用户确认测试接缝(人工检查点)、写 PRD;参考 = 测试接缝的解释、PRD 模板。分支特有的模板放在指针后面,不在每次调用时加载。
- 12:23
引导词:例如反复出现的「vertical slice」比长段「不要先做数据库再做 API 再做前端」更有效;agent 会在推理和输出里复述这些词,强化预期做法。检查推理轨迹确认它确实采用了。
- 15:12
如果 agent 总是急着跳过某个重要的中间阶段,把这个阶段拆成单独的 skill,避免后续目标过早分散它的注意力。
- 17:07
修剪:单一事实来源(步骤、模板、定义不重复);清理「沉积」(多人往同一个 markdown 里只加不删);删掉过期引用和删除测试表明不影响行为的「空操作」。
可以用在日常工作里的
- 上下文
盘点团队的 skills:哪些应改为用户手动调用以减少上下文负载,哪些需要模型自动触发。
- 上下文
每个 skill 拆成步骤 + 参考,模板与长文档放在引用文件里按需读取。
- 上下文
定期做删除测试:去掉一段后行为不变,就删掉它。