一、智能体价值重塑手册 / 智能体与数字分身
07 看懂 Agent Skill 的定义和组成
一套工作方法如果每次都靠重新解释，使用者容易遗漏要求。Agent Skill 提供了一种保存方法与资源的形式，让支持它的智能体在相关任务中加载使用。
学习目标：看懂 Skill 的基本组成，区分文件格式、实际能力与运行条件。
1. Agent Skills 定义简述
Anthropic Agent Skills 的官方文档将其描述为扩展智能体能力的开放格式。一个 Skill 通常以目录组织，包含任务指令，也可以带有脚本、参考材料和模板，供 Agent 按需读取。
- 主要技术领域：智能体工程、软件能力封装与复用。
- 概念性质：本专栏采用的具体开放格式和工程机制，不是独立学科。
- 应用方向举例：将专业方法与工作流程封装为指令和资源包，供兼容智能体加载、执行和复用。
参考来源：Agent Skills 官方说明，Agent Skills Overview。
本文讨论这一开放格式及其应用。其他平台也可能把不同形式的插件或能力称为 skill，判断是否兼容时，需要查看具体格式和运行要求。
2. 一个 Skill 通常包含什么
| 内容 | 在开放格式中的位置 | 作用 |
|---|---|---|
| 名称、说明与任务指令 | SKILL.md | 说明何时使用和怎样执行 |
| 可执行脚本 | scripts 等可选目录 | 完成需要程序处理的操作 |
| 参考说明 | references 等可选目录 | 提供按需查阅的方法和资料 |
| 模板及其他资源 | assets 等可选目录 | 提供输出或执行所需素材 |
规范要求至少有 SKILL.md，并要求其中的元数据包含 name 和 description；脚本及资源目录是可选项。目录名和必需项依据规范，表中的用途是教学转述。[S06]
图 07 Skill 的组成与调用关系。原创教学图，参考 [S05][S06]。
3. Skill 不必只对应一个小动作
开放格式规定如何组织能力，并没有把每个 Skill 限定为一个极小步骤。官方说明允许扩展参考文件和其他资源，也描述了分阶段加载内容的方式。[S04][S06]
教学示例：
- 一套岗位能力评估 Skill，可以在同一个产品范围内组织背景了解、情境任务、评分、报告与后续练习。
- 构建者也可以把这些部分拆为多个 Skill。
- 两种组织方式的取舍，应看复用需要、维护方式和运行效果。
- 本专栏所说的“产品级 Skill”，是围绕一个完整用户目标设计的能力包。它可以包含多个子工作流、计算过程和判断规则，由智能体组织执行，提供完整的使用流程和成果。
4. 与提示词、知识库和工作流的关系
提示词表达一次或一类任务的要求，可以成为 Skill 的内容。
知识资料提供参考依据，也可以放入 Skill 或由它关联使用。
工作流安排任务顺序，可以写在 Skill 的执行说明中，或由外部系统负责。
这些是功能上的区别，并不要求每一部分都单独开发成软件。本专栏建议优先按使用和维护需要组织，而不为追求文件数量拆分能力。
5. 怎样判断一个 Skill 能不能用
先看适用任务、需要的输入和预期输出，再看工具、软件包、网络与账号等运行条件。规范中允许声明兼容性要求；支持读取格式，不等于已经具备它依赖的全部环境。[S06]
随后使用样本运行，核对结果。安装成功、触发成功和任务完成，是三个不同的检查点。
对于结果不佳的情况，要定位到指令、资料、脚本或其他组成部分。
6. 做中学
选择一个已有 Skill，让 Agent 先解释它的任务范围、输入输出和所需环境，再带一份合适的材料实际运行。运行后，请它指出本次使用了哪些说明和资源。
学习产出是一份使用记录：怎样触发、准备什么、得到什么、哪里需要调整。这个练习帮助你理解能力包如何进入实际工作，而不要求先学会编程。
信息来源
正文采用中文转述；编号对应解释所在段落。以下网址以明文列出。查阅日期：2026-09-18。
[S04] Anthropic｜Equipping agents for the real world with Agent Skills
来源类型：工程方法说明。参考内容：用专业知识与资源扩展通用智能体，按需加载技能。
https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
[S05] Agent Skills｜Agent Skills Overview
来源类型：开放格式官方文档。参考内容：Skill 的能力包形式与发现、加载、使用机制。
[S06] Agent Skills｜Specification
来源类型：开放格式规范。参考内容：SKILL.md 必需项与可选脚本、参考资料、资源目录。
