第 7 章 Skills 基础
面向经管学生、研究者与从业者的 AI 智能体设计教材
阅读指南
- 理解 Skill 的定义、价值和三种分类
- 掌握 SKILL.md 的结构、YAML frontmatter 字段规范和 description 写作方法
- 分析 渐进式披露的三层机制,判断触发问题的成因
- 辨析 Skill 与重复 prompt、命令、脚本、MCP 的职责差异
- 应用 设计原则评估一个任务是否适合封装为 Skill
本章核心概念速查
| 概念 | 定义 | 何时使用 | 常见错误 |
|---|---|---|---|
SKILL.md |
Skill 的核心定义文件 | 封装可复用任务流程时 | 把所有规则都堆在一个文件 |
| 渐进式披露 | 系统按匹配度分层加载 Skill 内容 | 理解 Skill 触发机制时 | 以为 Skill 始终全量加载 |
allowed-tools |
限定 Skill 可使用的工具列表 | 需要控制工具权限时 | 不设限导致越权操作 |
| Skill 触发 | 系统根据 description 自动匹配 Skill | 用户请求与 Skill 描述相关时 | description 写得太笼统 |
| 三类 Skill | 文档资产型、流程自动化型、MCP 增强型 | 判断 Skill 设计方向时 | 不区分类型一律套用同一模板 |

这一章回答:什么是 Agent Skill,一个最小 Skill 由什么构成,系统怎样发现并加载它,哪些任务适合先封装为 Skill。脚本编排、设计模式和测试迭代不在这里展开。
本章结构:先从重复提示的痛点引出 Skill 的价值,再拆解 SKILL.md 的结构与核心字段,然后讲触发与渐进式披露机制。接着梳理三类 Skill 的适用场景,最后收束设计原则与常见误区。
核心概念
Skill:一组打包在文件夹中的指令,教会 Claude 如何处理特定任务或工作流。Skill 的核心文件是 SKILL.md,包含 YAML 元数据和 Markdown 格式的执行规则。Skill 不是更长的 prompt——它由系统自动匹配和加载,具备渐进式披露机制,支持跨会话复用。