ORANGE BOOK · AGENT SKILL

第二章 五分钟初体验

你将学到

  • 在三种 Claude 客户端里分别启用 Skill。
  • 跑通你人生第一个 Skill 实战（用 5 行 Excel 数据演示）。
  • 看懂 Claude 在跑 Skill 时的"思考过程"。
  • 5 个最常见首次报错的对照解决方案。

你需要准备

  • 一台能上网的电脑（Mac、Windows、Linux 都行）。
  • 一个 Claude 账号（去 https://claude.ai 注册一个，免费档够用）。
  • 一份你随手能造的 Excel 表（不会的话本章会给你一份现成的）。
  • 5 分钟。

一、先选一个客户端：你属于哪种用户

Claude 有三种最主流的客户端，每种都支持 Skill，但操作略有不同。先对号入座：

客户端 适合谁 安装方式 Skill 启用门槛
Claude.ai 网页版 完全的新手；只想偶尔用 不用装，浏览器打开 Pro/Max 订阅；一键开启
Claude Desktop 经常用、想要本地体验 官网下载 .dmg / .exe 同上；功能最全
Claude Code（终端） 程序员、技术爱好者 一行命令安装 任何账号都能用

给完全新手的建议：从 Claude.ai 网页版开始。这一章我们会先用网页版做主线演示，然后告诉你 Desktop 和 Code 的差别。

白话解释：客户端 = 你跟 Claude 对话的"窗口"。三种客户端背后都是同一个 Claude 大模型，只是窗口不同。

二、Claude.ai 网页版：开启 Skill 功能（主线演示）

第 1 步：登录与确认订阅

打开 https://claude.ai，用邮箱登录。

Skill 功能目前需要：

  • Pro 订阅（个人，每月约 20 美元）
  • 或 Team / Enterprise 订阅（公司）

如果你是免费档，Claude.ai 网页版的 Skill 功能默认是关闭的。但别急——你可以：

  • 方案 A：先升级 Pro 体验一个月，跑完这本书再决定要不要续。
  • 方案 B：跳过本节，直接看后面的"Claude Code 篇"——它对账号没限制。

本书后续大部分章节都会兼顾"网页版 + Code"两条线，你不订 Pro 也能跟着学。

第 2 步：开启 Skills 与 Code Execution

登录后右上角点头像 → 进入「Settings」（设置）→ 找到「Capabilities」（能力）：

  • 打开「Code execution」（代码执行）开关。
  • 打开「Skills」开关。

白话解释：「Code execution」是 Claude 在沙箱里跑 Python 脚本的能力。Skill 里的脚本就是靠它跑起来的。所以这两个开关必须一起打开。

打开后，回到主界面，输入框上方应该会多出一行小图标，其中有一个像"积木块"的图标——那就是 Skills 入口。

第 3 步：检查官方 Skill 是否已激活

点开 Skills 图标，你应该能看到至少这几个 Anthropic 官方提供的 Skill：

  • xlsx：处理 Excel 文件
  • docx：处理 Word 文件
  • pptx：生成 PowerPoint
  • pdf：处理 PDF（提取文字、表格、合并、拆分）

它们应该已经默认开启。如果没开，把每个 Skill 旁边的开关打开。

这些 Skill 是 Anthropic 官方维护的，不需要你额外安装——只要 Skills 总开关打开了，它们就一直在那。

第 4 步：准备你的第一份 Excel

如果你手头没有 Excel，可以照着下面这份"假数据"自己用 Excel / Numbers / 在线工具造一份。文件名取作 sales-2026q1.xlsx，内容如下：

月份 销售额（元） 客户数 退货率
2026-01 128000 96 3.2%
2026-02 156000 112 2.8%
2026-03 189000 134 2.1%

不会做 Excel 的话，把上面这张表存成一个 .csv 文件也行，复制下面这段：

月份,销售额（元）,客户数,退货率
2026-01,128000,96,3.2%
2026-02,156000,112,2.8%
2026-03,189000,134,2.1%

用 Excel 打开后另存为 .xlsx 即可。

第 5 步：让 Claude 用 xlsx Skill 处理它

回到 Claude 主界面，把 sales-2026q1.xlsx 拖到输入框，然后输入下面这段话：

帮我读这份 Excel，做三件事：
1. 计算一季度总销售额和平均客户数。
2. 找出销售额环比增长最快的月份并给出增长率。
3. 在原表后面加一列"销售额排名"，按从高到低排序，把结果保存为一个新的 .xlsx 文件给我。

按回车，等 30 秒。

你会看到 Claude 的"思考过程"——它会显示：

"Reading the file with xlsx skill..." "Calculating totals..." "Adding ranking column..."

最后它会给你：

  • 一段总结（一季度总销售额、平均客户数、增长最快的月份）。
  • 一个可以下载的 sales-2026q1-ranked.xlsx 文件，里面真的多了一列"销售额排名"。

