← 返回🧰封装 Agent Skill,让 AI 稳定输出的关键
1 / 9
1
STEP 1

理解 Skill 解决的两个核心问题

在开始封装 Skill 之前,先搞清楚它要解决什么问题——这能帮你判断哪些工作值得封装。

两个典型痛点

  • 每次重新提要求:同样的工作,今天做一遍,明天还要再解释一遍,AI 完全不记得你的要求
  • 产出不稳定:今天满意,明天同样的操作却出来不一样的结果,像在跟 AI 赌运气

根本原因

这两个问题本质上是同一件事:你还没有给 AI 建立一套标准化的工作体系

Skill 的作用就是把你磨合好的工作标准固定下来,让 AI 每次都按同一套规则干活。

理解 Skill 解决的两个核心问题
2
STEP 2

Skill 文件夹:整体结构一览

每个 Skill 是一个文件夹,里面由固定的几个部分组成。先有个整体印象,后面每一部分会单独介绍。

Skill 文件夹结构

skill-name/
├── SKILL.md        # 员工手册:告诉 AI 它是谁、该干什么
├── references/     # 严格菜谱:格式标准、内容规范
├── scripts/        # 自动化设备:可直接运行的脚本
└── assets/         # 预制原料:模板文件、品牌素材

用一个比喻来理解:假设你是麦当劳门店老板,招了一个新员工,想让他从第一天起就能做出标准的麦辣脆鸡堡——你需要给他一套完整的工作体系,而不是每次站在旁边指挥。

这套体系,就是你的 Skill 文件夹。接下来逐一拆解每个部分。

没有用到的文件夹不需要创建,按需组合即可。

Skill 文件夹:整体结构一览
3
STEP 3

SKILL.md:员工手册

SKILL.md 是整个 Skill 的核心文件,也是 AI 每次上岗前必读的说明书。

它要写清楚四件事

  • Skill 职责:我是谁,我负责什么类型的工作
  • 触发场景:遇到什么情况应该启用这个 Skill
  • 执行步骤:拿到任务之后,按什么顺序处理
  • 输出标准:最终交付的内容应该长什么样

类比

麦当劳的员工手册不是「认真做好每一个汉堡」这种模糊要求——它规定了每个岗位的具体职责、操作流程、服务话术。新员工照着手册,第一天就能上岗。

SKILL.md 的作用完全一样:有了它,AI 每次都清楚自己的职责,不需要你从头教,也不会自由发挥跑偏。

写 SKILL.md 的原则:越具体越好。「输出一份报告」不如「输出一份包含摘要、分项明细、总计金额的 Markdown 表格」。

SKILL.md:员工手册
4
STEP 4

references:严格菜谱

references 文件夹存放 AI 必须严格遵守的格式标准、内容规范和行业规则。

它用来放什么

  • 输出格式模板(表格结构、字段名称、顺序)
  • 内容规范(哪些字段必填、哪些可选)
  • 行业术语或特定词汇表
  • 你在对话中反复确认过的「这样就对了」的标准

类比

麦当劳的菜谱不是「放适量的盐」——它是面包胚必须多少克,肉饼必须多少克,生菜必须几片,酱料必须几毫升,误差不超过多少。不管今天谁来做这个汉堡,出来的结果都一样。

references 就是这份精确菜谱,AI 在执行任务时遇到格式或规范问题,会主动翻出来对照,不需要你在对话里重复说明

把你在对话里反复解释的格式要求,全部整理进 references,一劳永逸。

references:严格菜谱
5
STEP 5

scripts:自动化设备

scripts 文件夹存放可以直接运行的脚本代码,专门处理那些每次都一样的机械步骤。

它用来放什么

  • 自动读取和解析文件(如批量识别发票图片)
  • 自动格式化输出结果
  • 文件重命名、归类、导出等固定操作
  • 任何「每次都要做、每次都一样」的处理流程

