ORANGE BOOK · AGENT SKILL

第一章 认识 Agent Skill

你将学到

  • 用三个类比 5 分钟向外行讲清 Skill 是什么。
  • 看清 Skill 和 Prompt、Custom GPT、Plugin、MCP 的本质边界。
  • 知道哪些东西 Skill 能做、哪些 Skill 做不了。
  • 拿到一份"我适不适合学 Skill"的自检清单。

你需要准备

  • 一杯水。这一章不用打开电脑,纯阅读理解。

一、先讲清"Agent"是什么,再讲"Skill"

很多人卡在 Skill 上的第一道关,其实是"Agent"这个词。

我们用一个最朴素的类比:

  • 聊天机器人(ChatGPT、Kimi、文心、豆包默认模式):像一位百科全书学者。你问什么,他答什么。但他不会下楼帮你买菜。
  • Agent:像一位会动手的同事。你说"帮我把仓库里上周新增的 50 个客户线索整理成 Excel,今晚发我",他会自己开电脑、登 CRM、导数据、做表、发邮件。

差别就一个词:会不会动手

而 Agent 之所以"会动手",是因为它身边有一堆能用的工具——浏览器、文件系统、命令行、数据库连接、第三方 API。

白话解释:Agent = 大模型 + 一组它能调用的工具 + 自己决定调用顺序的能力。

Skill 又是什么?

Skill 是给这位"会动手的同事"准备的工作手册

每一本工作手册告诉它:

  • 这件事在什么场景下要做("老板说要周报的时候")。
  • 这件事的步骤是什么("先拉 Notion,再拉 GitHub,最后排版")。
  • 这件事用什么工具做("用 Python 的 pandas,用公司的 PPT 模板")。
  • 这件事的输出长什么样("一份 5 页 PPT,带图带结论")。

你的 Agent 同事会随身带着这一摞工作手册。当他听见"周报"两个字,自动翻到那一页,照着干。

这就是 Agent Skill。

二、三个类比,把 Skill 讲到外行也懂

类比 1:Skill 是 AI 的"应用商店"

你的手机是一台通用计算设备。它能做的事很有限——打电话、发短信、看时间。

但你装了微信,它就能聊天;装了高德,它就能导航;装了支付宝,它就能付钱。

每一个 App 都是一个"插件能力",把通用的手机变成专门做某件事的工具。

Claude 也是同样的逻辑:

  • 没装 Skill 的 Claude:是一个会聊天的通用模型,做不了多少具体的事。
  • 装了 100 个 Skill 的 Claude:是一个会做 Excel、会读 PDF、会发邮件、会画图、会监控价格、会写周报、会接 BI、会管账本……的"100 件功能 + 1 个统一界面"的超级 App。

而最爽的地方是:装这些"App"对你的电脑没有任何性能负担。Claude 只在用得到那个 Skill 的时候才把它"翻开",平时它就静静躺在文件夹里。

类比 2:Skill 是 AI 的"入职手册"

新员工入职第一天,HR 会塞给他一摞东西:

  • 公司组织架构图
  • 报销流程
  • 周报模板
  • 行业术语表
  • 常用工具账号
  • 加班餐补的具体规则

这些不是"知识",这些是"在我们公司怎么干活的方法"。

新员工不需要凭空知道这些,他只需要在需要的时候打开手册照着做。

Skill 就是 Claude 的入职手册。你每写一个 Skill,就相当于在你私人的 AI 同事的工位抽屉里,塞了一份"在这家公司怎么干活"的小册子。

  • 你写 meixin-tone Skill —— 告诉它"我们公司说话不绕弯子先给数字"。
  • 你写 weekly-report Skill —— 告诉它"我们公司周报四段:完成/计划/风险/求助"。
  • 你写 customer-followup Skill —— 告诉它"我们公司客户跟进表怎么填、什么字段必填"。

从此你的 Claude 不再是"通用 Claude"——它是你公司的专属 Claude,是你的私人助理

类比 3:Skill 是 AI 的"肌肉记忆"

你第一次学开车,每个动作都要想:踩离合、挂挡、看后视镜、打方向灯、慢慢松离合……

10 年后,你边喝咖啡边听播客边换挡,根本不用想。

这种"不用想就会做"的能力,叫肌肉记忆

聊天 AI 没有肌肉记忆——它每次开车都得从头学一遍。

而装了 Skill 的 Claude 有肌肉记忆。你教它一次"我们家做番茄炒蛋的 7 个步骤",它从此每次"番茄炒蛋"都自动执行那 7 步。

