Agent Skill 橙皮书上手与进阶指南

如何使用本书：本书允许你免费下载、传播、翻译、改编，但必须署名作者并保持相同协议开源，禁止任何形式的"封装售卖"或"去名转售"。

这本书是写给谁的

• 完全没听过 Agent Skill，但用过 Claude / ChatGPT / Kimi / 豆包，发现它们"很会聊天，但做不了什么实事"的人。
• 听过 Skill 这个词，被英文文档、YAML、Frontmatter、Progressive Disclosure 这些术语劝退过的人。
• 每天被 Excel 表格、PDF 报告、PPT 汇报、邮件回复、会议纪要压得喘不过气的上班族。
• 想给爸妈、给伴侣、给小孩、给团队配一个"AI 小助理"，但不知道从哪入手的人。
• 已经在用 Claude Code，但只把它当成"高级版 Cursor"的开发者。
• 自由职业者、内容创作者、副业玩家——想把"重复劳动"自动化成"睡后收入"的人。
• 好奇 AI Agent 这个新物种、想搞明白"它到底比聊天机器人强在哪"的所有人。

如果你属于以上任何一类，你来对地方了。

这本书不是什么

• 不是 Anthropic 官方的 Agent SDK 文档，也不是 Skills API 的源码导读。
• 不是写给资深工程师的"高级 Agent 架构剖析"。
• 不是堆术语、堆参数、堆截图的"功能罗列"。
• 不是"AI 即将取代你"或者"再不学就完蛋了"的焦虑营销。

它是一本实战手册。每一章都让你"打开 Claude 跟着做"，做完就能立刻看到效果。

为什么是 Agent Skill

2025 年 10 月，Anthropic 推出了一个看起来不起眼、但本质上改变了 AI 工具游戏规则的功能——Agent Skill。

在它之前，所有的 AI 工具都长得差不多：你打字、它回话、你再打字、它再回话。哪怕是号称"Agent"的产品，本质上也只是一个会调用工具的聊天框。

Agent Skill 把这件事彻底翻过来：你不用每次都"教"AI 怎么做，你只要把"做某件事的完整方法"打包成一个文件夹，丢给 Claude，它在合适的时候会自己拿出来用。

举个最朴素的例子。你每周都要写一份周报：从飞书拉上周日程、从 GitHub 拉本周提交、从 Notion 拉项目状态、最后排成统一格式发给老板。

• 在没有 Skill 的世界里：你每周都要重新告诉 Claude 一遍这套流程，反复 10 次仍然有 5 次格式不对。
• 在有 Skill 的世界里：你写一次 weekly-report Skill，从此每个周五说一句"帮我写一下本周周报"，Claude 自动按你的方法、你的格式、你的语气，拉数据、画表、生成成品。

这不是"聊天的延伸"。这是 AI 第一次有了职业肌肉记忆——你怎么训练它，它就怎么工作；你怎么打包知识，它就怎么执行。

而最神奇的是：这一切完全不需要你会写代码。Skill 的核心就是一个 Markdown 文件，写法跟你平时记笔记没差别。

你将获得什么

读完整本书并跟着做完练习，你会：

1. 真正理解 Agent Skill 是什么、和 Prompt / Custom GPT / 插件 / MCP 有何本质差别、它能不能解决你的问题。
2. 在三种最主流的 Claude 客户端（Claude.ai 网页版、Claude Desktop、Claude Code）里把 Skill 跑起来。
3. 学会用 Anthropic 官方提供的 4 个核心 Skill：xlsx、docx、pptx、pdf——把 Excel→PPT、PDF→Word、Word→Markdown 这类高频文档操作自动化。
4. 学会从社区市场（Claude Skills Marketplace、PolySkill、SkillsHunt 等）安装 Skill，并能判断一个 Skill 是不是值得装。
5. 把至少 7 个生活场景 + 8 个工作场景交给 Claude 自动跑（爸妈语音转清单、家庭账本、健身打卡、会议纪要、周报、客户跟进、销售提案、月度报表……）。
6. 写出自己的第一个 Skill——从 SKILL.md 文件结构、YAML frontmatter 全字段、到让 Claude 用 skill-creator 帮你生成。
7. 进阶到能在 Skill 里嵌入 Python 脚本、模板文件、参考文档、依赖声明，做出"会画甘特图""会查股票""会自动比价"的复合能力。
8. 知道怎么把 Skill 用得安全：识别 description 注入、限制 allowed-tools、审计第三方 Skill、保护家庭与财务隐私。
9. 避开新手最容易踩的 8 大坑（Skill 不被触发、描述写得太笼统、Skill 互相打架、账单失控……）。
10. 如果你愿意，还能把自己的 Skill 发布到 GitHub、加入社区、甚至把 Skill 创作做成一份长期副业。