类比

麦当劳后厨的炸薯条机器:时间到了自动响铃,温度不对自动报警,确保每一批薯条都一模一样。这些设备不需要员工动脑,按标准自动执行。

scripts 里的代码也是这样——不需要 AI 现场思考,直接运行,直接出结果。

如果你的工作涉及批量处理文件,优先考虑把处理逻辑写进 scripts,速度更快,结果更稳定。

scripts:自动化设备
6
STEP 6

assets:预制原料

assets 文件夹存放每次输出都要用到的模板文件和品牌素材。

它用来放什么

  • PPT 模板文件
  • 报告格式文件(带公司抬头的 Word 模板)
  • 公司 Logo、品牌色板
  • 任何「每次输出都要用、但内容不变」的文件

类比

麦当劳的面包胚和肉饼,不是每家门店自己从头做的——工厂统一预制好,每天冷链配送。所以你在北京吃和在上海吃,肉饼的口味和大小完全一样。

assets 就是这批预制原料。AI 每次输出时直接取用,外观和规格完全统一,不会这次蓝色主题、下次给你整个红色。

把公司模板文件放进 assets,AI 就能每次输出带有统一品牌风格的内容,不需要你再手动套格式。

assets:预制原料
7
STEP 7

从已有对话中提取 Skill

最实用的封装方法:从你已经磨合好的对话里直接提取,一步都不浪费。

操作步骤

  1. 跟 AI 来回磨合,直到得到一个满意的结果
  2. 不要关掉对话窗口,在同一个窗口继续
  3. 把下面这段提示词发给它:
我们刚才的对话已经磨合出了完整的工作流程和输出标准。
请现在将这个过程整理成一个标准的 Agent Skill,要求如下:
1. 创建完整的 Skill 文件夹结构
2. SKILL.md 写清楚:Skill 职责、触发场景、执行步骤、输出标准
3. references 放入我们确认过的所有格式要求和内容标准
4. 可自动化的步骤写入 scripts
5. assets 放入需要复用的模板文件
6. 没有用到的文件夹不创建
输出一个我可以直接安装使用的 Skill 文件夹。
  1. AI 会把整个对话里确认好的标准、格式、流程,全部整理进对应的文件
  2. 将输出的 Skill 文件夹加载到 skills 目录

好不容易磨出来的成果就这样固定下来了,下次直接用,不会再丢。

从已有对话中提取 Skill
8
STEP 8

从社区获取并优化现成 Skill

除了自己从头磨,还可以直接用别人做好的 Skill,再按自己的需求调整。

获取现成 Skill

去 GitHub 搜索别人做好的 Skill,社区里已经有不少现成的可以用。

个性化优化

下载之后如果不完全符合需求:

  1. 将 Skill 加载进来
  2. 告诉 AI:「这个 Skill 在哪些地方还不够准确,帮我根据我的实际工作习惯优化一下」
  3. 把你的具体要求说清楚
  4. 让 AI 直接迭代修改

一个别人做了 80 分的 Skill,经过你的调整,可以变成你专属的 100 分。

从社区获取并优化现成 Skill
9
STEP 9

选择工具并完成安装

Skill 做好了,怎么用起来?两个主要工具路线:

路线一:Claude 桌面端

  1. 从 GitHub 下载 Skill(通常是压缩包)
  2. 将压缩包直接拖进 Claude 桌面端即可导入

路线二:OpenClaw(龙虾)

  1. 复制 GitHub 仓库链接
  2. 在 OpenClaw 中粘贴链接导入
  3. 告诉 OpenClaw:「将这个 Skill 转为 OpenClaw 能使用的 Skill」

OpenClaw 与 Claude 桌面端在 Skill 文件格式上略有不同,导入后需要做一次格式转换。

安装完成后,把发票、草图、文档丢进去,那些重复的工作就不再需要你亲自下场了。

选择工具并完成安装
1 / 9