Column 1
Column 2
核心理念：Skills 是"知识载体"，教 Claude 如何做；MCP 是"连接器"，让 Claude 能访问外部系统。两者互补，非竞争关系。
一、Skills 是什么？
1.1 定义与本质
Agent Skills 是包含指令、脚本和资源的文件夹，Claude 在需要时动态加载以执行特定任务。
类比理解：Skills 类似于给新员工准备的 SOP 手册 —— 将你的专业知识打包成 Claude 能理解和应用的格式。
1.2 Skills 的核心特性
特性 | 说明 |
可移植性 | 同一 Skill 在 Claude Code、Claude.ai、API 中通用 |
渐进式加载 | 只加载必要内容，节省上下文窗口 |
可组合性 | 多个 Skills 可协同工作 |
可分享 | 纯文件夹结构，易于版本控制和分发 |
可执行 | 支持嵌入脚本，执行确定性操作 |
1.3 渐进式披露机制
二、Claude Code 扩展机制全景对比
2.1 六大扩展机制速览
类比理解：把 Claude Code 想象成一个新员工
- Skills = SOP 手册（教他怎么做）
- Slash Commands = 快捷指令（你喊一声他就执行）
- MCP = 门禁卡（让他能进入各种系统）
- Subagent = 分身术（派分身并行干活）
- CLAUDE.md = 入职须知（项目的基本规则）
- Hooks = 自动触发器（某事发生时自动执行脚本）
2.2 核心差异对比表
维度 | Skills | Slash Commands | MCP | Subagent |
本质 | 程序性知识（如何做） | 预定义提示词（快捷触发） | 连接协议（访问什么） | 并行工作者（谁来做） |
触发方式 | Claude 自动匹配 | 用户显式输入 /命令 | Claude 按需调用 | Claude 委派或显式调用 |
文件结构 | 目录 + SKILL.md + 资源 | 单个 .md 文件 | 服务器配置 JSON | AGENT.md 配置 |
适用场景 | 复杂工作流、多文件知识 | 常用提示词、快速操作 | 数据库、API、工具集成 | 并行任务、上下文隔离 |
Token 消耗 | 低（渐进加载） | 低（按需加载） | 高（数千-数万） | 中（独立上下文） |
复杂度 | 中（目录结构） | 低（单文件） | 高（服务器/协议） | 中（配置文件） |
可移植性 | 跨平台通用 | 仅 Claude Code | 跨 AI 模型通用 | 仅 Claude Code |
支持脚本 | ✅ 可嵌入脚本 | ✅ 可执行 Bash | ❌ 服务器端处理 | ❌ 配置定义 |
2.3 Skills vs Slash Commands 深度对比
核心区别：Skills 是 Claude 自动发现并应用的能力；Slash Commands 是你显式调用的快捷指令。
对比维度 | Skills | Slash Commands |
发现机制 | 基于任务上下文自动匹配 | 必须输入 /command 触发 |
结构复杂度 | 目录 + 多文件 + 脚本 | 单个 .md 文件 |
典型用途 | 复杂工作流、团队规范 | 常用提示片段、快速操作 |
示例 | PDF 处理（含验证脚本） | /review → "审查这段代码" |
同一功能的两种实现对比：
Slash Command 版本（简单直接）
使用：
/review（手动触发）Skill 版本（功能完整）
使用："帮我审查这段代码"（自动发现）
选择建议：
- 用 Slash Commands：重复使用的简单提示词、需要显式控制执行时机
- 用 Skills：需要多文件支持、包含验证脚本、团队标准化流程
2.4 架构关系图
2.5 协同工作示例
实战场景：构建智能 PR 审查系统
- MCP：连接 GitHub 获取 PR 数据
- Skills：编码你的代码审查标准和流程
- Slash Command：
/pr-review 123快速触发审查
- Subagent：一个审查代码质量，一个检查安全漏洞
2.6 选择决策树
三、Skills 目录结构与存储位置
3.1 Skill 文件结构
3.2 存储位置与优先级
位置 | 路径 | 适用范围 | 优先级 |
企业级 | 由管理员配置 | 组织所有用户 | 最高 |
个人级 | ~/.claude/skills/ | 你的所有项目 | 高 |
项目级 | .claude/skills/ | 当前仓库协作者 | 中 |
插件级 | 随插件安装 | 安装插件的用户 | 低 |
优先级规则：同名 Skill 时，高优先级覆盖低优先级。企业 > 个人 > 项目 > 插件。
四、如何创建和使用 Skills
4.1 创建第一个 Skill
步骤 1：创建目录
步骤 2：编写 SKILL.md
步骤 3：验证加载
4.2 SKILL.md 元数据字段
字段 | 必需 | 说明 |
name | ✅ | 小写字母+数字+连字符，最多 64 字符 |
description | ✅ | 说明功能和触发时机，最多 1024 字符 |
allowed-tools | ❌ | 限制可用工具，如 Read, Grep, Glob |
model | ❌ | 指定使用的模型版本 |
4.3 使用渐进式披露
最佳实践：SKILL.md 保持在 500 行以内。详细内容拆分到独立文件，按需引用。
五、10 个实用 Skills 示例
示例 1：代码解释器 Skill
示例 2：PR 审查 Skill
示例 3：嵌入式 Linux 驱动分析 Skill
示例 4：API 文档生成 Skill
示例 5：SQL 查询优化 Skill
示例 6：Git 工作流 Skill
示例 7：Docker 镜像优化 Skill
示例 8：安全审计 Skill
示例 9：技术文档翻译 Skill
示例 10：RTOS 任务设计 Skill
六、最佳实践
6.1 编写高质量 SKILL.md
实践 | 说明 |
描述精准 | 包含触发关键词，如"当用户请求 X 时使用" |
职责单一 | 一个 Skill 做好一件事 |
结构清晰 | 使用 Markdown 标题分层 |
示例丰富 | 提供输入输出示例 |
保持简洁 | 主文件 < 500 行 |
6.2 工具限制策略
6.3 脚本最佳实践
安全提醒：Skills 可执行代码。只安装来自可信来源的 Skills，安装前审查脚本内容。
6.4 Skill 与 Subagent 协作
七、注意事项与常见问题
7.1 Skill 不触发？
检查描述字段：
- ❌ 模糊："帮助处理文档"
- ✅ 精确："从 PDF 提取文本和表格，填写表单。当用户提到 PDF、表单、文档提取时使用。"
7.2 Skill 未加载？
检查路径和语法：
- 文件必须命名为
SKILL.md（区分大小写）
- YAML 必须以
---开头（第一行，无空行）
- 使用空格缩进，非 Tab
7.3 多个 Skill 冲突？
让描述更具体，使用不同的触发词：
- Skill A："销售 Excel 和 CRM 导出数据分析"
- Skill B："日志文件和系统指标分析"
7.4 插件 Skill 不显示？
八、参考资料
官方文档
代码仓库
博客与教程
- Introducing Agent Skills - Anthropic 官方公告
- Skills for Organizations - 企业级管理
- Agent Skills 开放标准 - 跨平台可移植性规范