普通人和高手的差距,从来不是知识储备,而是肌肉记忆。

Skill 就是给 AI 装肌肉记忆的方式。

三、Skill 的"长相"——一个文件夹

讲完比喻,我们看一眼真实的 Skill 长什么样。

最简单的一个 Skill 就是一个文件夹,里面有一个 Markdown 文件:

weekly-report/
└── SKILL.md

SKILL.md 内容大概长这样(先看个轮廓,第八章会手把手教你写):

---
name: weekly-report
description: 帮用户按公司四段格式(完成/计划/风险/求助)写周报。当用户说"写周报""周一汇报""this week summary"等时触发。
---

# 周报生成器

## 第一步:收集数据
1. 从 Notion 工作区拉取本周已完成 Task。
2. 从 GitHub 拉取本周提交记录。
3. 从飞书拉取本周日程。

## 第二步:按四段格式写
- 本周完成(不超过 5 条,每条一行)
- 下周计划(按优先级排)
- 风险(如果没有,写"无")
- 求助(如果没有,写"无")

## 第三步:风格
- 句句给数字,少用形容词。
- 不要"通过""赋能""抓手"这类词。

就是这么短的一份文件,让你的 Claude 拥有了"知道怎么写周报"的能力。

进阶一点的 Skill 还可以包含脚本和模板:

weekly-report/
├── SKILL.md              # 主指令(必需)
├── references/
│   ├── notion-fields.md  # Notion 字段说明
│   └── tone-guide.md     # 公司语气规范
├── scripts/
│   ├── fetch_notion.py   # 拉 Notion 数据的 Python 脚本
│   └── fetch_github.py   # 拉 GitHub 提交的 Python 脚本
└── templates/
    └── weekly.docx       # 公司周报 Word 模板

是不是很像你电脑上的一个"项目文件夹"?没错,本质上就是一个文件夹。

白话解释:一个 Skill = 一个文件夹 + 里面那份 SKILL.md。其它都是可选的"好料"。

四、Skill 跟你听过的那些东西,到底有什么不一样

如果你这两年关注过 AI 圈,你应该听过 Prompt、Custom GPT、ChatGPT Plugin、MCP 这些词。它们和 Skill 是什么关系?

我们一个一个对比:

1. Skill vs Prompt(提示词)

  • Prompt:你每次跟 AI 说的那句话。
  • Skill:被永久保存、被 AI 自动调用的"复用 Prompt + 工具 + 资源"包。

可以理解为:

Skill = 一个可复用的、超大号的、能带工具和文件的 Prompt。

类比:

  • Prompt 像你每次出门前现想"今天穿什么"。
  • Skill 像你衣柜里的那套"周一上班套装"——你只要说"上班装",它自己就出来了。

2. Skill vs Custom GPT(OpenAI 的自定义 GPTs)

Custom GPT 是 OpenAI 在 2023 年推出的产品。你可以在 ChatGPT 里造一个"小助手",给它起个名字、配个图标、设定它的人设和指令、上传一些知识文件。

听起来很像 Skill 对吧?但有几个本质差别:

维度 Custom GPT Agent Skill
平台 锁死在 ChatGPT 里 同时可在 Claude.ai、Desktop、Code、API 里跑
调用方式 用户手动选 GPT 后才会用 Claude 自己根据描述判断要不要用
能力 主要是 Prompt + 知识库 Prompt + 知识库 + 真实可执行脚本
多个能力组合 一个 GPT 一次只能用一种 多个 Skill 可以在同一对话里被同时召唤
加载成本 一旦选了,全部上下文塞进去 渐进式加载,平时只占 100 token
是否开放格式 私有,跑不出 OpenAI 完全开放,就是文件夹+md,可以放 GitHub 任何地方

最关键的区别在最后一行:Skill 是一种开放的格式,不绑定任何厂商。你今天写的 Skill,明天有别的模型支持这种格式,照样能用。

3. Skill vs ChatGPT Plugin(已下线)

Plugin 是 OpenAI 在 2023 年高调推出又在 2024 年悄悄下线的功能。它的逻辑是"AI 调用第三方 API",比如让 ChatGPT 调用 Expedia 的 API 帮你订酒店。

为什么 Plugin 死掉了?因为:

  1. 每个 Plugin 都得开发者搭一个 OpenAPI 服务端,门槛太高,普通用户做不了。
  2. 调用要走网络,又慢又容易超时。
  3. AI 决定要不要用 Plugin 的逻辑很差,经常该用的不用。

