概述Agent Skills 的出现试图终结这个循环。它将 AI 从通用对话者转变为领域专家通过可复用、可版本化、可跨平台的知识包让 AI 掌握特定的工作流程、企业规范和专业技能。一、引言为什么我们需要 Agent Skills如果你用过 Claude、ChatGPT 或任何大模型你一定经历过这样的循环为了让 AI 完成一个特定任务你需要反复调试提示词每遇到一个新场景就要重新培训一次 AI同样的上下文需要一遍又一遍地塞进对话团队协作时每个人都在重复发明轮子Agent Skills的出现试图终结这个循环。它将 AI 从通用对话者转变为领域专家通过可复用、可版本化、可跨平台的知识包让 AI 掌握特定的工作流程、企业规范和专业技能。二、核心定义从Prompt到资产包在传统的 Agent 开发中我们习惯于将所有指令都塞进 System Prompt。但在 Agent Skills 范式下引入了一个核心概念技能即文件 (Skill as a File)。根据 agentskills.io 的定义Agent Skill 是一个标准化的文件夹结构它封装了扩展智能体能力所需的特定领域知识、指令和工具定义。它不再是一段虚无缥缈的提示词而是一个实实在在的资产包 (Asset Package)。一个标准的 Skill 可以用以下公式表示Skill Metadata Instructions (SOP) Examples ToolsMetadata元数据用于被系统索引和路由的标签name description相当于 App Store 的应用描述。Instructions指令自然语言编写的算法或 SOP标准作业程序相当于操作手册。Examples示例用于 Few-Shot Learning 的输入输出对锁定模型行为相当于培训案例。Tools依赖该技能运行所需的底层原子能力相当于工具箱。标准目录结构my-skill/── SKILL.md # 必需核心指令文件元数据 SOP── scripts/ # 可选可执行脚本 ── references/ # 可选参考文档── assets/ # 可选模板、资源文件── ... # 其他附加文件这种结构化的定义使得 Skill 具备了可移植性 (Portability)、可复用性 (Reusability)和可审计性 (Audibility)。三、架构核心三层渐进式加载机制 (Progressive Disclosure)为了在有限的 Token 预算内实现无限的能力扩展Agent Skills 采用了一套精妙的渐进式披露 (Progressive Disclosure)加载机制将 Skill 的生命周期划分为三个层级表格层级加载内容位置作用Token 消耗Level 1: 索引层仅 name description常驻 System Prompt建立能力目录极低 (~100 tokens)Level 2: 指令层SKILL.md 完整正文动态注入 Current ContextJIT (Just-in-Time) 知识注入按需加载 ( 5k tokens)Level 3: 执行层脚本、参考文档、资源文件运行时按需读取物理执行几乎无限制核心收益你可以安装几十个 Skills而 Agent 只会在需要时才加载具体指令。未触发的 Skill 不会消耗任何上下文 token。与传统方式对比对比维度传统方式Agent Skills 方式指令存放所有指令塞进 System Prompt元数据常驻指令按需加载Token 消耗固定且庞大动态且可控能力扩展受限无限扩展维护性难以维护模块化、可复用四、SKILL.md 标准协议详解SKILL.md 是承载业务逻辑的核心载体。它采用 Markdown YAML Frontmatter 的混合格式。4.1 关键字段规范字段最大长度允许字符注意事项name64 字符小写字母、数字、连字符不能包含 anthropic 或 claudedescription1,024 字符任意禁止 XML 标签必须说明做什么和何时使用4.2 Description 的最佳实践Description 是最重要的字段它决定了 Skill 是否会被正确触发。经验法则调整 description 可以提升约 50% 的触发准确率无需修改正文内容。4.3 标准模板--- name: my-skill-name description: A concise description of what this skill does and when to use it--- # My Skill Name ## Usage (使用场景) 明确描述在什么情况下应该激活此技能。## Steps (执行步骤) 这是 Skill 的灵魂。使用自然语言编写的算法逻辑SOP。1. 第一步做什么...2. 第二步调用哪个工具... ## Examples (示例) User: [用户输入] Assistant: [期望的思考过程和工具调用] ## Considerations (注意事项) 边界条件处理、错误重试机制或安全合规要求。五、实战案例构建企业级 Skill案例一代码审查规范 Skill--- name: code-review-standards description: | 应用团队的代码审查规范。在审查合并请求、分析代码质量、 或进行代码评审时使用。--- # 代码审查规范 ## 审查清单### 1. 安全性检查 - [ ] 检查 SQL 注入风险参数化查询 - [ ] 检查 XSS 攻击风险输入过滤/输出编码 - [ ] 检查权限绕过漏洞 - [ ] 检查敏感信息泄露### 2. 性能检查 - [ ] 标记 N1 查询问题 - [ ] 检查缺失的数据库索引 - [ ] 识别潜在的内存泄漏### 3. 编码风格 - [ ] 严格遵循团队规范 - [ ] 命名语义清晰 - [ ] 函数职责单一案例二数据分析流水线 Skill--- name:>六、进阶篇打造高级 Agent 的三大核心能力掌握了基础的 Skill 创建后若想进一步突破 Agent 的能力上限必须掌握三大进阶核心记忆、规划与工具链编排。这是区分普通对话机器人与高级智能体的分水岭。1. 记忆能力拒绝失忆越用越懂你普通的 AI 聊完即忘而高级 Agent 具备长期记忆能力能够记住用户的历史习惯、过往任务和偏好设置。短期记忆精准记录当前复杂任务的上下文细节。长期记忆沉淀用户偏好。例如你曾要求 Agent 写文案简洁、接地气下次无需重复强调它会自动沿用此风格。进阶技巧在 Skill 的指令中加入记忆规则如记住用户偏好的文案风格下次默认使用让 Skill 具备自我进化的基础。2. 规划能力复杂任务的分步拆解面对简单任务Agent 可直接执行但面对如制定年度营销方案这类复杂目标Agent 需要具备自主规划能力。任务拆解Agent 能够自动将大目标拆解为市场调研 → 目标设定 → 策略制定 → 预算分配 → 执行计划 → 效果评估等子任务。动态调整在每一步执行中Agent 能够根据上一步的结果灵活调整后续顺序遇到问题能自主排障。进阶技巧在 SKILL.md 中加入规划逻辑明确要求复杂任务先拆成 5 个核心步骤再逐步细化。3. 工具链编排与高级扩展从单点工具到自动化流水线高级 Agent 不局限于调用单一工具而是能够跨工具协作甚至处理条件分支与自动化代码。Reference条件触发资料实现按需中的按需加载。例如在会议总结 Skill 中仅当识别到预算、采购等关键词时才动态加载《集团财务合规手册》作为参考避免冗余内容占用上下文。Script代码自动化执行对于数据格式转换、文件校验等需要确定性输出的重复操作直接在 scripts/ 目录下编写 Python/Node.js 脚本。Agent 调用脚本直接执行无需消耗大量 Token 进行推理。跨工具协作Agent 能够像项目经理一样先调用 Excel 取数 → 调用 Python 分析 → 调用 PPT 生成图表 → 调用 Word 撰写报告形成一条完整的自动化流水线。4. 自我进化让 Skill 成为活的系统最高级的 Skill 具备自我优化的能力。当 Agent 在执行过程中发现了更优的操作路径、修正了命令模式或积累了可复用的经验时它能够自动更新 Skill 中的注意事项Gotchas或执行逻辑。Skill 不再是静态的文档而是随着业务实践不断生长的肌肉记忆。七、跨平台兼容性一次编写处处运行截至 2026 年主流 AI 平台均已支持 Agent Skills 标准平台支持方式Claude Code原生支持~/.claude/skillsClaude.ai付费用户可用ChatGPT通过 Skills 文件夹支持Codex CLI–enable skills 标志Cursor项目级 Skills 支持GitHub CopilotVS Code 集成Gemini CLI原生支持GooseBlock 出品原生支持Roo Code / Trae / Windsurf原生支持安装方式使用官方安装工具# 使用 npx skills 安装 npx skills add owner/repo# 示例安装 Anthropic 官方 Skills npx skills add anthropics/skills# 示例安装特定 Skill npx skills add github.com/anthropics/skills/tree/main/skills/pdf八、热门 Agent Skills 资源站在 Agent Skills 范式下我们无需从零开始编写每一个功能。全球开发者已经贡献了海量的 Skill 资产。Anthropic Official Skills (官方标准库)网址https://github.com/anthropics/skills特点官方出品代表 Skill 开发的最高标准和最佳实践。涵盖创意生成、技术开发、企业工作流等全场景。skills.sh (官方分发中心)网址https://skills.sh特点主要分发平台维护热门 Skills 排行榜。支持 npx skills add 一键安装跨平台兼容。Awesome Agent Skills (社区精选集)网址https://github.com/VoltAgent/awesome-agent-skills特点跨平台兼容适配 Claude, Codex, Gemini CLI 等。收录了 Vercel, Stripe, Cloudflare 等团队的官方 Skill已收录 300 高质量 Skill。agentskills.io (官方文档站)网址https://agentskills.io特点完整规范文档、最佳实践指南、社区入口。九、企业落地实践指南9.1 Skill 开发流程需求分析识别重复性工作确定知识边界定义成功标准。草稿编写编写 SKILL.md准备示例用例组织参考文档。测试验证在 Claude Code 中测试验证触发准确率检查输出质量。迭代优化根据反馈调整 description完善指令和示例优化 Token 消耗。发布分发提交到团队仓库或发布到 skills.sh编写使用文档。9.2 团队协作模式建议建立团队级 Skill 仓库my-company-skills/ ── README.md # 使用说明 ── skills/ │ ├── code-review/ # 代码审查规范 │ ├── deployment-check/ # 部署检查清单 │ ├── meeting-notes/ # 会议纪要模板 │ ── onboarding/ # 新人入职指南 ── scripts/ ── install.sh # 批量安装脚本9.3 版本管理最佳实践使用语义化版本号主版本.次版本.修订号主版本不兼容的重大变更次版本向后兼容的功能新增修订号向后兼容的问题修复十、安全与合规考量10.1 Skill 安全审查清单在安装或使用第三方 Skill 时请检查来源可信是否来自官方或可信的开发者。代码审计是否检查了所有脚本内容。权限范围是否请求了不必要的权限。网络访问是否连接了未知的外部服务。敏感信息是否包含硬编码的密钥或凭证。10.2 企业级 Skill 的安全边界禁止行为不得执行 rm -rf 等破坏性命令不得访问 /etc、/root 等敏感目录不得下载未审核的外部依赖不得传输用户敏感数据到外部沙箱环境要求所有脚本在隔离环境中执行文件系统访问限制在项目目录内网络请求通过代理审计十一、总结从提示词工程到知识工程Agent Skills 代表了大模型应用开发的一次范式转变。表格阶段核心活动特点Prompt Engineering调整提示词一次性、不可复用、不稳定Agent Skills打包专业知识可复用、标准化、版本可控关键要点Skill 是资产不是提示词它是可版本化、可审计、可共享的知识包。渐进式加载是核心用有限的 Token 预算实现无限的能力扩展。跨平台是趋势一次编写处处运行。社区是未来像下载 App 一样获取 AI 能力。