技能＝给 AI 一本操作手册

《智能体是怎么替你干活的》里，我让 AI 把一个抖音号的 40 条视频下载、转成文字、写了提炼，不到一个小时。

假设下个月你又想拆另一个号。打开智能体，发现又得从头交代：

视频下到移动硬盘哪个文件夹；文件名按“日期＋标题”起；转文字用电脑上的本地模型，别花识别费；提炼分几块、每块写什么……

上次踩过的坑，下载地址抄不出来、要按编号一条条下，它也不记得了，又得重新摸索。

这活明明干过一次，为什么每次都像第一次？这篇讲的就是解决办法：技能。整篇都用“拆一个抖音号”这件活。

---

一、先说一个误会：它干过一次，不等于学会了

很多人以为，AI 跟人一样，一件活干过一次就熟了。

不会。上一篇说过，大模型是一位只能打电话、不记事的老师傅，旋钮练完就定型，跟它干多少活都不会变熟练。上次怎么干成的、在哪儿卡过、你满意的提炼长什么样，只存在上一次的聊天记录里，新开对话就全没了。

还有一个误会：一听“技能”，以为是插件、是程序，得会写代码。也不是。技能主要是一份写给 AI 看的说明书，用大白话写，你自己就能读懂、能改。

一句话收住：AI 不会因为干过就会干，得有人把做法写下来。

---

二、为什么不全写进“徒弟的本子”里

上一篇最后说到：智能体显得懂你，是因为徒弟有个本子，记着你交代过的要点，每次打电话先念一遍。

那把“拆抖音号”的做法也写进本子，不就行了？

一两件活可以。可活会越来越多：拆抖音号、写朋友圈、出报价单、做周报……全写进本子，本子越来越厚。而本子是每通电话都要从头念的，电话本来就一通比一通长，本子再厚，每一通都跟着变长。你只想写条朋友圈，徒弟却每次都把别的活全念一遍，费钱，还容易把老师傅念糊涂。

所以需要一个新东西：平时不念，用到哪件活，才把哪件活的做法翻出来。

一句话收住：本子放每次都要守的规矩，具体某件活怎么干，得另外放。

---

三、技能是什么：一个文件夹，一本手册

这个“另外放”的地方，就是技能，英文叫 Skill。

一个技能就是一个文件夹。里面必须有一个主文件 SKILL.md，写步骤和标准；旁边还能放模板、样例、脚本，用到再拿：

douyin-chaijie/            ← 技能文件夹，名字用英文小写和短横线
├── SKILL.md               ← 主文件：什么时候用、怎么干、干成什么样算好
├── 提炼模板.md             ← 提炼分哪几块，每块写什么
└── 样例_上次那个号.md       ← 上次你满意的那份提炼，给它照着写

SKILL.md 打开是这样的（.md 就是 Markdown 格式的纯文字文件）：

---
name: douyin-chaijie
description: 把一个抖音号某段时间的视频批量下载、转成文字、写提炼。用户说"拆一下这个抖音号"时用。
---

# 拆抖音号

## 步骤
1. 先问清：哪个号、从哪天起、存到哪个文件夹。
2. 逐条下载。下载地址常常抄不出来，就按视频编号一条一条下。
3. 转文字用电脑上的本地模型，不用付费的识别服务。
4. 提炼按"提炼模板.md"写，写法照"样例_上次那个号.md"。

## 怎么算干完
- 视频数、文字稿数、清单上的条数，三个数对得上。

最上面夹在两行 --- 中间的那一小段，是手册的封面：name 是名字，description 是一句说明，讲清“管什么活、什么时候该翻开”。这两样规定必须有，下一节就知道它为什么要紧。

注意第 2 步：上次踩过的坑写进去了，下次不用再摸索。

技能和知识库也不是一回事：知识库是课本，管“你家是什么情况”；技能是操作手册，管“这件活怎么干”。

一句话收住：技能＝一个文件夹，主文件写步骤和标准，旁边放模板和样例。

---

四、装很多本也不占多少地方：平时只看封面

你可能会想：手册这么细，装上几十本，徒弟每次打电话不也要全念一遍？

不用。智能体用技能，是分三层翻的：

1. 平时只看封面：开工时，只把每本手册的名字和那句说明报给老师傅。
2. 对上了才翻开：你说“帮我拆一下这个号”，老师傅一看跟“拆抖音号”的说明对得上，让徒弟把 SKILL.md 全文念一遍。
3. 用到才拿附件：干到写提炼那一步，才打开模板和样例。

这个做法官方叫渐进式披露，说人话就是按需加载：用到哪层，才拿出哪层。

省多少？Agent Skills 的标准说明里给过参考：每张封面大约 100 个词元，翻开后的正文建议在 5000 个词元以内。装 50 本手册，平时多念的只是 50 张封面，大约 5000 个词元，跟翻开一本写满的手册差不多。

这也说明那句说明为什么要写好：老师傅只凭封面决定翻哪本。 写成“帮你处理视频”，它可能该翻不翻；写成“用户说’拆一下这个抖音号’时用”，就对得上。

一句话收住：平时只看封面，用到才翻开，所以装再多也不占地方。

---

五、什么时候写，怎么写：先做成一次，再写成技能

什么时候该写？一条好记的经验：同一件活要交代第二遍的时候，就该写成技能了。 第二次还要从头讲，说明它会一直来。

怎么写？很多人想先坐下来把手册写好，再让 AI 照着干。反过来更好：先跟它把活做成一次，改到你满意，再让它把刚才的过程写成技能。

