智能体技能

Agent 技能是指令、脚本和资源的可移植包，提供 Agent 的专用功能和领域专业知识。技能遵循开放规范并实现渐进式披露模式，以便 Agent 在需要时仅加载所需上下文。

---

使用场景

• 封装领域专业知识 — 将费用政策、法律工作流、数据分析管道封装为可复用、可移植的包
• 扩展 Agent 功能 — 为 Agent 提供新能力，无需更改其核心指令
• 确保一致性 — 将多步骤任务转换为可重复的可审核工作流
• 启用互操作性 — 在不同的 Agent 技能兼容产品中复用同一技能

技能结构

技能是一个目录，包含 SKILL.md 文件，可以选择包括子目录：

expense-report/
├── SKILL.md                          # 必需 - frontmatter + instructions
├── scripts/
│   └── validate.py                   # 可执行代码
├── references/
│   └── POLICY_FAQ.md                 # 按需加载的参考文档
└── assets/
    └── expense-report-template.md    # 模板和静态资源

SKILL.md 格式

---
name: expense-report
description: >
  File and validate employee expense reports according to
  company policy. Use when asked about expense submissions,
  reimbursement rules, or spending limits.
license: Apache-2.0
compatibility: Requires python3
metadata:
  author: contoso-finance
  version: "2.1"
---

字段说明

字段	必填	说明
name	是	最多 64 字符。小写字母、数字和连字符。必须与父目录名匹配
description	是	技能的作用和使用时机。最多 1024 字符
license	否	许可证名称或引用
compatibility	否	最多 500 字符。环境要求
metadata	否	任意键值映射
allowed-tools	否	技能可用的预先批准工具列表

frontmatter 后的 markdown 正文包含技能说明——分步指导、输入输出示例、常见边缘情况。建议保持 SKILL.md 在 500 行以下，详细参考资料移到单独文件。

渐进式披露

Agent 技能的一个关键设计原则是渐进式披露——Agent 先看到简短的描述和核心指令，只有需要时才加载详细的参考文档和脚本。这避免了一次性加载过多上下文稀释 Agent 的注意力。

---

下一步：CodeAct — 通过代码执行扩展 Agent 能力。