Skill 把这三个问题全解决了:

  1. 写 Skill 不用搭服务端,就是一个文件夹。
  2. Skill 在本地跑(或在 Claude 的沙箱里跑),快得多。
  3. Skill 的调用决策做得更好,因为有渐进式披露架构(第三章详讲)。

一句话:Skill 是 Plugin 的精神继承者,但门槛低了 100 倍。

4. Skill vs MCP(Model Context Protocol)

MCP 是 Anthropic 在 2024 年推出的另一项重要协议,全称 Model Context Protocol(模型上下文协议)。你可以理解为"AI 的 USB 接口"——任何工具只要做一个 MCP Server,AI 就能接入。

Skill 和 MCP 不冲突,反而互补:

  • MCP 解决的是"AI 怎么连上外部工具"——比如怎么连 Notion、怎么连 GitHub、怎么连 Postgres。
  • Skill 解决的是"AI 怎么用这些工具去完成具体任务"——比如怎么用 Notion + GitHub 写一份周报。

可以这么类比:

  • MCP 是"水电气管道"——基础设施,让 AI 能取水取电。
  • Skill 是"菜谱"——告诉 AI 怎么用水电气煮一桌菜。

一个家庭可以只装管道不做菜(光装 MCP),但那是浪费;最好的状态是两者都有:管道接得齐,菜谱也丰富。

5. 一张图看懂

            +-----------------------------+
            |  你说一句话                  |
            +-----------------------------+
                       |
                       v
            +-----------------------------+
            |  Claude 大模型              |
            |  (理解 + 决策)              |
            +-----------------------------+
              |        |        |
       Prompt |        | Skill  | MCP
              v        v        v
        当下指令    肌肉记忆   工具接口
        (一次性)    (可复用)   (基础设施)
              |        |        |
              v        v        v
            +-----------------------------+
            |  完成任务并交付              |
            +-----------------------------+

五、Skill 能做什么,不能做什么

能做的(20 件普通人立刻能上手的事)

我把它分成四类,方便你对号入座:

A. 文档与表格类

  1. 把一摞 PDF 自动整理成 Word,并生成目录。
  2. 把多张 Excel 合并、清洗、做透视、画图。
  3. 把会议录音转文字、生成纪要、提取待办。
  4. 把 PPT 模板填上数据后一键生成完整 PPT。
  5. 给一份杂乱的 Word 重新排版、统一字体和格式。

B. 信息收集与监控类

  1. 监控某商品价格、某机票变动,到点告诉你。
  2. 每天早 8 点把你订阅的 10 个公众号文章总结发到你邮箱。
  3. 把 B 站收藏的视频自动转成"读书卡片"。
  4. 监控竞品在 App Store 的更新和差评。
  5. 关注的 GitHub 仓库有更新就自动总结发你。

C. 生活与家庭类

  1. 给爸妈做的"语音转购物清单"——他们说"鸡蛋两盒、酱油一瓶",自动出清单。
  2. 微信账单截图自动入账到家庭账本。
  3. 把 5000 张照片按"宝宝/旅行/食物/截图"自动分类。
  4. 给小孩的小学作业拍照后批改,标错并讲解。
  5. 一句话生成 5 天日本旅行的详细行程,含景点、餐厅、地铁。

D. 工作场景类

  1. 周报、月报、季度报告自动生成。
  2. 客户跟进表自动从邮件 / 钉钉 / 飞书拉数据更新。
  3. 招聘场景:一摞简历自动按你"想要的人才标签"打分排序。
  4. 销售提案:客户名 + 客户痛点 → 一键出 15 页 PPT。
  5. 月度财务报表自动生成,含趋势图、异常提醒。

第六章和第七章会带你完整跑完这 20 件事中的 15 件。

不能做的(4 件不要指望 Skill 能办的事)

老老实实告诉你 Skill 的边界,免得你白学:

  1. 完全实时的、毫秒级的反应:Skill 适合"分钟级到小时级"的任务。如果你要做高频量化交易、毫秒级风控,Skill 不是合适的工具。
  2. 没有数据 / API 的事:Skill 再强,也得有数据可拉、有工具可用。如果你公司 100% 数据躺在打印纸上,Skill 也没办法。
  3. 完全主观的创作:Skill 能帮你写"按格式的"文档;它写不出真正打动人的小说、歌词。这部分还是得你自己动手。
  4. 彻底替代你的判断:Skill 是助手,不是老板。最终决策还是你的事。

