Skill设计白皮书：Anthropic官方推荐的构建方法与避坑指南

技术人生黄勇

发布于 2026-03-11 17:33:13

2580

“ 如何让通用大模型真正落地专业场景始终是个难题。Anthropic推出的Skill机制，通过模块化的技能包设计，为Claude等AI模型注入了可复用、标准化的专业知识。本文将深入解析Skill的核心概念、技术架构与编写方法，带您了解这套让AI真正能干专业活的创新方案。”

而想要 OpenClaw 能用、好用，还需要安装合适需要它完成任务的 Skill 技能。

Skill（技能）是 Anthropic 公司推出的一种‌模块化能力扩展机制‌，目的让通用人工智能代理（Agent）具备特定领域的专业知识和执行能力。

它并非一个独立的产品，而是一种标准化的“技能包”格式，用于为 AI 模型（如 Claude）注入可复用、可共享的专业知识。

如何写一个Skill 可以参考官方出的这个指南（其他模型也适用）：

《The Complete Guide to Building Skills for Claude》：

https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en

—

Skill的定义和特性

核心定义

‌本质‌：一个 Skill 是一个‌结构化的文件夹‌，其中包含完成特定任务所需的所有信息，相当于给 AI 的“工作手册”或“SOP（标准作业程序）”。

‌核心文件‌：每个 Skill 必须包含一个 SKILL.md 文件，这是其核心指令和元数据的载体。

‌组成结构‌：

‌指令（Instructions）‌：告诉 AI 如何执行任务的步骤和逻辑。

‌代码（Code）‌：可选的脚本文件，用于执行确定性、重复性的操作（如文件处理、API 调用）。

‌资源（Resources）‌：包含模板、参考文档、数据格式等辅助材料。

关键特性

‌1、按需加载（渐进式披露）‌：这是 Skill 最核心的设计哲学。AI 在启动时只加载 Skill 的元数据（名称、描述），只有在判断当前任务需要时，才会动态加载详细的执行指南和资源。这极大节省了上下文（Token）消耗，提升了效率和稳定性。‌

‌2、可复用与可组合‌：一个 Skill 创建后，可以在不同对话、不同任务中反复调用。多个 Skill 还可以组合起来，构建更复杂的工作流。‌

‌3、标准化与开放‌：Anthropic 将 Skill 定义为跨平台的开放标准，打破了此前不同框架（如 LangChain、AutoGen）各自为政的混乱局面，让 Skill 可以在不同系统间移植和共享。‌

4、解耦智能与专业‌：它将 AI 的“通用推理能力”（模型核心）与“领域专业知识”（Skill）分离。业务规则更新时，只需修改 Skill 文件，无需重训模型，降低了维护成本。‌

Skill 与 ‌MCP（Model Context Protocol）为互补关系：MCP 是让 AI ‌连接‌外部工具和数据源（如数据库、API）的“钥匙”；Skill 是告诉 AI ‌如何使用‌这些钥匙的“操作手册”。‌

与智能体（Agent）的关系：Skill 是 Agent 的能力来源。Agent 是一个能规划、决策的“大脑”；Skill 是这个大脑所掌握的“技能”和“经验”。

‌Skill 的价值在于复用：你只需要教 Claude（大模型）一次（通过 Skill），它就能在每次对话中自动遵循这些指令，而不需要你每次都重新解释流程。

—

技术架构

Skill 并不是一次性加载所有内容，而是采用了渐进式披露（Progressive Disclosure）‍的设计，这样既保证了效率，也保证了专业性：

第一层（YAML Frontmatter）‍：
- 位于 SKILL.md文件的最上方，用 ---包裹。
- 作用：这是唯一总是加载到 Claude 系统提示中的内容。它只包含最简信息（技能名称、何时使用），用于决定何时“召唤”这个 Skill。
- 关键点：必须使用 kebab-case 命名（如my-skill），且描述字段必须明确包含“何时使用”（Trigger Phrases）。
第二层（SKILL.md 正文）‍：
- 位于 Frontmatter 之后。
- 作用：当 Claude 认为这个 Skill 相关时，会加载这个层级的内容。这里写具体的步骤、示例、模板等。
第三层（关联文件）‍：
- 例如 references/, assets/目录中的文件。
- 作用：Claude 只会在需要时才去查看这些文件。这样可以保持对话的 token 效率。

—

如何写

一、必备结构

your-skill-name/
├── SKILL.md          # 必需
├── scripts/          # 可选：代码脚本
├── references/       # 可选：文档
└── assets/           # 可选：模板/图标

二、编写规范

---
name: your-skill-name  # 必须是 kebab-case
description: 详细描述技能做什么，以及在什么情况下使用它。
---

描述（description）必须包含：
- What：它做什么（功能）。
- When：在何时使用（触发短语），如“创建 sprint 时”或“上传 .fig 文件时”。

三、内容编写原则

—

如何写

文档与资产创建（Category 1）‍：
- 例如：frontend-designSkill。
- 作用：生成统一风格的文档、代码或设计稿，确保输出符合品牌规范。
- 关键点：通常不需要外部工具，主要依赖 Claude 的生成能力。
工作流自动化（Category 2）‍：
- 例如：skill-creatorSkill。
- 作用：指导用户完成多步骤流程，如项目立项、代码审查。
- 关键点：强调步骤的顺序和验证。
MCP 增强（Category 3）‍：
- 例如：sentry-code-reviewSkill。
- 作用：在使用 MCP（工具接入）时，提供特定领域的专业知识。
- 关键点：将多个 MCP 调用串联起来，并加入领域特定的判断逻辑。

—

测试与迭代

在发布 Skill 前，必须经过严格的测试流程：

触发测试（Trigger Tests）‍：
- 目标：确保 Skill 能在需要时加载（触发），而在不需要时不加载。
- 方法：测试“明显请求”、“变形请求”（paraphrased）和“无关请求”。
功能测试（Functional Tests）‍：
- 目标：验证 Skill 的输出是否正确。
- 内容：检查 API 调用是否成功、错误处理是否有效、边缘情况是否覆盖。
对比测试（Performance Comparison）‍：
- 目标：证明 Skill 的优势。
- 方法：对比使用 Skill 前后的 token 消耗、对话轮数和成功率。