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 文件：

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

可选地可以包含：

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

SKILL.md 文件格式

YAML 前置元数据

SKILL.md 文件以 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	MCP
核心目的	封装专业知识和工作流	定义通信协议和接口
实现方式	文件夹结构 + YAML + Markdown	协议规范和API
关注重点	知识组织和任务自动化	工具集成和数据访问
适用范围	Claude Code生态系统	跨平台AI工具集成
灵活性	高度灵活的知识表达	标准化的工具调用

Skills vs. 插件

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

Skills vs. 传统脚本

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

Skills 的应用价值

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

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

总结

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