Handbook · 第 2 章

Agent Skills:可复用的能力封装

把重复的工作流打包成 Skill,让 Agent 自动加载专业知识

章节大纲

2.1 什么是 Skill

  • Skill = 一个文件夹 + SKILL.md + 支持脚本
  • 类似“人类的操作手册”:Agent 遇到相关场景自动翻阅
  • Anthropic 提出的开放标准

2.2 Skill 的核心结构

skill-name/
├── SKILL.md          ← 说明+触发条件+步骤
├── scripts/          ← 可执行脚本
├── references/       ← 参考资料
└── examples/         ← 用例

2.3 SKILL.md 的写法

  • YAML frontmatter:name + description
  • description 决定 Agent 是否加载这个 Skill
  • 触发条件要具体,别写“处理各种任务”

2.4 三个真实 Skill 拆解

  • image-gen:调用生图 API 的封装
  • tavily-search:Web 搜索的备选方案
  • canvas:给 Agent 展示 HTML 的能力

2.5 Skill vs Prompt vs Function Call

  • Prompt 是一次性指令
  • Function Call 是工具调用协议
  • Skill 是“包含 Prompt 和 Function 的工作手册”

2.6 什么时候该封装成 Skill

  • 一个流程用了 3 次以上
  • 步骤多、容易踩坑
  • 需要跨会话保持一致

本章为大纲版本,正文待补充。