六、3 个常见误解,先帮你纠偏

误解 1:"Skill 不就是 Prompt 模板吗?"

不是。Prompt 模板是死的文字,Skill 是"文字 + 脚本 + 模板 + 文件 + 工具"的复合体。

最关键的差别是:Prompt 模板靠你手动复制粘贴才能复用,Skill 由 AI 自动判断要不要用

误解 2:"Skill 一定要会写代码才能用"

错。Skill 的最低门槛是会写 Markdown(你写公众号、写笔记的格式)。

会代码当然是加分项——你能在 Skill 里嵌入 Python 脚本,做更复杂的事。但这只是 Skill 的进阶玩法,不是入门门槛。

第八章你会看到,一个完全不会代码的人,也能写出能用的 Skill。

误解 3:"Skill 必须用 Claude Pro 才能用"

不一定。Claude.ai 的免费档目前有限制,但 Claude Code(终端版)和 Claude API 是按使用量计费,没有 Pro 订阅也能用 Skill

更重要的是:写 Skill 这件事本身完全免费。你写好的 Skill 可以分享给别人,对方用自己的账号跑就行。

七、自检清单:你适不适合学 Skill

打开下面的清单,给自己打分。每条 1 分,5 分及以上强烈建议读完这本书。

  • 我每周有至少 3 件事是"重复劳动"——做之前就知道怎么做。
  • 我的工作里有大量"格式固定"的文档(周报、月报、客户跟进、合同)。
  • 我经常需要把数据从一个地方搬到另一个地方(比如 Excel → PPT、邮件 → CRM)。
  • 我用过 ChatGPT 或 Claude,但觉得"它没那么神"。
  • 我加班的时间里,有相当一部分是在做"机械活"。
  • 我已经付费了 Claude Pro / ChatGPT Plus,但其实没用透。
  • 我想给爸妈 / 伴侣 / 团队配一个"AI 助理"。
  • 我有副业 / 自媒体 / 小生意,希望"睡后自动跑"。
  • 我对"AI 自动化"有好奇,但被英文文档劝退过。
  • 我希望 5 年后还在 IT 行业有竞争力(不论你是不是程序员)。

7 分及以上:恭喜,你就是这本书的"理想读者"。

4–6 分:你能从这本书拿到至少 3 个立刻能用的场景。

1–3 分:你可能没那么需要 Skill,但建议读完第一、二、四章——至少知道这世界正在发生什么。

八、本章一图回顾

+-------------------+   +-------------------+   +-------------------+
|     什么是它      |   |     和谁不一样     |   |     能做什么      |
+-------------------+   +-------------------+   +-------------------+
| 1. AI 应用商店    |   | vs Prompt: 持久 + |   | 文档表格 5 件     |
| 2. AI 入职手册    |   |    带工具         |   | 监控收集 5 件     |
| 3. AI 肌肉记忆    |   | vs Custom GPT:    |   | 生活家庭 5 件     |
|                   |   |    跨平台 + 开放  |   | 工作场景 5 件     |
| 一个文件夹        |   | vs Plugin:        |   |                   |
| + 一份 SKILL.md   |   |    门槛低 100 倍  |   | 不能做:           |
|                   |   | vs MCP:           |   |  实时毫秒级       |
| 进阶可加:         |   |    互补关系       |   |  无数据无 API     |
|  scripts/         |   |    管道 vs 菜谱   |   |  纯主观创作       |
|  templates/       |   |                   |   |  替你做最终决策   |
|  references/      |   |                   |   |                   |
+-------------------+   +-------------------+   +-------------------+

给你 3 句话提醒

  1. Skill 不是新名词,是一种"把工作方法标准化"的古老智慧。新的只是它现在能被 AI 直接执行。
  2. 别等"完全理解"再开始。第二章 5 分钟你就能跑通第一个 Skill。
  3. 学 Skill 的本质,是在学"怎么把你脑子里那些'你才知道怎么干'的事,让 AI 也学会"。这件事的复利会持续到你退休。

下一章预告

下一章 第二章 五分钟初体验,我们就要打开电脑了。

我会带你在 Claude.ai 网页版(最简单)、Claude Desktop、Claude Code 三种环境里分别开启 Skill 功能,然后用 Anthropic 官方的 xlsx Skill 跑通你人生第一个实战——把一份混乱的 Excel 自动整理成清晰的总结表。

预计 5 分钟,做完你就比 80% 的"听过 Skill 但没用过"的人多走一步。

走,进第二章。