摘要Agent Skill已成为Agent领域的通用设计模式。本文从概念到实战系统讲解Agent Skill的本质定义、基础使用方法、按需加载机制、Reference与Script两大高级功能以及与MCP的区别与选型建议。全文含实操案例和对比表格可直接落地。目录Agent Skill是什么基础使用创建会议总结助手按需加载机制高级功能Reference高级功能Script渐进式披露结构总结Agent Skill与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 SkillClaude会列出已创建的Skill。然后输入总结一下会议的内容粘贴会议录音文本后Claude会询问是否使用会议总结助手这个Agent Skill。同意后Claude读取skill.md文件按规定的格式生成总结参会人员、议题、决定三点清清楚楚。3. 按需加载机制3.1 三方角色与工作流程整个流程涉及三个角色用户、Claude Code、大模型Claude模型。完整流程用户输入请求Claude Code将用户请求连同所有Agent Skill的名称和描述元数据层发给大模型大模型判断用户请求可使用哪个Agent Skill将信息返回给Claude CodeClaude Code读取对应Agent Skill目录中的完整skill.md正文指令层Claude Code将用户请求和完整的skill.md内容发给大模型大模型根据skill.md要求生成响应返回给用户3.2 按需加载的核心价值即使装了十几个Agent Skill大模型最初只看到一份轻量级的目录只有名称和描述。选中后才加载完整内容这样就节省了大量token。层级内容加载机制元数据层所有Skill的名称和描述始终加载相当于目录指令层skill.md中除名称和描述外的部分按需加载选中后才加载资源层Reference和Script按需中的按需条件触发后加载4. 高级功能Reference4.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. 高级功能Script5.1 实现方式Script让Agent Skill能够执行代码实现真正的自动化。步骤一创建脚本文件在Skill文件夹中创建upload.py# 上传文件到服务器的脚本# 具体实现略步骤二在skill.md中添加上传规则## 上传规则 如果用户提到上传、同步或发送到服务器必须运行upload.py脚本将总结内容上传到服务器。5.2 验证效果输入请求总结下这个会议的内容并把它上传到服务器中。Claude生成会议总结后请求执行upload.py文件上传成功。5.3 关键特性特性ReferenceScript操作类型读取文件内容执行代码token占用消耗token几乎不消耗token加载时机条件触发时加载条件触发时执行代码可见性内容被模型读取代码不被读取只关心执行结果Script的代码只会被执行不会被读取。哪怕脚本写了1万行业务逻辑消耗的模型上下文也几乎是0。但如果没把代码执行方法说清楚Claude还是可能去看代码的所以写Skill时应尽可能解释清楚。6. 渐进式披露结构总结Agent Skill的设计是一个精密的三层渐进式披露结构层级名称内容加载机制第一层元数据层所有Skill的名称和描述始终加载相当于目录第二层指令层skill.md正文按需加载选中后加载第三层资源层Reference和Script按需中的按需条件触发后加载资源层内部差异Reference是被读取的内容加载到上下文消耗tokenScript是被执行的代码内容不进入上下文几乎不消耗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 对比表格维度MCPAgent Skill本质独立运行的程序一段说明文档代码执行安全性、稳定性更高适合轻量脚本处理简单逻辑最佳场景连接数据、复杂业务逻辑定义处理规则、轻量自动化数据连接擅长不擅长数据处理指导不擅长擅长7.3 选型建议需要连接外部数据、执行复杂稳定业务逻辑 → 选择MCP需要定义处理规则、运行轻量脚本 → 选择Agent Skill很多场景下需要将Agent Skill和MCP结合起来使用以满足更复杂的需求8. 参考资源本文基于B站视频《Agent Skill 从使用到原理一次讲清》观点由Ai好记转录分析视频结构提炼教程核心步骤。如果你也正在学习AI干货需要看教程类长视频也可以试试Ai好记省时又省力如有问题欢迎评论区交流。如果本文对你有帮助点赞、收藏、转发支持
