你是不是也有过这样的崩溃时刻每次让 Claude 写代码都要重复粘贴 请使用我们的代码规范驼峰命名、2空格缩进、必须写单元测试 ——像极了每天入职新公司好不容易调教好的 Prompt 换个项目就完全失效之前的调教经验归零团队里每个人给 AI 的指令不一样导致输出的内容一会儿像资深架构师一会儿像刚毕业的新手。这些问题的根源其实是 AI 的 专业能力无法沉淀。直到 2025 年 10 月 Anthropic 推出 Agent Skill又名 Claude Code Skill正是为解决这些问题而生。这不仅是 Claude 的新功能更是一个 开放的跨平台标准目前已被 OpenAI、Cursor、Trae 等主流工具跟进支持。本文将带你从 是什么 到 怎么用在实际工作中彻底掌握这个比 Prompt 更高级、比 MCP 更易用的 AI 编程神器。二、到底什么是 Agent Skill用最通俗的比喻Agent Skill 是 AI 的 入职手册 工具箱。想象你招了一位天才实习生 Claude 他智商极高但不懂你们公司的业务。传统的做法是每次布置任务都口头交代一遍 Prompt 而 Agent Skill 则是给他一本完整的标准作业程序 SOP 入职手册SKILL.md包含岗位描述、工作流程、注意事项 工具箱Scripts处理特定任务的脚本和代码 参考资料References行业规范、模板素材、API文档技术本质Agent Skill 是一个标准化的文件夹结构核心必须包含 SKILL.md 文件YAML元数据 Markdown说明可选包含脚本、模板等资源文件。my-skill/ # 技能包根目录├── SKILL.md # 核心文件元数据 工作流指令必须├── scripts/ # 可选自动化脚本Python/Bash├── references/ # 可选专业文档、API手册、FAQ└── assets/ # 可选模板、示例、静态资源当 AI 检测到相关任务时会自动 翻开 对应的手册严格按照既定流程执行无需你每次都重复交代。三、Skill工作原理Skill 最精妙的设计是它的 渐进式加载机制 —— 就像你查字典先看目录再翻对应章节最后查附录不会一上来就把整本书塞进脑子里。3.1. 三层加载用最少的 Token 做最多的事1-核心机制加载层级 内容类型 加载时机 作用L1 元数据名片 Agent 启动时自动加载 让AI知道“有什么技能可用”L2 说明文档正文 匹配用户需求时加载 教AI“具体怎么做”L3 资源文件脚本 / 模板 执行中按需加载 提供“工具/素材支持”3.2. 四步执行流程2-执行流程 意图匹配AI 扫描所有 Skill 的元数据找到最匹配当前任务的技能 读取指南加载对应 SKILL.md掌握执行步骤、检查点、输出规范 按需执行调用 scripts/ 中的脚本查询 references/ 中的资料✅ 反馈结果按模板输出成果或询问缺失信息四、现有技术的对比4.1. Agent Skill vs Prompt维度 普通 Prompt Agent Skill性质 临时指令用完即走 标准化流程永久复用加载方式 每次全量输入 按需渐进加载稳定性 依赖模型记忆易漂移 固化检查点强制执行管理 分散在聊天记录里 文件化、版本可控共享 复制粘贴易丢失格式 整包分享开箱即用一句话总结Prompt 是 口头交代Skills 是书面 SOP 工具箱。4.2. Agent Skill vs 多 Agent 架构维度 多 Agent 架构 Agent Skill复杂度 重量级需要架构设计 轻量级单个文件夹即可适用场景 复杂并行任务如研究写作审核同时进行 单领域深度任务如专业代码审查资源消耗 高需调度多个 Agent 实例 低单 Agent 内能力切换启动成本 需要搭建 Agent 框架 零成本复制文件夹即可关系 体系级解决方案 单元级能力模块可被多 Agent 调用4.3. Agent Skill vs MCP维度 MCP Agent Skill定位 连接协议AI 与外部系统的USB 接口 执行标准AI 做事的操作手册解决的问题 能不能连访问数据库、API、文件系统 怎么做流程、规范、最佳实践技术形态 需要运行 MCP ServerTypeScript/Python 静态文件夹Markdown 脚本加载时机 启动时建立连接 按需渐进加载关系 互补MCP 提供“工具” Skills 提供“使用指南”MCP 让 AI 能连上数据库Skill 教 AI 怎么按你们公司的规范查数据、生成报表、处理异常。两者配合AI 才能真正成为懂行的专家。五、创建你的第一个 Agent Skill下面用 会议纪要整理助手 为例从零创建一个 Skill场景开会录音转文字后需要整理成结构化会议纪要。不同会议类型周会/项目复盘/客户沟通需要不同的整理模板。5.1. 创建 Skill 文件夹结构新建一个名为 meeting-minutes 的文件夹总体的文件结构如下/meeting-minutes/├── SKILL.md # L1技能元数据L2内容├── references/ # L3按会议类型按需加载│ ├── weekly-rule.md # 周会模板│ ├── retro-rule.md # 复盘模板│ └── client-rule.md # 客户沟通模板5.2. SKILL.md核心文件5.2.1. 元数据在 SKILL.md 文件最开头以上下两个 — 作为元数据标识name: meeting-minutesdescription: 办公室通用会议纪要整理助手支持周会/项目复盘会/客户沟通会三类场景自动识别会议类型按需加载对应会议规则智能提取关键信息输出结构化纪要。5.2.2. SKILL内容3-编写SKILL5.3. 编写模块化配置references4-编写模块化配置references通过文件分离AI每次只读取当前任务所需的规则避免 Context 污染5.4. 测试你的 Skill以 Trae 为例Trae 作为国内的 AI IDE 已原生支持 Agent Skills官网https://www.trae.cn/下载并安装 TRAE IDE5.4.1. 导入Skill创建一个文件夹例如 my_skills使用 TRAE IDE 打开这个文件夹将 meeting-minutes 文件夹复制到 my_skills/.trae/skills/ 目录下5.4.2. 输入提示词需要切换为 SOLO 模式然后在对话框输入以下提示词帮我生成周会会议纪要原始文本小明用户模块我搞完了已经提测。