AI 工具方法论
把这两个东西搞清楚，AI 才算真正开始替你干活
一句话说完全文：Skill 教 AI「怎么干活」，插件给 AI「接上外部世界」。Skill 是一份你提前写好的说明书，AI 读完了就知道这类活该按什么流程干、出什么格式；插件是电源线，把你的网盘、GitHub、邮箱、在线文档这些外部服务接到 AI 手上。两个东西用好，重复劳动基本归零。这篇文章把我自己写的 Skill 拆开给你看，基础用法和高阶用法都讲。
📖 目录
- 一、先给结论：一个管「会做」，一个管「能碰」
- [二、Skill 到底是个什么东西](#二、Skill 到底是个什么东西)
- [三、眼见为实：我自己写了一个 blog-writer](#三、眼见为实：我自己写了一个 blog-writer)
- [四、Skill 和插件，到底差在哪](#四、Skill 和插件，到底差在哪)
- [五、Skill 基础用法：会说话就会用](#五、Skill 基础用法：会说话就会用)
- 六、插件基础用法：说目标，别说步骤
- [七、Skill 高阶用法：把重复三次以上的活写成说明书](#七、Skill 高阶用法：把重复三次以上的活写成说明书)
- [八、高阶组合拳：Skill 管流程，插件管手脚](#八、高阶组合拳：Skill 管流程，插件管手脚)
- 九、我踩过的坑
- 十、最后：先攒说明书，再接线
一、先给结论：一个管「会做」，一个管「能碰」
很多人把 Skill 和插件搞混，其实分清楚只需要问一个问题：这个扩展装上之后，AI 是学会了新本领，还是摸到了新东西？
- Skill（技能）：装的是「本领」。它就是一段说明书，告诉 AI「遇到写博客这种活，按这五步走，版式用这个，配图这么处理」。AI 的脑子没变大，但它照着说明书干活，输出就稳定。
- 插件 / 连接器（Connector）：接的是「外部」。网盘、GitHub、邮箱、在线文档、支付------这些 AI 本来碰不到的东西，授权接上之后它才能帮你传文件、查资料、发消息。
一个类比
Skill 是新员工入职时发的那本《作业指导书》，教会他公司的活怎么干；插件是给他开的门禁和系统账号，让他能真的碰到那些机器和资料。只有说明书没有账号，活干不了；只有账号没有说明书，干出来的活每次都不一个样。
二、Skill 到底是个什么东西
拆开看，一个 Skill 就是一个文件夹，里面最核心的是一个叫 SKILL.md 的文件。它分成两截：
- 头部的元信息：名字 + 一段描述。这段描述是干什么的？是给 AI 自己看的「检索索引」。AI 每次接到你的话，会拿你的话跟所有 Skill 的描述做匹配，看该掏出哪张说明书。这篇会第五节细讲。
- 正文的工作指令：流程几步、每步干什么、产出什么格式、有什么禁区。写多细，AI 就照多细执行。
除了 SKILL.md，文件夹里还能塞别的东西：现成的脚本、模板文件、参考守则。这些都是说明书附录，AI 用到哪张翻哪张。
所以「Skill 是什么」的答案很简单：它不是程序，不是插件，就是一份写给 AI 看的、结构化的作业指导书。你平时每次都要重复交代的那些要求------格式、步骤、注意事项------写进去一次，以后就不用再说了。
为什么说明书能起作用
大模型的记忆是「金鱼记忆」，跨会话什么都不记得。你上次交代得再清楚，这次开新对话它全忘了。Skill 等于把你的要求外置成了一个文件，每次干活前 AI 先去读一遍------记忆靠不住，那就靠文档。工程师管这叫「外置记忆」，说白了就是好记性不如烂笔头。
三、眼见为实：我自己写了一个 blog-writer
我每天都要写博客。麻烦不在写，在于每次都要把同样的要求重新交代一遍：米色暖底、红金配色、扁平插画、hero 大图加目录、图生成完要裁水印、成品要归档到哪个文件夹......说漏一条，产出就跑偏一次。
于是我写了一个叫 blog-writer 的 Skill。现在我的流程变成：给主题 + 几句感想，直接收成品。中间的版式、配色、配图流程、归档路径，全部固化在说明书里，不用再提。
我自己建的 blog-writer：描述里写清了触发词和产出格式，正文固化了五步流程。这篇博客就是它写出来的。
它的说明书正文就五步：收集素材 → 规划结构 → 生成配图 → 组装 HTML → 归档交付。每一步还挂了附录：版式模板一个文件、写作守则一个文件、裁水印脚本一个文件。AI 干活时按流程走，走到哪一步就翻哪份附录。
这就是 Skill 的价值：把你脑子里的隐性要求，变成 AI 每次都会执行的显性流程。你不用重复，它不会走样。
四、Skill 和插件，到底差在哪
拿一张表说清楚：
| 维度 | Skill（技能） | 插件 / 连接器 |
|---|---|---|
| 本质 | 一份说明书，教 AI 按固定流程干活 | 一条接线，让 AI 碰到外部服务 |
| 解决什么 | 输出不稳定、要求要反复交代 | AI 摸不到你的数据和外部系统 |
| 形态 | 一个文件夹 + SKILL.md，可带脚本和模板 |
一个需要授权绑定的外部服务连接 |
| 要不要授权 | 不用，装上就能用 | 要，首次使用得绑定账号授权 |
| 举例 | blog-writer、文档排版、OCR 单据识别 | 网盘、GitHub、邮箱、在线文档 |
| 类比 | 作业指导书 | 门禁卡和系统账号 |
左边管「会做」，右边管「能碰」。两个是互补关系，不是二选一。
判断标准也简单：你要 AI 学一个本事 ，写 Skill；你要 AI 够到一个东西，接插件。两个都不装，AI 就是个只能聊天打字的助手。
五、Skill 基础用法：会说话就会用
很多人以为用 Skill 要记命令、要手动设置。不用。Skill 的触发是自动的------AI 会拿你说的话，去和所有已装 Skill 的描述做语义匹配，匹配上了就自动加载那本说明书开干。
拿我的 blog-writer 举例，下面这几句话都能自动触发：
「帮我写个博客，主题是 XXX」 「这个想法给我做成一篇 blog」 「发一篇文章讲讲今天调 PID 的感想」
注意一个细节：我没有说「调用 blog-writer」，我只是正常说话。你不需要记住 Skill 的名字，你只需要把需求说清楚。匹配靠的是语义，不是关键词完全一致------所以说的话跟触发词越接近，命中率越高。
检索不到怎么办
如果 AI 没有自动接上 Skill（比如你说得太含糊，或者几个 Skill 描述长得像），再去手动指定：点开技能面板直接选，或者 @ 它的名字。顺序永远是先自动，后手动------自动检索是常态，手动是兜底。
自动检索：你说的话和说明书堆里的某一张对上了，AI 就自己掏出来用，全程不用你指定。
六、插件基础用法：说目标，别说步骤
插件这头更简单。绑定授权一次之后，你只管说目标：
- 「把这个 HTML 存到我的网盘里」------AI 自己去调网盘连接。
- 「帮我看看这个仓库最近的提交」------AI 自己去调 GitHub。
- 「这份文档发到我邮箱」------AI 自己去调邮件。
要点在标题里：说目标，别说步骤。你不需要说「先打开网盘 API，再上传文件到 XX 目录」，插件存在的意义就是把这些细活包掉。你说步骤反而容易把 AI 带偏。
⚠️ 一个边界要有数
- 插件连接的是你自己的账号和数据，属于「对外动作」。涉及发送、删除、支付类的操作，AI 会先跟你确认，别嫌烦，这是保护你。
- 没绑定授权的插件 AI 用不了。第一次用某个服务，先把授权走完，之后才是一句话的事。
七、Skill 高阶用法：把重复三次以上的活写成说明书
基础用法是「用别人的 Skill」，高阶用法是「写自己的」。我的判断标准一句话：同一个活，重复干到第三次，就值得写个 Skill。第一次是探索，第二次是熟悉，第三次就是纯粹的重复劳动了。
自己写的时候，三件事决定这个 Skill 好不好使：
- 把描述写全：描述是自动检索的唯一依据。触发词、适用场景、产出形态，全写进描述里。描述写太含糊，AI 检索不到，你这 Skill 等于白装。
- 把流程写死：几步、每步干什么、出什么格式，一步一步列清楚。AI 最怕「随便」「看着办」，你写死它就稳。
- 把关键动作固化成脚本：容易走样的环节（比如图片裁切、格式转换）直接写成脚本挂在 Skill 里，让 AI 执行脚本而不是「凭感觉做」。我的 blog-writer 里就挂了一个裁水印的脚本，从此每张图裁得一模一样。
什么活值得写 Skill
三个特征：① 格式固定（每次产出长得都该一样）；② 流程固定（步骤不需要临场发挥）；③ 有硬约束（某些坑绝对不能踩）。写作、周报、代码审查、单据整理，都是典型。反过来，每次需求都不一样的活，写 Skill 是浪费。
八、高阶组合拳：Skill 管流程，插件管手脚
分开用只是及格，组合起来才是高阶。记住一句分工口诀：Skill 负责「怎么干」，插件负责「拿到料、交出货」。
几个我真实在用的组合：
| 场景 | Skill 出流程 | 插件出手脚 |
|---|---|---|
| 写博客 | blog-writer：出稿、配图、组装页面 | 网盘：搜旧素材、备份成品 |
| 整理单据 | OCR 技能：识别图片、汇总成表 | 在线表格：直接写进云文档 |
| 查资料写报告 | 写作守则：结构、去 AI 化 | GitHub / 网盘：拉源码和资料 |
| 管代码项目 | 工程规范：目录结构、提交格式 | GitHub：建仓库、推代码 |
组合的思路是把「做」和「碰」解耦：Skill 里只写流程和标准，不写「去哪个网站、用什么工具」；接哪个服务，让 AI 根据当下有没有对应插件自己决定。这样换个环境（比如换了台机器、插件没授权）Skill 照样能用，只是「手脚」受限而已。
九、我踩过的坑
以下全是亲身经历，一条条交学费交出来的：
⚠️ 描述写得含糊，Skill 等于不存在
- 最早我的 blog-writer 描述只写了「写博客工具」。结果 AI 经常检索不到，得手动指定。后来把触发词（写博客、写成博客、做成一篇、发一篇、blog）和产出形态全写进描述，命中就稳了。自动检索的命中率，完全取决于你描述写得多贴近用户的原话。
⚠️ 关键流程靠「嘱咐」会走样
- 图片生成有个坑：多张图并行生成会因文件名撞车互相覆盖，最后只剩一张，工具还都报告成功。我在说明书里写死「串行生成、生成一张立刻改名」之后，这个坑就绝迹了。凡是踩过一次的坑，回头就写进 Skill------说明书是越养越厚的。
⚠️ Skill 改了，当次会话不生效
- Skill 列表是会话开始时装载的，中途新建或修改的 Skill，当前对话看不见。改完开个新会话再验证，别在旧会话里反复测、怀疑人生。
⚠️ 别把插件当 Skill 用
- 有人在提示词里堆一堆「第一步调 XX API，第二步调 YY 接口」，其实那是插件的活。接哪个服务是 AI 该自己判断的事，你只需要说目标。把流程写进 Skill，把连接交给插件，各干各的。
十、最后：先攒说明书，再接线
如果要我给个上手顺序：先把重复劳动固化成 Skill，再按需接插件。
因为 Skill 解决的是「输出不稳」------这是 AI 干活最大的痛点，而且写 Skill 零门槛，一个文件夹几个文件就够。插件解决「够不着」，等你发现某个活卡在「AI 拿不到那个数据 / 交不到那个地方」，再去接对应的连接器也不迟。
从今天开始，每次你发现自己第三次在向 AI 交代同一件事，就停下来花十分钟写个 Skill。一个月后回头看，你的 AI 会从「每个对话都要重新带的实习生」，变成「拿着你整套作业指导书的老搭档」。
写于 2026 年 10 月 · 文中观点为个人经验笔记