Anthropic 用 Agent Skills 装备
来自 Anthropic Engineering · 期号 2025-10-16
摘要
Anthropic 推出 Agent Skills，一种用文件和文件夹构建专用 agent 的新方式。 核心设计是渐进式披露：一个 skill 是一个目录，内含 SKILL.md 文件，开头是 YAML 元数据（名称和描述）。启动时 agent 只加载元数据到系统提示词；当判断 skill 与当前任务相关时，才读取完整 SKILL.md。复杂 skill 还可引用目录内其他文件，按需加载。 Anthropic 已将其发布为跨平台开放标准。
深读
导读 Anthropic 推出 Agent Skills，一种用文件和文件夹为通用 agent 注入领域专长的新方式。核心设计是渐进式披露：agent 启动时只加载每个 skill 的名称和描述，判断与当前任务相关后才读取完整指令。这套方案已作为跨平台开放标准发布，适用于 Claude.ai、Claude Code、Agent SDK 等产品。 关键信息 - Agent Skills 是一个目录，内含 SKILL.md 文件，文件开头是 YAML 格式的元数据（name 和 description）。 - 启动时 agent 只将每个 skill 的元数据加载到系统提示词中；当判断 skill 与当前任务相关时，才读取完整的 SKILL.md。 - 复杂 skill 可在目录内捆绑额外文件（如 reference.md、forms.md），由 SKILL.md 按名称引用，agent 按需读取。 - 一个实际案例是 PDF skill：它包含一个预写的 Python 脚本，用于提取 PDF 中的所有表单字段，agent 可直接执行该脚本而无需将 PDF 或脚本读入上下文。 - Anthropic 于 2025 年 12 月 18 日将 Agent Skills 发布为跨平台开放标准，目前已在 Claude.ai、Claude Code、Claude Agent SDK 和 Claude Developer Platform 上得到支持。 逐节讲解 Skill 的结构与渐进式披露 一个 skill 是一个目录，其中必须包含 SKILL.md 文件。该文件以 YAML 元数据开头，包含 name 和 description。启动时 agent 只加载这些元数据到系统提示词中，这是渐进式披露的第一层。当 agent 判断该 skill 与当前任务相关时，才会读取完整的 SKILL.md 正文，这是第二层。对于更复杂的 skill，作者可以将指令拆分到目录内的其他文件中（如 reference.md、forms.md），由 SKILL.md 按名称引用，agent 只在需要时读取这些文件，这是第三层及更深的披露层级。 Skill 与上下文窗口的交互 当用户的请求触发某个 skill 时，上下文窗口的变化过程如下：初始状态包含核心系统提示词、所有已安装 skill 的元数据以及用户消息；agent 通过 Bash 工具读取 pdf/SKILL.md 的内容；接着 agent 选择读取 skill 捆绑的 forms.md 文件；最后 agent 在加载了 PDF skill 的相关指令后开始执行用户任务。由于 agent 拥有文件系统和代码执行工具，它无需将整个 skill 读入上下文窗口即可工作，因此一个 skill 可以捆绑几乎无上限的上下文内容。 Skill 中…