Agent Skills · 烹饪指南

Oh My Skills

用做菜的方式,理解如何制作 AI 工程中的 Skills

做菜有菜谱,AI 有 Skills——本质上都是
「把经验变成可复用的步骤」。
01 · 什么是 Skills

Skills 是什么?

就像一道菜的背后,是一本经过时间检验的菜谱。

🍳 做菜

你做了一道红烧肉,失败了三次后才总结出「先焯水、再炒糖色、小火慢炖四十分钟」的完整流程。这就是你的「红烧肉菜谱」。

🤖 AI Skills

你让 AI 处理 PDF,它搞砸了几次后,你总结出「先用 pdfplumber 提取文本,再用模板填充表单」的标准流程。这就是你的 PDF 处理 Skill。

核心本质:Skills 是一个轻量、开放的格式,用来扩展 AI 智能体的能力——通过专业的知识和工作流程。 它就是一个文件夹,里面有一个 SKILL.md 文件,加上可选的脚本、模板和参考资料。


02 · 三步烹饪法

Skills 是如何工作的?

做菜分三步,Skills 也一样。

01
Discovery · 发现菜谱

浏览菜谱目录

做菜前,你不会把所有菜谱都摊在厨房台面上。你只需要翻一下目录——看到「红烧肉」「清蒸鱼」「蛋炒饭」这几个菜名和一句话介绍,心里就知道哪个菜适合今天的食材。

Skills 的做法:启动时,AI 只加载每个 Skill 的名称和描述,轻量、快速,仅够判断何时可能用到。
02
Activation · 准备食材

按需展开菜谱

决定做红烧肉后,你才翻开那一页,看详细的步骤、配料表、火候说明。你不会同时准备所有菜的食材——太浪费时间和精力。

Skills 的做法:当任务匹配某个 Skill 的描述时,AI 才读取完整的 SKILL.md 指令到上下文中。这就是「渐进式披露」。
03
Execution · 下锅烹饪

按步骤执行

按照菜谱的步骤一步步来——焯水、炒糖色、加水慢炖。过程中如果需要特殊调料(比如某款酱油),你再去拿,不需要提前备好所有东西。

Skills 的做法:AI 遵循指令,按需加载引用的文件、执行捆绑的代码。保持精简,只在需要时获取更多上下文。

03 · 菜谱的核心

SKILL.md 文件结构

每一道菜都有一张核心菜谱,每一个 Skill 都有一个 SKILL.md。

my-skill/
SKILL.md # 必选:指令 + 元数据 scripts/ # 可选:可执行代码 references/ # 可选:文档资料 assets/ # 可选:模板、资源 一个 Skill = 一个文件夹,SKILL.md 是灵魂。

SKILL.md 包含 YAML 前置元数据和 Markdown 指令,就像菜谱上端的「菜名+简介」加上下方的「详细步骤」。

name · 菜名

简短标识符

就像「红烧肉」三个字,让 AI 一眼知道这个 Skill 是什么。简短、明确、可识别。

description · 菜品简介

何时使用这个 Skill

就像菜谱封底的简介:「适合新手,用时 45 分钟」。告诉 AI 什么场景下该激活它。


04 · 为什么选择 Skills

Skills 的核心优势

就像好菜谱的三大特征:好读、好改、好分享。

📖

自文档化

打开 SKILL.md 就能读懂它做了什么。谁都可以审核、改进,不需要额外文档。

🧩

可扩展

从纯文本指令到可执行代码、资产和模板,Skills 可以简也可以繁,灵活适配。

📦

可移植

Skills 就是普通文件——容易编辑、版本控制、分享。不需要特殊工具或格式。


05 · Skill 的种类

不同的 Skill 类型

就像菜谱有简版和详版,Skill 也有不同的复杂度。

纯文本型
就像一张便签菜谱——只有 SKILL.md 里的 Markdown 指令。适用于简单、明确的任务流程。
示例:PDF 文本提取、音频转录
脚本增强型
菜谱附带了特殊工具——比如专用的模具或调料勺。Skill 包含可执行脚本,AI 在需要时可以调用。
示例:影视搜索、直连规则生成
资产丰富型
一本完整的烹饪书——有详细步骤、食材清单、参考图片、甚至视频教程链接。Skill 附带模板和参考资料。
示例:PPT 生成、技能管理器

06 · 制作原则

制作 Skill 的六大原则

好菜谱是试出来的,好 Skill 也是。

从失败到菜谱的旅程


07 · 总结

从「会做菜」到「能可靠做菜」

最后,用做菜的方式总结一下。

做菜有菜谱,AI 有 Skills。
菜谱是经验的沉淀,Skills 也是。

它们都把「知识 + 做法 + 时机」打包在一起,
让 AI 从「会回答」,走向「能可靠做事」。

——— 全文完 ———