11 KiB
Claude Skills 完整说明文档
本文档整理自 Anthropic 官方文档，涵盖 Skills 的概念、使用方法、创建指南和技术架构。
目录
一、什么是 Skills
概述
Skills 是指令、脚本和资源的文件夹集合，Claude 可以动态加载这些内容以提升在特定任务上的表现。无论是品牌文档创建、数据分析还是工作流自动化，Skills 都能帮助 Claude 持续高效地完成特定任务。
工作原理
Skills 通过**渐进式披露（Progressive Disclosure）**机制运作：
- Claude 识别哪些 Skills 与当前任务相关
- 动态加载必要的信息
- 避免上下文窗口过载
- 在任务请求时，Claude 审查可用选项，加载相关内容并应用其指导
Skills 的类型
| 类型 | 说明 |
|---|---|
| Anthropic Skills | 由 Anthropic 维护的预构建功能，用于增强文档创建（Excel、Word、PowerPoint、PDF）。当适用时自动激活。 |
| Custom Skills（自定义 Skills） | 用户或组织为特定工作流创建的工具，例如应用品牌指南、生成模板通信、结构化会议笔记或自动化个人流程。 |
| Organization Provisioned Skills | 适用于 Team 和 Enterprise 计划，管理员可以在整个组织范围内分发经批准的 Skills，确保团队间的标准化流程。 |
| Partner Skills | 来自 Notion、Figma、Atlassian 等公司的专业实现，设计用于与 MCP 连接器集成。 |
核心优势
- ✅ 提升特定任务的表现
- ✅ 保存组织知识
- ✅ 通过 Markdown 轻松自定义（基础 Skills 无需编码）
- ✅ 企业用户可集中管理团队
与其他功能的比较
| 对比项 | 区别 |
|---|---|
| Skills vs Projects | Skills 动态激活；Projects 提供静态知识 |
| Skills vs MCP | Skills 教授流程；MCP 提供工具访问 |
| Skills vs Custom Instructions | Skills 针对特定任务；Custom Instructions 广泛适用 |
二、如何使用 Skills
可用性
Skills 功能目前以预览形式提供给：
- Pro、Max、Team 和 Enterprise 用户
- Claude Code 和启用代码执行的 API 用户（Beta）
前提条件
| 用户类型 | 要求 |
|---|---|
| Enterprise | 管理员必须在管理设置中启用代码执行和 Skills |
| Team | 功能默认启用；用户可单独切换 Skills |
| Pro/Max | 用户直接在 Settings > Capabilities 中管理 Skills |
启用 Skills
- 导航至 Settings > Capabilities
- 确认已启用代码执行
- 开启/关闭所需的 Skills
- 将自定义 Skills 作为 ZIP 文件上传
内置 Anthropic Skills
Claude 在相关时会自动使用以下工具：
- Excel - 电子表格创建和操作
- Word - 文档生成
- PowerPoint - 演示文稿制作
- PDF - PDF 创建和处理
无需显式调用——Claude 根据请求自动判断使用。
自定义 Skills
- 用户可以创建和上传个人 Skills
- 这些 Skills 保持私有
- Team/Enterprise 计划的组织所有者可以在组织范围内配置
Skills 目录
访问 claude.com/connectors 可找到来自 Notion、Figma、Atlassian 等平台的专业构建 Skills，可下载并本地安装。
安全考虑
主要风险：
- 提示注入（Prompt Injection）
- 数据泄露（Data Exfiltration）
建议：
- 在安装之前彻底审计来自不受信任来源的 Skills
- Skills 在沙盒环境中运行
- 会话之间不保留数据
常见问题排查
| 问题 | 解决方案 |
|---|---|
| Skills 不工作 | 检查代码执行是否已禁用 |
| Skills 未被调用 | 描述可能不够清晰 |
| ZIP 上传错误 | 检查大小限制、缺少 Skill.md 文件、文件夹名称不匹配 |
三、如何创建自定义 Skills
有效 Skills 的关键特征
最佳的 Skills 应该：
- ✅ 解决特定、可重复的任务
- ✅ 包含 Claude 可以遵循的清晰指令
- ✅ 在有益时包含示例
- ✅ 定义使用场景
- ✅ 专注于单个工作流
核心结构：Skill.md 文件
每个 Skill 都需要一个包含 YAML 前置信息的 Skill.md 文件：
---
name: "我的自定义 Skill" # 必需：人性化标识符（最多64个字符）
description: "这个 Skill 做什么" # 必需：清晰的功能说明（最多200个字符）
dependencies: # 可选：所需的软件包
- pandas
- numpy
---
# Skill 的主要内容和指令
元数据作为初始披露层，帮助 Claude 在不加载完整内容的情况下确定适当的使用场景。
附加组件
资源文件（Resources）
补充文件（如 REFERENCE.md）可以扩展 Skill.md 以提供场景特定信息。
脚本（Scripts）
高级 Skills 支持可执行代码：
- Python：支持 pandas、numpy、matplotlib
- JavaScript/Node.js：用于增强功能
打包要求
正确的 ZIP 结构要求 Skill 文件夹作为根目录：
✅ 正确: my-Skill.zip → my-Skill/ → Skill.md
❌ 错误: 文件直接在 ZIP 根目录
测试与部署
上传前检查
- 验证指令清晰度
- 确保描述准确
- 确认文件位置正确
- 使用示例提示测试
上传后验证
- 在 Settings > Capabilities 中启用
- 测试多个提示
- 审查 Claude 的推理过程
- 如需要，迭代优化描述
最佳实践
| 实践 | 说明 |
|---|---|
| 专注单一功能 | 创建专注、独立的 Skills，而非单一庞大的解决方案 |
| 具体的描述 | 编写具体描述以指导调用 |
| 从简单开始 | 先用 Markdown，再添加复杂代码 |
| 包含示例 | 提供输入/输出示例 |
| 增量测试 | 逐步测试功能 |
| 可组合性 | Skills 可自动组合，无需显式交叉引用 |
安全注意事项
- ⚠️ 谨慎使用可执行脚本
- ⚠️ 避免硬编码敏感凭据
- ⚠️ 在启用前审查下载的 Skills
- ⚠️ 对外部服务使用适当的 MCP 连接
四、Agent Skills 技术架构
来源：Anthropic 工程博客（2025年10月16日发布）
概述
Agent Skills 是一个用于构建专业 AI 代理的框架，使用模块化、可组合的能力。该系统使 Claude 能够通过有组织的文件和资源处理复杂的领域特定任务。
核心概念
Agent Skills 是"有组织的指令、脚本和资源文件夹，代理可以动态发现和加载以更好地执行特定任务"。开发者无需为每个用例创建单独的自定义代理，而是可以通过将专业知识打包成可重用组件来扩展 Claude 的能力。
架构：渐进式披露
设计遵循三级披露模式：
┌─────────────────────────────────────────────────────────┐
│ 第1级：元数据级别 │
│ - SKILL.md 文件的 YAML 前置信息 │
│ - 包含 name 和 description 字段 │
│ - 预加载到系统提示中 │
├─────────────────────────────────────────────────────────┤
│ 第2级：核心内容 │
│ - SKILL.md 的主体部分 │
│ - 包含详细指令 │
│ - 当 Skill 变得相关时，Claude 访问此内容 │
├─────────────────────────────────────────────────────────┤
│ 第3级：补充文件 │
│ - 额外资源如 reference.md 或 forms.md │
│ - 仅在需要时链接和加载 │
│ - 保持上下文精简，同时支持无限复杂性 │
└─────────────────────────────────────────────────────────┘
这种方法允许具有文件系统访问权限的代理在只需要特定部分时避免加载整个 Skill 定义。
上下文窗口集成
当触发时，Skill 修改上下文窗口序列：
- 核心系统提示 + Skill 元数据初始加载
- Claude 调用 bash 工具读取相关 Skill 文件
- 代理选择性导航到特定资源部分
- 任务使用上下文中的目标信息继续进行
代码执行能力
Skills 可以捆绑 Claude 确定性运行的可执行脚本（Python 等）。对于数据提取或排序等操作，这比基于令牌的计算更高效。
开发指南
| 指南 | 说明 |
|---|---|
| 从评估开始 | 在代表性任务上测试代理以识别差距，然后逐步构建 Skills 来解决不足 |
| 为规模化结构设计 | 将笨重的文件拆分为单独的组件；将相互排斥的上下文分开以减少令牌使用 |
| 与 Claude 迭代 | 让 Claude 自我反思成功的方法和失败，将模式捕获到可重用的上下文和代码中 |
| 安全第一 | 仅从可信来源安装 Skills；彻底审计捆绑的代码、依赖项和外部网络连接 |
当前支持
Agent Skills 在以下平台受支持：
- Claude.ai
- Claude Code
- Claude Agent SDK
- Claude Developer Platform
文档和教程可通过 Anthropic 官方渠道获取。
附录：快速参考
Skill.md 模板
---
name: "Skill 名称"
description: "简短描述此 Skill 的功能和使用场景"
dependencies:
- package1
- package2
---
# Skill 名称
## 概述
描述这个 Skill 做什么。
## 使用场景
- 场景1
- 场景2
## 指令
详细的执行指令...
## 示例
### 输入
用户请求示例...
### 输出
期望的响应示例...
文件夹结构
my-skill/
├── Skill.md # 必需：主要指令文件
├── reference.md # 可选：参考资料
├── templates/ # 可选：模板文件
│ └── template1.md
└── scripts/ # 可选：可执行脚本
└── process.py
文档整理日期：2025年12月19日 来源：Anthropic 官方文档