阅读路径建议

这本书一共 1 个序言 + 12 章正文 + 5 个附录，全书约 20 万字。你不必从头读到尾，下面几条路径任选其一。

路径 A：完全新手（推荐）

按章节顺序从 00 序言 一路读到 12 从用户到创造者，每章跟着做完再看下一章。预计 1 个周末看完，跑通整套体验。

路径 B：只想立刻用起来

• 02 五分钟初体验
• 04 从官方 Skill 开始
• 05 从社区市场安装 Skill
• 附录 B 30 个开箱即用提示词

预计 1 小时跑通，先把 Skill 用起来再说。

路径 C：已经会用，想进阶

• 08 写自己的第一个 Skill
• 09 Skill 进阶（脚本/模板/依赖）
• 10 Skill 的安全与隐私
• 12 从用户到创造者

预计 1 个晚上读完，立刻让"被动用 Skill 的人"变成"主动造 Skill 的人"。

路径 D：想给爸妈、给团队挑工具的"决策者"

• 01 认识 Agent Skill 的"自检清单"
• 06 生活场景实战 的"给爸妈做的一键 Skill"
• 07 工作场景实战 的"团队内部 Skill"
• 11 避坑指南

路径 E：想做副业、做内容、做创作者

• 05 从社区市场安装 Skill
• 08 写自己的第一个 Skill
• 12 从用户到创造者
• 附录 E 100 项达成清单

完整目录

如何使用这本书

1. 先看「30 秒导读」：每一章开头都有一段 30 秒就能读完的导读，告诉你这章解决什么问题、做完会得到什么。如果不感兴趣，可以直接跳过。
2. 跟着「先做这一步」：所有命令、SKILL.md、提示词都给了完整可复制版本，建议至少跑通一次，再回头看原理。
3. 对照「本章一图回顾」：章末的小结帮你把这章串成一条线，方便日后翻查。
4. 遇到报错先翻附录：80% 的常见报错都收录在 第十一章 避坑指南 与 附录 A 常用 Skill 速查表 里。

本书使用约定

• 代码块：可以直接复制到终端、提示词输入框或 SKILL.md 文件里运行的内容。
• 「引号」：界面上的按钮、菜单或选项名称。
• 粗体：值得你停下来重点理解的关键词。
• 命令前面的 $ 表示这是终端里输入的命令，复制时不要带 $。
• 出现 ~/.claude/ 路径时，~ 代表你的用户主目录（macOS 是 /Users/你的名字/，Windows 是 C:\Users\你的名字\）。
• Skill 名称统一用 kebab-case 写法（小写 + 短横线，如 weekly-report），这是 Anthropic 官方约定。
• 所有截图都用文字描述路径替代，方便你在不同 Claude 版本里也能找到对应位置。

本书风格的小约定

• 我们假设你不是程序员，但愿意学一点点新东西。所有名词第一次出现都给"白话解释"。
• 我们不会让你"先理解原理再动手"，恰恰相反，我们让你先动手做出一个能跑的 Skill，再回头讲为什么。
• 我们不推荐你"先订阅 Pro 再说"。每一章都标注了"用免费档够不够"。
• 我们也不会假装 Skill 没缺点。第十一章会老老实实告诉你它在哪些场景会让你失望。

一句话总结

这本书要做的事情只有一件：让你这个普通人，不靠任何技术背景，也能把 Agent Skill 用得比 90% 的人都好——而且越用越好。

准备好了吗？翻开 00 序言 开始吧。

版本与变更

后续如有新增 / 勘误，会在本表追加，并在每章相关段落加 （v1.x 更新） 标注。

通用版工具箱（附录卷）

本书是 Agent Skill 的"产品专属指南"。如果你想要一份跨工具、不绑定任何产品的"通用 AI 工具箱"——100 个通用提示词、150+ AI 黑话翻译、30 天通用打卡计划、50 个高频 FAQ、安全红线、家庭 AI 公约——请翻 《AI 橙皮书（附录卷）：通用 AI 工具箱》。

它和本书是"互补"的：本书讲 "Skill 怎么写"，附录卷讲 "任何 AI 都通用的方法"——换工具不卡壳。

版权与署名

• 本书根据 CC BY-SA 4.0 协议开源，欢迎转载、翻译、改编。
• 转载请注明原书《Agent Skill 橙皮书：上手与进阶指南》及原始仓库地址。
• 改编版本必须保持同一协议开源。
• 商业用途（如纳入付费课程、纸质出版、收费社群）请先联系作者邮箱获取授权。

如果这本书帮到了你，最好的"赞赏"就是把它转发给一位被重复劳动压垮的朋友——也许他下周就因为你这个动作，每天少加 1 小时班。