因为没做过的活，你自己也写不清标准。提炼分几块、写多长，往往挑完第一版的毛病才知道；那种坑，不干一遍想不到。做完一次，标准和坑都在聊天记录里了，这时候让它写，才是真能用的手册。

活干完、你满意以后，接着发一句：

把我们刚才这件活的做法写成一个技能：
什么时候该用、分几步、每一步注意什么、刚才哪里卡住了是怎么解决的、怎么算干完。
我满意的那份成品，放进技能文件夹当样例。

你心里可能在想：又陪它磨、又让它写手册，我有这功夫自己都干完了。

这话对，第一次确实比自己干还慢。但从第二次起，你只说一句“拆一下这个号”，它就照着手册干，坑不用再踩，标准不用再讲。手册是它写的，你只看一遍、改几处。

一句话收住：交代第二遍，就写成技能；先做成一次，再让它自己写。

---

六、哪些工具能用

技能这套格式叫 Agent Skills，是 Anthropic（做 Claude 的公司）2025 年 10 月提出的，同年 12 月公开成开放标准，谁家的智能体都能照着支持。WorkBuddy 界面里就叫“技能”；Codex 用的也是这套格式。

所以一个技能文件夹，拷到另一个支持这套标准的工具里，原则上就能用；手册里用到某个工具特有的功能，换工具时要小改。

一句话收住：技能是一套公开的格式，WorkBuddy、Codex 都认。

---

这对你用 AI 意味着什么

它的原理	所以你该
大模型不会因为干过就变熟练	干成一次的活，别指望它下次还记得：做法得写下来
本子每通电话都念，写多了又贵又乱	本子只放每次都要守的规矩：某件活的做法，单独写成技能
平时只看封面，凭那句说明决定翻哪本	说明写清“什么时候用”：把你平时会怎么说这件活，写进说明里
没做过的活，标准和坑都写不清	先做成一次，改到满意，再让它写成技能：成品留作样例
同一套格式，多家工具都认	技能是你自己的家当：存好、备份，换工具也带得走

---

速查卡

记住这几句	意思	细讲
技能（Skill）	一件活的操作手册，是一个文件夹	本篇
SKILL.md	主文件：封面写名字和一句说明，正文写步骤和标准	本篇
渐进式披露	按需加载：平时只看封面，对上了才翻开，用到才拿附件	本篇
第二遍法则	同一件活要交代第二遍，就先做成一次，再让它写成技能	本篇
徒弟的本子	每通电话都念的规矩，只放每次都要守的	《智能体是怎么替你干活的》
知识库	你家资料整理成的课本，管“是什么”；技能管“怎么干”	《知识库＝让它开卷考试》
词元	它读文字、收钱的单位	《它是按字块读的：词元（token）》

---

动手练习（5 分钟）

看看它手边有哪些手册

打开 WorkBuddy（或者 Codex），发：

列出你现在能用的所有技能，每个只写名字和一句话说明，不用打开看内容。
然后告诉我：如果我说"帮我写一条朋友圈"，你会翻开哪一个？为什么？

你看到的那张清单，就是它平时“只看封面”看到的东西。

选做（约 20 分钟）：做出你的第一个技能

挑一件你每周都要交代一遍的小活，比如把客户咨询整理成表格、写一条新品朋友圈。在 WorkBuddy 里先把它干一次，不满意就直说，改到满意。然后发：

这件活我以后每周都要做。请把刚才的做法写成一个技能：
1. 说明里写清什么时候该用，把我平时可能会怎么说这件活都写进去；
2. 步骤写清每一步做什么、注意什么，刚才我让你改过的地方都写成规矩；
3. 刚才那份我满意的成品，放进技能文件夹当样例。
写好以后，把 SKILL.md 的全文给我看一遍。

下周新开一个对话，只说一句话交代这件活，看它是不是自己翻开了这本手册。

---

常见问题

问：技能和提示词有什么区别？我把提示词存起来，每次贴进去不也一样？ 答：底子都是写给 AI 的话，区别在三处：提示词要你每次自己贴，技能是它看封面自己找；技能旁边能放模板、样例、脚本；平时只占一张封面的地方。

问：别人做好的技能，能直接装吗？ 答：能。但技能里可以带脚本，会在你的电脑上跑，所以只装信得过的来源，装之前打开 SKILL.md 看一眼它要干什么。Anthropic 自己也这么建议。

问：技能写好了，它有时候还是不按手册来，怎么办？ 答：先看两处。一是封面那句说明，没写出你平时会怎么说这件活，它对不上就不会翻开；二是正文写得含糊，“写得专业一点”这种话它每次理解都不一样，改成具体的标准和样例。你也可以开口就点名：“用拆抖音号那个技能。”

---

下一篇

《连接器：给智能体接上别家的工具》：手册写好了，可有的活要用到飞书、企业微信这些别家的系统，徒弟的工具箱里没有，怎么接上。

参考资料

• Anthropic 工程博客，《Equipping agents for the real world with Agent Skills》，2025 年 10 月 16 日：技能是一个含 SKILL.md 的文件夹，开头必须写 name 和 description；开工时只放每个技能的名字和说明，判断相关才读整份 SKILL.md，附带文件再按需读取，称为“渐进式披露”；安全部分建议只从信得过的来源装技能
• Agent Skills 开放标准说明（agentskills.io）概述与规范页：name 只能用小写字母、数字和短横线；封面约 100 个词元，正文建议 5000 个词元以内
• The Decoder，《Anthropic publishes Agent Skills as an open standard for AI platforms》，2025 年 12 月：Agent Skills 作为开放标准发布
• OpenAI，Codex 技能文档（Build skills）：Codex 技能基于开放的 Agent Skills 标准