这一章给了三个够用一辈子的骨架:怎么选环境、技能长什么样、怎么造出第一个。都不深,但每个都是后面章节反复回来引用的地基。
SKILL.md。文件分三部分:name 是技能 ID,同时也是文件夹名;description 是简介加触发词,智能体启动时只扫这张「名片」来判断该不该用它(底层机制第二章细讲);正文写步骤、规则、检查清单,被选中之后智能体才会读。对管理者来说,这就是一份「写成文件的工作交代」,谁接手都能照着办。| 概念 | 一句话解释 |
|---|---|
| 智能体(Agent) | 要连接大模型才能工作的执行者;模型是它的「大脑/发动机」。 |
| API Key | 模型厂商发的密钥,相当于一张「加油卡」,填进智能体就能开动。 |
| 有技能 vs 没技能 | 没技能:每次都要重说格式、语气、保存方式;有技能:只说「做了什么」,规则由技能替你记着。 |
这一章真正想装进你脑子里的,是一个换算关系:技能 = 把口头交代变成文件。你每周对着 AI 重复的那套要求——什么格式、什么语气、写完放哪——本质上是一份没写下来的操作规程。写进 SKILL.md,它就从「每次说」变成「只说一次」,之后你只需要提供增量信息。
另一个要记住的画面:智能体不会通读你所有技能的全文,启动时它只看每张「名片」(description),命中了才翻开正文。所以技能灵不灵,往往不在正文写得多好,而在名片上的触发词跟你的说法对不对得上——这也是本章排查问题的落点。
先别学原理,先跑通。技能的核心价值,一句话感受就懂:把「每次都要交代的要求」变成「只说一次」。
没技能的一周:每次让 AI 写周报,都要重新交代一遍「按这个格式、用这个语气、写完保存到某处」——纯粹的重复劳动,交代本身比写周报还累。
有技能的一周:装好「周报技能」之后,你只说「这周做了 A、B、C」,格式、语气、保存规则全由技能替你记着,输出直接落到该在的地方。
差异不用讲理论,一上手就有体感——这就是技能存在的理由,也是作者坚持让你「先用用」的原因。
如果你还没想清楚周报具体要做成什么样,没关系。先跟智能体聊着做一份出来,边做边调,调到满意再固化成技能。
……来回几轮,直到输出的周报完全符合你的预期。
第二步(关键的一步),不要退出当前对话,直接对智能体说:“这份周报的格式和风格我很满意。帮我基于咱们刚才的对话,把这些要求固化成一个周报技能。以后我只需要告诉你做了什么事,你就按这个标准生成周报。”
智能体会回顾你们刚才的全部对话——你提过的每个调整、最终满意的结果——自动提炼规则,生成技能文件。这比你自己从零描述需求更准确,因为智能体“目睹”了完整的调试过程和最终成果。
这就是技能的核心价值:把你脑子里的要求变成文件里的规则,从“每次都说”变成“只说一次”,从“到处改”变成“改一处,处处生效”。
而且,这还只是最简单的情况——你需要告诉智能体你本周做了什么。等学完第 2 章的“工具”概念后,你会发现,技能还能配合工具接入邮件系统、代码仓库、任务管理系统等工作平台。到那时,你连“做了什么”都不用说,一句“帮我写周报”,智能体会自动从这些平台汇总本周的工作记录,直接整理成周报。
name——技能的名称,也是文件夹的名称。你可以将它看成技能的 ID,智能体通过这个 ID 标识不同的技能。
description——技能的简介,一两句话说清楚“技能是干什么的,以及什么时候使用”。你在 1.2 节排查不触发问题的时候已经体验过它的重要性了。
正文——第二个 --- 之后的内容,具体的操作步骤和规则,其中可能包括执行流程、输出要求和检查清单等。
……
智能体启动时不会立刻阅读技能的完整内容,而是只扫描每个技能的名片,也就是名称和简介,用来判断当前任务该调用哪个技能。名片里也可以包含其他信息,但只有名称和简介是必需的。只有智能体判断要调用某个技能时,才会去读技能正文里的详细指令。换句话说,技能名片负责让智能体快速判断该不该用这个技能,正文则告诉它具体怎么一步步执行。