14.1 Skills基本概念

什么是 Skills#

Skills（Skills）是 Claude Code 中的一种开放标准，用于扩展 AI 代理的能力。通过将指令、脚本和资源组织到文件夹中，Skills 允许 AI 代理动态发现和使用专业知识来更好地完成任务。

Skills 的核心是一个简单的文件夹结构，包含一个必需的 SKILL.md 文件。这个文件使用 YAML 前置元数据和 Markdown 指令来定义 Skill 的功能和使用方式。

Skills 的工作原理#

渐进式披露#

Skills 使用渐进式披露机制来高效管理上下文：

1. 发现阶段：启动时仅加载每个 Skill 的名称和描述，用于判断何时可能相关
2. 激活阶段：当任务匹配时，读取完整的 SKILL.md 指令
3. 执行阶段：根据需要加载引用的文件或执行脚本

这种机制确保 AI 代理保持高效，同时在需要时访问更多上下文。

基本结构#

每个 Skill 都是一个文件夹，至少包含 SKILL.md 文件：

bash
复制
skill-name/
└── SKILL.md          # 必需：指令和元数据

可选地可以包含：

bash
复制
skill-name/
├── SKILL.md          # 必需
├── scripts/          # 可选：可执行代码
├── references/       # 可选：附加文档
└── assets/           # 可选：模板和资源

SKILL.md 文件格式#

YAML 前置元数据#

SKILL.md 文件以 YAML 前置元数据开头：

yaml
复制
---
name: skill-name
description: Brief description of what this skill does and when to use it
---

必需字段：

• name：Skill 的唯一标识符（1-64字符，小写字母、数字和连字符）
• description：Skill 的功能描述和使用时机（1-1024字符）

可选字段：

• license：许可证信息
• compatibility：环境要求
• metadata：额外的元数据
• allowed-tools：允许使用的工具列表

Markdown 指令主体#

前置元数据后是 Markdown 格式的指令，包含：

• 详细的使用说明
• 步骤指导
• 示例
• 最佳实践

Skills 的优势#

1. 知识封装#

Skills 将专业知识打包成可重用的组件：

• 组织专家经验
• 标准化工作流程
• 促进团队知识共享

2. 高效上下文管理#

通过渐进式披露优化性能：

• 减少初始上下文占用
• 按需加载详细信息
• 支持大规模知识库

3. 灵活扩展#

Skills 支持多种扩展方式：

• 引用外部文档和脚本
• 集成可执行代码
• 支持模板和资源文件

4. 标准化格式#

作为开放标准，Skills 具有：

• 跨平台兼容性
• 易于版本控制
• 便于分享和协作

Skills 与其他功能的区别#

Skills vs. MCP（Model Context Protocol）#

• Skills：知识和工作流的封装机制，专注于AI代理能力的扩展和专业知识的组织
• MCP：通信协议标准，用于AI模型与外部工具、数据源和服务之间的标准化交互

Skills vs. 插件#

• Skills：基于自然语言和示例的灵活封装
• 插件：需要编程实现的系统集成

Skills vs. 传统脚本#

• Skills：包含上下文和指导的智能封装
• 传统脚本：纯粹的代码执行

Skills 的应用价值#

Skills 通过封装专业知识和自动化复杂任务，为开发者提供：

• 提高效率：减少重复工作，加速开发流程
• 质量保证：内置最佳实践和质量检查
• 知识传承：保存和分享团队专业知识
• 快速上手：降低新成员的学习曲线

总结#

Skills 是 Claude Code 中一个简单而强大的概念，通过标准化的文件夹结构和渐进式披露机制，实现了专业知识的高效封装和使用。理解这些基本概念是掌握 Skills 功能的基础，在后续章节中我们将探讨更深入的实现细节和实际应用。