← 返回概念列表
学习进度4 / 4

SKILL.md 的三段结构

SKILL.md three-part structure · AS.1 第 1 章 先用用:跑通你的第一个技能

一句话定义

一份技能定义文件通常由名称、触发描述与正文操作说明三部分组成,分别解决“这是什么/什么时候用/具体怎么做”三个问题。

机制 / 原理

之所以拆成三段,是因为它们服务于不同阶段:名称用于人和系统识别这份技能触发描述description)让智能体在还没读正文之前就能判断当前任务是否匹配这项技能,避免每次都把全部技能塞进上下文造成浪费;正文操作说明则是真正被执行的详细步骤,只有命中触发条件后才会被加载进来。这种“先判断要不要用、再决定读多少”的分层,是技能能够按需加载、支撑大量技能共存的关键。

经典实验 / 例子

一份处理“合并多份Excel报表”的技能文件,名称是“合并报表”,触发描述写明“当用户提到合并、汇总多个表格文件时使用”,正文则详细列出读取顺序、去重规则、异常列处理方式——智能体先扫到触发描述觉得匹配,才会去读正文的详细步骤。

生活中的例子

有点像一本工具书的书名和索引:书名告诉你这是什么书,索引词条告诉你什么情况该翻到哪一页,真正查资料时才去读那一页的正文内容,不用把整本书都翻一遍。

常见误区

常见误区是把触发描述写得过于宽泛或过于狭窄:太宽泛会导致技能被误触发,太狭窄又会导致该用的时候没被匹配上;好的触发描述需要精准覆盖真实会用到这项技能的场景。

资料来源:图解Skill:AI提效实战指南(宝玉,人民邮电出版社,2026年5月) · 第 1 章 · 第 AS.1 节 (CC BY 4.0)
本讲解由 AI 依据该教材与主流学术观点撰写,非逐字引用,仅供学习参考。