什么是技能(Skills)?
Agent Skills 是一种轻量级的开放格式,可通过专业知识和工作流程扩展 AI 代理的功能。
从本质上讲,技能(Skills)是一个包含SKILL.md文件的文件夹。该文件至少包含元数据(例如,`<metadata>`name和description`<file>`)以及指示智能体如何执行特定任务的指令。技能(Skills)还可以包含脚本、模板和参考资料。
my-skill/
├── SKILL.md # Required: instructions + metadata
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources技能是如何运作的
技能(Skills)运用渐进式披露来有效地管理背景信息:
发现:启动时,代理(Agent )只会加载每个可用技能(Skills)的名称和描述,仅足以知道何时可能相关。
激活:当任务与技能描述相符时,代理(Agent )会将完整的
SKILL.md指令解读到上下文中。执行:代理程序按照指令执行,可根据需要加载引用的文件或执行捆绑代码。
这种方法既能保证代理快速响应,又能让他们根据需要获取更多上下文信息。
SKILL.md 文件
每项技能都始于一个SKILL.md包含 YAML 前置元数据和 Markdown 指令的文件:
---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents.
---
# PDF Processing
## When to use this skill
Use this skill when the user needs to work with PDF files...
## How to extract text
1. Use pdfplumber for text extraction...
## How to fill forms
...以下前置信息必须放在文件顶部SKILL.md:
name:一个简短的标识符description何时使用此技能
Markdown 正文包含实际的指令,对结构或内容没有任何具体限制。这种简单的格式具有一些主要优势:
自文档化:技能作者或用户可以阅读
SKILL.md并理解其功能,从而使技能易于审核和改进。可扩展:技能的复杂程度可以从简单的文本指令到可执行代码、资源和模板不等。
便携性:技能只是文件,因此易于编辑、版本控制和共享。
下一步
查看规格说明以了解完整技能格式规范。
为您的Agent增加技能支持,以增强能力。
请查看GitHub 上的示例技能。
阅读写作最佳实践,提升写作技巧。
使用参考库验证技能并生成提示 XML。