什么是 Skills ?
约 683 字大约 2 分钟
2026-01-04
Agent Skills 是一种轻量级、开放的格式,用于通过专业知识和工作流扩展AI智能体的能力。
Skills 的核心是一个包含 SKILL.md 文件的文件夹。 该文件包含元数据(至少包含 name 和 description)以及指导智能体执行特定任务的指令。 Skills 还可以捆绑脚本、模板和参考资料。
my-skill
SKILL.md# 必需:说明 + 元数据
scripts# 可选:可执行代码
…
references# 可选:文档
…
assets# 可选:模板、资源
…
Skills 如何运作
技能采用 渐进式披露 来高效管理上下文:
- 发现:启动时,智能体仅加载每个可用技能的名称和描述,仅够判断何时可能相关。
- 激活:当任务与技能描述匹配时,智能体会将完整的SKILL.md指令读入上下文。
- 执行:智能体遵循指令,根据需要选择性加载引用文件或执行捆绑代码。
这种方法既保持了智能体的快速响应,又使其能按需获取更多上下文。
SKILL.md 文件
每个 Skills 都始于一个包含 YAML frontmatter 和 Markdown 内容的 SKILL.md 文件:
SKILL.md
---
name: pdf-processing
description: 从PDF文件中提取文本和表格,填写表单,合并文档。
---
# PDF处理
## 何时使用此 skill
当用户需要处理PDF文件时使用此 skill...
## 如何提取文本
1. 使用 pdfplumber 进行文本提取...
## 如何填写表格
...在 SKILL.md 文件顶部必须包含以下 frontmatter:
name:简短标识符description:使用此 Skill 的时机
Markdown 正文包含实际说明内容,对结构和内容没有特定限制。
这种简单格式具有若干关键优势:
自文档化:Skill 作者或用户通过阅读
SKILL.md即可理解其功能,便于 Skills 审计与改进。可扩展性:Skill 复杂度可涵盖从纯文本说明到可执行代码、资源文件和模板。
便携性:Skills 仅由文件构成,便于编辑、版本管理和共享。