恭喜，你的第一个 Skill 实战完成了。

看到了吗？Claude 没有让你"自己去 Excel 加一列""自己去算环比"——它真的动手做了，而且做得对。这就是 Skill 的力量。

第 6 步：感受"它跑了什么"

很多人跑完第一次后会问："那……它到底干了啥？"

你可以让 Claude 自己解释一下。在同一个对话里继续输入：

把你刚才用 xlsx skill 时执行的 Python 代码也展示给我看一下。

它会贴出一段类似这样的代码：

import openpyxl
wb = openpyxl.load_workbook("sales-2026q1.xlsx")
ws = wb.active
data = [(row[0].value, row[1].value) for row in ws.iter_rows(min_row=2)]
sorted_data = sorted(data, key=lambda x: x[1], reverse=True)
ranks = {month: i+1 for i, (month, _) in enumerate(sorted_data)}
ws.cell(row=1, column=5, value="销售额排名")
for i, row in enumerate(ws.iter_rows(min_row=2), start=2):
    month = row[0].value
    ws.cell(row=i, column=5, value=ranks[month])
wb.save("sales-2026q1-ranked.xlsx")

看不懂没关系。你只需要知道：Claude 真的写了代码、真的在沙箱里跑了。这就是 xlsx Skill 在背后帮它做的事——告诉它"处理 Excel 用 openpyxl 这个库，按这套套路走"。

三、Claude Desktop 版：差别只有一处

如果你想在桌面客户端用 Skill：

  1. 去 https://claude.ai/download 下载 Claude Desktop（Mac、Windows 都有）。
  2. 安装后用同一个 Pro 账号登录。
  3. 设置入口在 「Claude Desktop」 → 「Settings」 → 「Features」（特性）。
  4. 同样要打开「Code execution」和「Skills」。

唯一的差别是：Desktop 版可以让 Claude 直接读取你电脑里的某些文件夹（需要你授权）。比如你在 Settings → Files 里授权了 ~/Documents/sales/，那以后你跟 Claude 说"帮我处理 sales 文件夹下最新一份 Excel"，它能直接拿到文件，不用你拖进去。

Desktop 适合你"长期把一堆文件交给 AI 处理"的场景。如果你不需要这种深度集成，网页版完全够用。

四、Claude Code：程序员或技术好奇者的选择

Claude Code 是 Anthropic 推出的"AI 终端 / IDE 助手"，可以装在 Mac、Linux、Windows 上。它对 Skill 的支持最完整，没有 Pro 订阅也能跑（按 API 用量计费，省钱玩家友好）。

第 1 步：安装 Claude Code

打开终端（Mac 用 Terminal、Windows 用 PowerShell），运行：

npm install -g @anthropic-ai/claude-code

如果你没装过 Node.js，先去 https://nodejs.org 装一下（选 LTS 版本即可）。

第 2 步：登录

claude

第一次运行会让你选认证方式。新手推荐用 OAuth（浏览器自动跳转）：

> Choose login method:
  1. Anthropic OAuth (recommended)
  2. API Key
> 1

按提示走完，回到终端就登录好了。

第 3 步：把 Skill 放到对应目录

Claude Code 的 Skill 默认在两个地方扫描：

  • 全局：~/.claude/skills/（你用户目录下，所有项目共享）
  • 项目级：当前项目根目录下的 .claude/skills/（只对这个项目生效）

我们先建一个全局目录：

mkdir -p ~/.claude/skills

接下来你可以装一个最简单的"hello world"Skill 验证一下：

mkdir -p ~/.claude/skills/hello-skillbook
cat > ~/.claude/skills/hello-skillbook/SKILL.md <<'EOF'
---
name: hello-skillbook
description: 一个 demo skill，用户说"测试 skillbook"或"hello skillbook"时触发，回复"Hi! Skill 已成功激活"。
---

# Hello Skillbook

当用户问候 skillbook 时：
1. 回复："Hi! Skill 已成功激活，你的 Claude Code 已经能识别 Skill 了。"
2. 然后用一句话告诉用户：现在可以开始装第三章里的官方 Skill 了。
EOF

上面这段是终端命令，把它整段复制到终端按回车即可执行。它会创建一个最简单的 Skill。

第 4 步：在 Claude Code 里测试

回到 Claude Code 对话窗口，输入：

测试 skillbook

如果配置正确，Claude 会回你：

"Hi! Skill 已成功激活，你的 Claude Code 已经能识别 Skill 了。现在可以开始装第三章里的官方 Skill 了。"

它没有用任何工具——它只是按照你写的 SKILL.md 里的指令做了回复。

这就是最最简单的 Skill：一份"AI 该说什么"的小册子。后面我们会让它越来越复杂、越来越能干。

第 5 步：在 Claude Code 里跑 xlsx 操作

Claude Code 默认就内置了对官方 Skill 的支持。你可以直接在终端里说：

读取当前目录下的 sales-2026q1.xlsx，按月份计算总销售额，并在原表加一列排名。

