Agent Skill到底是什么？从使用到原理，一次讲清-尧图网络科技

摘要：Agent Skill已成为Agent领域的通用设计模式。本文从概念到实战，系统讲解Agent Skill的本质定义、基础使用方法、按需加载机制、Reference与Script两大高级功能，以及与MCP的区别与选型建议。全文含实操案例和对比表格，可直接落地。

1. Agent Skill是什么

2025年10月16日，Anthropic正式推出Agent Skill。起初官方定位很克制，只希望用它提升Claude在某些特定任务上的表现。但行业很快跟进，VS Code等工具陆续加入支持。12月18日，Anthropic将Agent Skill发布为开放标准，支持跨平台跨产品复用。Agent Skill已超越Claude单一产品范畴，正演变为Agent领域的通用设计模式。

用最通俗的话讲，Agent Skill就是大模型可以随时翻阅的说明文档。

举个：

智能客服场景：在Skill里交代遇到投诉先安抚情绪、不得随意承诺
会议总结场景：规定必须按参会人员、议题、决定这个格式输出

有了Skill，就不用每次对话都重复粘贴那些冗长的要求了。大模型自己翻翻说明文档就知道该怎么干活。

说明：起步阶段可将其理解为说明文档，实际上Agent Skill能做的事情远超于此，高级功能将在后文展开。

2. 基础使用：创建会议总结助手

2.1 创建Skill文件夹

在用户目录下的.cloudskill文件夹中创建Skill文件夹，文件夹名即Agent Skill的名称。

cd~/.cloudskillmkdir会议总结助手cd会议总结助手

2.2 创建skill.md文件

每个Agent Skill都需要一个skill.md文件，用于描述名称、用途和执行方式。

文件结构示例：

--- name: 会议总结助手 description: 用于总结会议录音内容，按固定格式输出参会人员、议题和决定 --- # 会议总结规则 你必须按照以下格式总结会议内容： ## 参会人员 列出所有参会人员 ## 议题 列出会议讨论的主要议题 ## 决定 列出会议做出的所有决定 ## 输入示例 （会议录音文本） ## 输出示例 ### 参会人员 张三、李四、王五 ### 议题 1. 项目进度汇报 2. 预算审批 ### 决定 1. 项目延期至下月 2. 预算获批

文件分为两部分：

部分	说明
元数据层（Metadata）	被两段短横线包裹，包含`name`和`description`。`name`必须与文件夹名相同
指令层（Instruction）	详细描述模型需要遵循的规则，可附带输入输出示例

2.3 验证使用

在Claude Code中输入：

你有哪些Agent Skill

Claude会列出已创建的Skill。然后输入：

总结一下会议的内容

粘贴会议录音文本后，Claude会询问是否使用会议总结助手这个Agent Skill。同意后，Claude读取skill.md文件，按规定的格式生成总结，参会人员、议题、决定三点清清楚楚。

3. 按需加载机制

3.1 三方角色与工作流程

整个流程涉及三个角色：用户、Claude Code、大模型（Claude模型）。

完整流程：

用户输入请求，Claude Code将用户请求连同所有Agent Skill的名称和描述（元数据层）发给大模型
大模型判断用户请求可使用哪个Agent Skill，将信息返回给Claude Code
Claude Code读取对应Agent Skill目录中的完整skill.md正文（指令层）
Claude Code将用户请求和完整的skill.md内容发给大模型
大模型根据skill.md要求生成响应，返回给用户

3.2 按需加载的核心价值

即使装了十几个Agent Skill，大模型最初只看到一份轻量级的目录，只有名称和描述。选中后才加载完整内容，这样就节省了大量token。

层级	内容	加载机制
元数据层	所有Skill的名称和描述	始终加载，相当于目录
指令层	skill.md中除名称和描述外的部分	按需加载，选中后才加载
资源层	Reference和Script	按需中的按需，条件触发后加载

4. 高级功能：Reference

4.1 场景需求

当会议总结助手越来越高级时，我们希望它能在会议决定涉及花钱时自动标注财务合规信息，涉及合同时提示法务风险。但若把所有财务规定和法律条文都写入skill.md，文件会变得臃肿，简单会议也要被迫加载一堆用不上的内容。

4.2 实现方式

Reference是条件触发的资源文件，仅在满足特定条件时加载。

步骤一：创建Reference文件

在Skill文件夹中创建集团财务手册.md：

# 集团财务手册 ## 报销标准 - 住宿补贴：500元/晚 - 餐饮费：人均300元 - 超出标准需CEO审批

步骤二：在skill.md中新增触发规则

## 财务提醒规则 仅在提到预算、采购、费用的时候触发。触发时需读取《集团财务手册.md》文件，根据文件内容指出会议决定中的金额是否超标，并明确审批人。

4.3 验证效果

使用包含老陈让小李订1200万酒店的会议内容。Claude首先意识到请求与会议总结助手相关，请求使用该Skill；然后发现会议与钱相关，根据规则请求读取《集团财务手册》；最终总结包含参会人员、议题、决定等基本信息，以及财务提醒，指出1200万酒店费用超标。

Reference是条件触发的，只有当Claude判断需要查账时才会加载财务文件。跟钱无关的技术复盘会，财务文件就只会躺在硬盘里，绝不占用任何token。

5. 高级功能：Script

5.1 实现方式

Script让Agent Skill能够执行代码，实现真正的自动化。

步骤一：创建脚本文件

在Skill文件夹中创建upload.py：

# 上传文件到服务器的脚本# 具体实现略

步骤二：在skill.md中添加上传规则

## 上传规则 如果用户提到上传、同步或发送到服务器，必须运行upload.py脚本，将总结内容上传到服务器。

5.2 验证效果

输入请求总结下这个会议的内容，并把它上传到服务器中。Claude生成会议总结后，请求执行upload.py文件，上传成功。

5.3 关键特性

特性	Reference	Script
操作类型	读取文件内容	执行代码
token占用	消耗token	几乎不消耗token
加载时机	条件触发时加载	条件触发时执行
代码可见性	内容被模型读取	代码不被读取，只关心执行结果

Script的代码只会被执行，不会被读取。哪怕脚本写了1万行业务逻辑，消耗的模型上下文也几乎是0。但如果没把代码执行方法说清楚，Claude还是可能去看代码的，所以写Skill时应尽可能解释清楚。

6. 渐进式披露结构总结

Agent Skill的设计是一个精密的三层渐进式披露结构：

层级	名称	内容	加载机制
第一层	元数据层	所有Skill的名称和描述	始终加载，相当于目录
第二层	指令层	skill.md正文	按需加载，选中后加载
第三层	资源层	Reference和Script	按需中的按需，条件触发后加载

资源层内部差异：Reference是被读取的，内容加载到上下文消耗token；Script是被执行的，代码内容不进入上下文，几乎不消耗token。

7. Agent Skill与MCP的区别

7.1 官方核心观点

Anthropic官方文章中的关键一句话：

MCP connects cloud data, skills teach cloud what to do with that data.

直接点明区别：

MCP给大模型供给数据，如查询昨天的销售记录、读取订单的物流状态
Skill教会大模型如何处理这些数据，如会议总结必须包含议题、汇报文档必须包含具体数据

7.2 对比表格

维度	MCP	Agent Skill
本质	独立运行的程序	一段说明文档
代码执行	安全性、稳定性更高	适合轻量脚本，处理简单逻辑
最佳场景	连接数据、复杂业务逻辑	定义处理规则、轻量自动化
数据连接	擅长	不擅长
数据处理指导	不擅长	擅长