Agent 技能(Agent Skills)
Agent 技能(Agent Skills) 是一种面向 AI 智能体 的模块化能力封装规范(最初由 Anthropic 提出并演进为开放规范 agentskills.io)。它以 SKILL.md 文件为核心,将特定领域的工程流程、判断规范、参考资料与可执行脚本打包为独立目录,并被 Claude Code、Codex CLI、Cursor 等主流编码智能体广泛采用。
目录结构与 SKILL.md 解剖
一个标准的 Agent Skill 是一个自包含文件夹,只需一个核心说明文件 SKILL.md,按需附带脚本与参考材料:
my-skill/
├── SKILL.md # 必填:YAML 元数据(name, description)+ Markdown 操作指令
├── scripts/ # 可选:确定性可执行脚本(Python / Bash 等)
├── references/ # 可选:按需读取的规范手册或 API 文档
└── assets/ # 可选:模板、配置文件或静态资源
SKILL.md 由两部分组成:
- YAML Frontmatter:定义机器可读的
name与触发描述description,告诉模型“何时应该启用该技能”。 - Markdown 正文:写明分步作业指令、校验门禁、边界约束与示例调用方式。
核心机制:渐进式披露(Progressive Disclosure)
如果把几十个领域的长篇 SOP 全部塞进系统提示词,会严重挤占上下文窗口并稀释注意力。Agent Skills 采用三段式渐进式披露来优化上下文工程:
- 发现阶段(Discovery):智能体启动时仅加载所有可用技能的
name与一句话description,每个技能仅占极少量 Token。 - 激活阶段(Activation):当用户请求命中技能描述(或通过
/skill-name显式调用)时,运行时才按需把对应SKILL.md正文读入上下文。 - 执行阶段(Execution):模型按指令步骤执行任务,仅在需要时再去读取
references/中的细节文档或运行scripts/里的确定性脚本。
与 MCP、提示词模板的区别
| 维度 | Agent Skills (SKILL.md) |
MCP (Model Context Protocol) | 普通提示词模板 |
|---|---|---|---|
| 核心解决什么 | “按什么步骤与规范做事”(流程、经验与本地脚本) | “如何安全连接外部工具与数据源”(标准化 RPC 协议) | “单次对话怎么问” |
| 运行时进程 | 无需常驻进程,纯文件系统目录 | 通常需要启动 stdio / SSE 服务进程 | 纯文本片段 |
| 上下文开销 | 渐进加载(触发前仅元信息) | 需向模型注入 Tool Schema 定义 | 需手动粘贴 |
| 互补关系 | 技能正文常指导 Agent 正确组合调用多个 MCP 工具 | 负责底层认证、权限与数据读取执行 | 适合一次性单轮任务 |
工程实践与安全边界
- 精准编写触发描述:
description既要写清“用来做什么”,也要写清“什么时候使用 / 不适用”,避免无关任务误触发加载。 - 脚本兜底确定性逻辑:对于格式校验、文件切片、构建发布等确定性动作,优先封装进
scripts/由 Agent 调用,而非依赖模型口述手敲长命令。 - 第三方技能审计:由于技能可附带可执行脚本与隐性指令,从外部仓库安装技能前应审查
SKILL.md与scripts/内容,防范提示注入或恶意命令执行。
进一步阅读
- Agent Skills Open Specification (agentskills.io) —
SKILL.md格式、目录结构与渐进加载开放标准 - Equipping Agents for the Real World with Agent Skills (Anthropic) — 工程设计原则与实战模式
- Model Context Protocol (MCP) — 与技能互补的工具接入协议规范