Claude Skills 完全指南
什么是 Claude Skills
Claude Skills 是模块化的能力包，包含指令、脚本和资源，让 Claude 在需要时自动加载和使用。
核心价值
- 模块化：每个 Skill 做一件事，独立封装
- 自动加载：Claude 根据任务描述自动判断需要哪个 Skill
- 重复指令打包：减少重复输入，降低 Token 消耗
- 渐进式披露：按需加载，避免 Token 爆炸
渐进式披露设计
Claude 使用聪明的三层加载机制，避免一次性加载所有内容：
第一层：元数据（Metadata）
- 总是加载
- 内容：SKILL.md 文件开头的 YAML 部分，仅包含
name和description - Token 成本：每个 Skill 约 100 tokens
- 作用：让 Claude 知道有哪些 Skills 可用
第二层：指令（Instructions）
- 触发时加载
- 内容：SKILL.md 的主体部分，详细操作指南
- Token 成本：通常 3000-5000 tokens
- 作用：告诉 Claude 具体怎么做
第三层：资源（Resources）
- 引用时加载
- 内容：scripts/、references/、assets/ 目录下的文件
- Token 成本：几乎无限（脚本执行后只有输出进入上下文）
- 作用：提供确定性执行能力和详细参考资料
Skills 结构
目录结构
.trae/skills/<skill-name>/
├── SKILL.md # 核心指令文件（必需）
├── scripts/ # 可执行脚本（可选）
├── references/ # 参考文档（可选）
└── assets/ # 模板和资源（可选）
SKILL.md 格式
---
name: "<skill-name>"
description: "<功能描述 + 触发条件，200字符内>"
---
# <Skill Title>
<详细的使用说明、最佳实践和示例>
如何创建 Skills
创建步骤
-
定义 Skill 名称和用途
- 明确 Skill 要解决的问题
- 确定触发条件
-
创建目录结构
mkdir -p .trae/skills/<skill-name>/ -
编写 SKILL.md 文件
- 包含 YAML 元数据
- 详细的使用说明
- 示例代码
- 最佳实践
-
添加可选资源
scripts/：可执行脚本references/：参考文档assets/：模板文件
示例：创建一个代码审查 Skill
---
name: "code-reviewer"
description: "Reviews code for best practices, bugs, and improvements. Invoke when user asks for code review or before merging changes."
---
# Code Reviewer
This skill reviews code and provides feedback on:
1. **Best Practices**
2. **Potential Bugs**
3. **Performance Issues**
4. **Readability**
5. **Security Vulnerabilities**
## Usage
Please review this code:
```python
def calculate(a, b):
return a + b
Review Criteria
- Use meaningful variable names
- Add docstrings for functions
- Handle edge cases
- Follow language-specific conventions
- Avoid code duplication
## 如何使用 Skills
### 自动使用
Claude 会根据任务描述自动识别并加载合适的 Skill：
帮我审校这篇文章
Claude 会自动识别需要审校能力，加载对应的审校 Skill。
### 手动触发
也可以在提示中明确指定要使用的 Skill：
使用 "code-reviewer" Skill 帮我审查这段代码：
```python
def calculate(a, b):
return a + b
最佳实践
命名规范
- 使用小写字母和连字符（如
code-reviewer） - 名称要直观，反映功能
- 避免使用特殊字符
描述编写
- 包含 功能 和 触发条件
- 保持在 200 字符以内
- 使用清晰、简洁的语言
内容组织
- 结构清晰，使用标题和列表
- 包含使用示例
- 提供最佳实践
- 明确使用场景
资源管理
- 脚本要简洁、高效
- 参考文档要相关、有用
- 模板要通用、可扩展
使用场景
1. 重复任务自动化
场景：频繁需要执行相同的指令 解决方案：创建一个 Skill 封装这些指令 示例：
- 代码格式化检查
- 文档生成
- 测试执行
2. 专业领域知识封装
场景：需要使用专业领域知识 解决方案：创建包含专业知识的 Skill 示例：
- 法律文档审查
- 医学术语解释
- 财务报表分析
3. 团队协作标准化
场景：团队需要统一的工作流程 解决方案：创建标准化的团队 Skill 示例：
- 代码审查标准
- 文档格式规范
- 项目管理流程
4. 复杂指令简化
场景：指令太复杂，难以记忆 解决方案：创建包含复杂指令的 Skill 示例：
- 复杂查询语句
- 高级配置命令
- 多步骤工作流程
常见问题
Q1: 如何确保 Skills 被正确触发？
A：确保 SKILL.md 中的 description 字段包含清晰的触发条件，描述清楚什么时候应该使用这个 Skill。
Q2: Skills 会影响 Claude 的响应速度吗？
A：不会。由于采用了渐进式披露设计，Claude 只会在需要时加载相关内容，不会影响启动速度。
Q3: 可以创建多少个 Skills？
A：理论上没有限制，但建议保持在合理数量（如 50 个以内），以便 Claude 更好地管理。
Q4: Skills 之间可以相互调用吗？
A：目前不支持直接调用，但可以在一个 Skill 中引用另一个 Skill 的内容。
Q5: 如何分享 Skills？
A：可以将 Skill 目录复制到其他项目中，或者通过版本控制系统共享。
未来发展
- Skills 商店：集中管理和分享 Skills
- 动态 Skills：根据上下文动态生成 Skills
- 多模态 Skills：支持图片、音频等多种格式
- 社区驱动：用户可以贡献和评分 Skills
总结
Claude Skills 是一种强大的工具，可以帮助你：
- 提高效率：减少重复工作
- 降低成本：减少 Token 消耗
- 标准化流程：统一团队工作方式
- 扩展能力：封装专业知识
通过合理设计和使用 Skills，你可以充分发挥 Claude 的潜力，提高工作效率和质量。
参考资料：
