AI Engineer World's Fair 2026

Building Great Agent Skills: The Missing Manual

Matt Pocock · AI Hero

2026-06-29 · 21分钟 · 23 万次观看 · AI Engineer

摆脱「skill 地狱」的检查清单:触发(谁来调用、承担什么负载)、结构(步骤与参考分开,分支内容放在指针后面)、引导(用「垂直切片」这类引导词)、修剪(单一事实来源、清理沉积、删掉无效指令)。

观看原视频 ↗

内容概要

skills 不缺,缺的是判断哪些有效、怎样组合。Matt 提出四个维度。触发:模型调用的 skill 把描述放进上下文当作「上下文指针」,方便但持续占 token、增加选择不确定性(上下文负载);用户调用的 skill 不占上下文,但要操作者记得何时用(认知负载)。结构:把 skill 拆成步骤和参考,例如 to-prd skill 的步骤是找上下文、和用户确认测试接缝、写 PRD,参考是「什么是测试接缝」和 PRD 模板;只在某个分支用到的模板放在指针后面。引导:用简洁有分量的引导词并在 skill 里反复出现(例如反复强调 vertical slice 而不是长篇警告「不要横向实现」),再看推理轨迹里是否采用;如果 agent 总是草草带过某个中间阶段,就把它拆成独立 skill。修剪:大 skill 是其他设计问题的症状,去重、清理多人追加形成的沉积、删掉删除后行为不变的「空操作」。

幻灯片截图

模型调用 vs 用户调用:前者的描述进入上下文成为「上下文指针」,带来上下文负载和选择不确定性;后者让操作者承担认知负载。要有意识地选择。
4:52 模型调用 vs 用户调用:前者的描述进入上下文成为「上下文指针」,带来上下文负载和选择不确定性;后者让操作者承担认知负载。要有意识地选择。

截图来自原视频,仅用于评论与学习。

要点(点击时间跳到原视频)

  1. 0:51

    「skill 地狱」:能下载、贡献、组合很多 skills,却说不清它们如何协作、哪些真有效;组织想把操作规程交给 agent,也不知道怎样写成有效 skill。

  2. 4:23

    模型调用 vs 用户调用:前者的描述进入上下文成为「上下文指针」,带来上下文负载和选择不确定性;后者让操作者承担认知负载。要有意识地选择。

  3. 7:22

    把 skill 拆成「步骤」和「参考」。to-prd 例子:步骤 = 找相关上下文、与用户确认测试接缝(人工检查点)、写 PRD;参考 = 测试接缝的解释、PRD 模板。分支特有的模板放在指针后面,不在每次调用时加载。

  4. 12:23

    引导词:例如反复出现的「vertical slice」比长段「不要先做数据库再做 API 再做前端」更有效;agent 会在推理和输出里复述这些词,强化预期做法。检查推理轨迹确认它确实采用了。

  5. 15:12

    如果 agent 总是急着跳过某个重要的中间阶段,把这个阶段拆成单独的 skill,避免后续目标过早分散它的注意力。

  6. 17:07

    修剪:单一事实来源(步骤、模板、定义不重复);清理「沉积」(多人往同一个 markdown 里只加不删);删掉过期引用和删除测试表明不影响行为的「空操作」。

可以用在日常工作里的

  • 上下文

    盘点团队的 skills:哪些应改为用户手动调用以减少上下文负载,哪些需要模型自动触发。

  • 上下文

    每个 skill 拆成步骤 + 参考,模板与长文档放在引用文件里按需读取。

  • 上下文

    定期做删除测试:去掉一段后行为不变,就删掉它。

演讲提到的资源

同一章节的其他演讲

← 返回全景 · 目录