Agent Skills

一种轻量级开放标准，用于将领域专业知识和工作流封装为可复用、可版本控制的包，让 AI Agent 按需加载并执行特定任务。

Agent Skills（智能体技能）由 Anthropic 于 2025 年提出并开源，现已被 Cursor、OpenAI Codex、GitHub Copilot、VS Code、Claude Code、Gemini CLI 等 30+ 个主流 AI 工具采纳。它解决了 Agent "有能力但缺乏上下文" 的核心矛盾——将程序性知识和组织专属上下文打包成 Agent 可动态加载的指令集。

核心问题

现代 AI Agent 的推理和工具调用能力越来越强，但在执行真实工作时往往缺少关键上下文：

领域专业知识 — 如何审查法律合同、如何执行数据管道、如何遵循品牌规范
组织专属惯例 — 内部的 API 模式、代码规范、审批流程
非显而易见的边界情况 — 某个端点返回 200 不代表服务健康，某张表的软删除需要额外过滤

Agent Skills 通过将上述知识封装为可移植、支持版本控制的文件夹，让 Agent 在需要时自动加载并执行。

核心特性

特性	说明
可移植	一次构建，跨平台复用——同一 Skill 可在 Claude.ai、Cursor、Codex、VS Code 等任意兼容客户端运行
渐进式加载	Agent 启动时仅加载 Skill 的 `name` 和 `description`（约 100 tokens），仅在匹配任务时才加载完整指令
可版本控制	纯文本格式，天然适合 Git 管理，支持团队协作和迭代优化
可组合	多个 Skill 可叠加使用，Agent 自动判断何时调用哪个 Skill
可执行	Skill 可捆绑脚本（Bash/Python/JS 等），Agent 可直接运行

目录结构

工作原理：渐进式披露

Agent Skills 采用三层渐进式加载机制，确保上下文高效利用：

发现（Discovery） — Agent 启动时扫描 Skill 目录，仅加载每个 Skill 的 name 和 description，判断何时可能相关
激活（Activation） — 当任务描述匹配 Skill 的 description 时，Agent 将完整 SKILL.md 指令加载进上下文
执行（Execution） — Agent 遵循指令，按需执行捆绑脚本或加载参考文件

这种设计让 Agent 可以同时持有数十个 Skill，而上下文占用极小。

支持 Agent Skills 的主流平台

Agent Skills 已被广泛采纳，覆盖 IDE、CLI、桌面应用和云平台：

Claude (Anthropic) — Claude.ai 网页端、Claude Code CLI
OpenAI Codex — Codex CLI 和 IDE 扩展
Cursor — AI 编程 IDE，从 2.4 版本原生支持
GitHub Copilot — VS Code 中的 Copilot Chat Agent 模式
VS Code — 原生 Agent Skills 支持
Gemini CLI — Google 开源终端 AI Agent
Goose (Block) — 开源可扩展 AI Agent
Roo Code — 开源 AI 开发团队
Junie (JetBrains) — IntelliJ 平台的 LLM 编程 Agent
OpenHands — 开源云端编码 Agent 平台
Spring AI — Java AI 应用开发框架
Google AI Edge Gallery — 移动端 LLM 运行环境
以及更多 — 完整列表见 agentskills.io/clients

文档导航

本系列文档系统化介绍 Agent Skills：

Agent Skills 总览 — 概念、价值定位与核心设计哲学
SKILL.md 格式规范 — 完整的文件格式、Frontmatter 字段、目录结构标准
生态与平台支持 — 各大平台实现差异、Google Skills 仓库、社区生态
创建与使用最佳实践 — 从真实 expertise 提取 Skill、上下文优化、验证与迭代

Agent Skills ​

核心问题 ​

核心特性 ​

目录结构 ​

工作原理：渐进式披露 ​

支持 Agent Skills 的主流平台 ​

文档导航 ​

延伸阅读 ​