Claude Code 会显示：

● Bash(python -c "import openpyxl; ...")
  ⎿ Loaded sheet: Sheet1
  ⎿ Wrote output to sales-2026q1-ranked.xlsx

跟网页版一样的效果，只是在终端里完成。

Claude Code 的最大优势是 自由度高 + 适合长任务。比如你可以让它"每天早上 8 点跑一次这个 Skill 把日报发我邮箱"——这种事网页版做不了。

五、再做一个练习：让 Skill 帮你画图

跑通了基础版本后，再来一个稍微复杂的，让你看到 Skill 真正的威力：

打开任意一个客户端，输入：

基于刚才那份 sales-2026q1.xlsx，再帮我做一件事：
画一张折线图展示三个月的销售额趋势，再画一张柱状图展示客户数。
两张图都要中文标题、中文坐标轴。最后把两张图嵌入一个新的 .xlsx 文件给我。

Claude 会自动调用 xlsx Skill，背后用 matplotlib 画图，再用 openpyxl 把图片嵌入新 Excel。

30 秒后你拿到一个文件，里面有两张漂亮的图。这是你这辈子都不用再手动画图的开始。

六、5 个新手最常碰到的报错对照

报错 1：「Skill not found」/ 「I don't have access to Skills」

原因：Skills 总开关或 Code execution 开关没打开。

解决：

  • 网页版：Settings → Capabilities → 同时打开 Skills 和 Code execution。
  • Desktop：Settings → Features → 同上。
  • Code：检查 ~/.claude/settings.json 是否有 "enableSkills": false 之类的关闭项。

报错 2：「This file type is not supported」

原因：Claude 默认支持 .xlsx、.docx、.pptx、.pdf、.csv、.txt、.md、.png、.jpg 等常见格式。如果你给的是 .numbers（Mac 自带表格）或 .wps，它处理不了。

解决：先把文件另存为 .xlsx 再传。

报错 3：「Code execution timed out」

原因：Claude 的沙箱执行时间默认有上限（一般几分钟）。如果你的 Excel 有 100 万行，单次跑不完。

解决：

  • 把文件先拆小（按月、按部门、按客户）。
  • 在提示词里告诉 Claude："只处理前 1000 行做演示。"
  • 第七章会教你"分批处理 + 并行子任务"的进阶玩法。

报错 4：Skill 没被自动召唤（Claude 还是按聊天模式回答你）

原因：你的提示词里没有 description 里的"触发词"，Claude 没意识到该用 Skill。

解决：

  • 在提示词里显式说出文件类型：「这是一份 Excel」「这是一份 PDF」「这是一份 Word」。
  • 或者显式说出动作：「请处理」「请合并」「请提取表格」。
  • 进阶：把 description 写得更具体（第八章详讲）。

报错 5：Claude Code 提示「Permission denied: Bash」

原因：你装了一个会跑命令的 Skill，但 Claude Code 默认对 Bash 命令需要询问授权。

解决：

  • 第一次跑会弹"Always allow / Allow once / Deny"，根据 Skill 来源信任度选 Always 或 Once。
  • 第十章会详细讲怎么管 Skill 的权限。绝对不要对来源不明的 Skill 选 Always。

七、本章一图回顾

+----------------------------------------------------------+
|             3 种客户端 × Skill 启用流程                   |
+----------------------------------------------------------+
| Claude.ai 网页版                                         |
|   1. 登录 + Pro 订阅                                     |
|   2. Settings → Capabilities                             |
|   3. 同时开 Code execution + Skills                      |
|                                                          |
| Claude Desktop                                           |
|   1. 下载安装                                            |
|   2. Settings → Features                                 |
|   3. 同上 + 可授权本地文件夹                             |
|                                                          |
| Claude Code (终端)                                       |
|   1. npm install -g @anthropic-ai/claude-code            |
|   2. claude 登录 (OAuth)                                 |
|   3. Skill 放进 ~/.claude/skills/                        |
+----------------------------------------------------------+

第一个 Skill 实战:
  扔一份 Excel + 一句中文需求 → 30 秒拿到处理后的新表

八、给你 3 句话提醒

  1. 不要在 Skill 还没"动起来"前就纠结原理。先跑通，再回头看第三章。
  2. 每个 Skill 第一次用都让它失败一次。失败的报错会让你比看 100 篇教程还懂它。
  3. 如果你 5 分钟内没跑通，去翻"5 个常见报错对照"。80% 的问题都在那。

下一章预告

下一章 第三章 Skill 是怎么工作的（白话版），我会用一个"图书馆"的类比把 Skill 的"渐进式披露"机制讲透——为什么 Claude 能装 100 个 Skill 而不卡？为什么有的 Skill 描述写得不好就一直不被召唤？

读完那一章，你就知道"该怎么写一个被 AI 真正用上的 Skill"——这是后面每一章的基础。

走，进第三章。