第一章 基础知识
Written By
Gona小译您忠实的翻译官
什么是 skill？
一个 skill 是一个包含以下内容的文件夹：
- SKILL.md（必需）：带有 YAML 前置元数据的 Markdown 指令
- scripts/（可选）：可执行代码（Python，Bash 等）
- references/（可选）：按需加载的文档
- assets/（可选）：输出中使用的模板，字体，图标
核心设计原则
渐进式披露
技能使用三级系统：
- 第一级（YAML 前置元数据）：始终加载在 Claude 的系统提示中。仅提供足够的信息，让 Claude 知道何时应该使用每个技能，而无需将所有内容加载到上下文中。
- 第二级（SKILL.md 主体）：当 Claude 认为该技能与当前任务相关时加载。包含完整的说明和指导。
- 第三级（链接文件）：技能目录中捆绑的额外文件，Claude 可以选择仅在需要时导航和发现。
这种渐进式披露最小化 token 使用量，同时保持专业知识。
可组合性
Claude 可以同时加载多个技能。你的技能应该能够与其他技能良好协作，而不是假设它是唯一可用的能力。
可移植性
技能在 Claude.ai、Claude Code 和 API 中的工作方式完全相同。创建一次技能，它就可以在所有平台上无需任何修改即可使用，前提是环境支持该技能所需的任何依赖项。
面向 MCP 构建者：技能 + 连接器
在没有 MCP 的情况下构建独立技能？跳过本节，直接查看规划和设计 - 你可以稍后再回到这里。
如果你已经有一个可运行的 MCP 服务器，你已经完成了最困难的部分。技能是其上的知识层 - 捕获你已经掌握的工作流和最佳实践，以便 Claude 可以一致地应用它们。
厨房类比
MCP 提供专业厨房：访问工具、食材和设备。
Skills 提供食谱：如何创造有价值成果的分步指南。
两者结合，使用户能够完成复杂任务，而无需自己摸索每个步骤。
它们如何协同工作：
| MCP (连接性) | Skills (知识) |
|---|---|
| 将 Claude 连接到你的服务 (Notion、Asana、Linear 等) | 教 Claude 如何有效使用你的服务 |
| 提供实时数据访问和工具调用 | 捕获工作流和最佳实践 |
| Claude 能做什么 | Claude 应该如何做 |
为什么这对你的 MCP 用户很重要
没有技能：
- 用户连接你的 MCP，但不知道接下来该做什么
- 支持工单询问"如何使用你的集成来做 X"
- 每次对话都从头开始
- 结果不一致，因为用户每次提示方式都不同
- 当真正的问题是工作流指导时，用户却责怪你的连接器
具备技能：
- 预构建的工作流在需要时自动激活
- 一致、可靠的工具使用
- 每次交互都嵌入最佳实践
- 降低集成的学习曲线