2.5 本章小结

🎯 本章核心知识点回顾

1. Skills 的本质定位

一句话理解：

Skills 是 Claude Code 的"专业工具箱"，教 Claude 如何做事，而 MCP 提供做事的工具。

核心特性：

可组合 (Composable)：多个 Skills 自动协作
可移植 (Portable)：跨项目、跨团队共享
高效 (Efficient)：3 级加载机制，按需加载
强大 (Powerful)：结合知识、模板、脚本、工具

2. Skills vs MCP 核心区别

维度	Skills	MCP
定位	任务流程 + 知识库	工具和数据源
内容	SKILL.md 文档 + 脚本 + 模板	服务器 + API 接口
触发	description 自动匹配	Claude 主动调用工具
隔离	无（共享上下文）	有（进程隔离）
适用	业务流程、最佳实践	外部系统集成

最佳实践：

Skills: 定义"怎么用 MCP 工具"
MCP: 提供具体的工具能力

示例组合：

Skill: brand-guidelines (品牌规范工作流)
  ├─ 使用 MCP: filesystem (读取 Logo)
  ├─ 使用 MCP: image-processing (调整尺寸)
  └─ 使用 Tool: Edit (应用到文档)

3. SKILL.md 文件结构

完整格式：

yaml

---
name: skill-name              # 必需：唯一标识符
description: ...              # 必需：触发描述（100-200 字符）
allowed-tools:                # 可选：工具权限控制
  - Read
  - Grep
  - Bash
---

# Skill 标题

## Quick Guide
核心使用说明（10-20 行）

## Detailed Documentation
详细文档或引用外部文件

## Examples
使用示例

关键规则：

✅ description 决定触发成功率
✅ 主文件保持简洁（<50 行）
✅ 详细内容分层引用
✅ allowed-tools 限制权限

4. 三种存储位置

位置	路径	用途	优先级
Personal Skills	`~/.claude/skills/`	个人工具	最低
Project Skills	`<project>/.claude/skills/`	项目专用	中等
Plugin Skills	Plugin 安装路径	通用共享	最高

推荐策略：

个人工具 → Personal Skills
项目特定 → Project Skills（Git 管理）
团队共享 → Plugin Skills

5. 创建 Skill 的三步法

Step 1: 创建目录结构

bash

mkdir -p ~/.claude/skills/my-skill
cd ~/.claude/skills/my-skill

Step 2: 编写 SKILL.md

markdown

---
name: my-skill
description: Clear, trigger-friendly description
---

# My Skill

## Usage
...

Step 3: 验证触发

提问: "使用 my-skill 处理..."
检查: Claude 是否加载了该 Skill

6. 高级技巧总结

技巧 1：Skills 组合

多个 Skills 自动协作
Claude 根据 description 判断顺序
无需手动协调

技巧 2：分层设计

主 SKILL.md 保持简洁
详细内容分离到 core/, docs/, templates/
按需加载提高性能

技巧 3：条件逻辑

根据文件类型、用户输入等条件分支
在 SKILL.md 中明确说明

技巧 4：动态模板

使用 Jinja2 等模板引擎
数据驱动内容生成

技巧 5：缓存优化

避免重复计算
使用文件哈希作为缓存键

技巧 6：并行处理

批量任务使用 multiprocessing
显著提升性能

💡 常见问题 (FAQ)

Q1: Skill 和 MCP 应该选哪个？

答：根据需求选择：

需求	推荐方案
定义业务流程	Skills
集成外部 API	MCP
封装最佳实践	Skills
访问数据库	MCP
模板化报告	Skills
实时数据查询	MCP

最佳实践： Skills + MCP 组合使用

Q2: 如何提高 Skill 触发成功率？

答：优化 description：

yaml

# ❌ 触发率低
description: CSV tool

# ✅ 触发率高
description: Analyze CSV files and generate statistics. Use when user mentions CSV, data analysis, spreadsheet exploration, or wants to visualize tabular data.

关键点：

包含触发关键词
说明使用场景
100-200 字符长度
避免过于宽泛或狭窄

Q3: SKILL.md 太长了怎么办？

答：采用分层设计：

my-skill/
├── SKILL.md              # 简洁主文件（<50 行）
├── core/
│   ├── guide.md          # 详细指南
│   └── api.md            # API 文档
├── templates/            # 模板文件
└── scripts/              # 脚本文件

SKILL.md 精简版：

markdown

## Quick Start
1. 核心步骤说明
2. 常见用法示例

## Detailed Documentation
See `core/guide.md` for complete information

Q4: 如何调试 Skill 不生效？

答：三级调试法：

Level 1: 检查加载

bash

claude --debug
# 查看: [DEBUG] Loaded skill: my-skill

Level 2: 验证触发

测试: "使用 my-skill 处理..."
检查: Claude 是否提到该 Skill

Level 3: 脚本调试

bash

# 手动运行脚本
python scripts/analyze.py test.csv

# 添加日志
logger.debug(f"Processing: {file_path}")

Q5: Skills 可以调用其他 Skills 吗？

答：不能直接调用，但可以自动组合：

markdown

# Skill A: data-analyzer
description: Analyze data files

# Skill B: report-generator
description: Generate reports from analysis results

# Claude 自动组合：
用户: "分析 data.csv 并生成报告"
Claude:
  1. 加载 data-analyzer → 分析数据
  2. 加载 report-generator → 生成报告

关键： description 要明确边界，避免重叠

Q6: 如何在团队中共享 Skills？

答：推荐 Git + Project Skills：

bash

# 项目结构
your-project/
├── .claude/skills/      # Project Skills
├── .gitignore
└── README.md

# 团队成员
git clone ...
# Skills 自动可用！

# 更新 Skills
git pull

优点：

✅ 版本控制
✅ Code Review
✅ 自动同步

Q7: Skills 有安全风险吗？

答：有，但可控制：

风险：

脚本执行任意代码
访问敏感文件
网络请求

防护措施：

限制工具权限

yaml

allowed-tools:
  - Read    # 只读
  - Grep    # 搜索
# 禁止: Write, Edit, Bash

审计第三方 Skills

bash

# 检查脚本
grep -r "subprocess\|requests" scripts/
# 检查网络请求
cat SKILL.md | grep -E "http|curl"

沙盒测试

bash

# 在隔离环境测试
docker run ... claude skill invoke test-skill

Q8: 如何优化 Skill 性能？

答：三大优化策略：

1. 精简 SKILL.md

主文件 <50 行
详细内容外部引用

2. 缓存结果

python

cache_key = hashlib.md5(file_content).hexdigest()
if cache_exists(cache_key):
    return load_cache(cache_key)

3. 并行处理

python

from multiprocessing import Pool
results = pool.map(process_file, files)

📋 快速参考指南

Skill 创建清单

[ ] 确定 Skill 名称（小写、连字符）
[ ] 编写触发友好的 description
[ ] 创建目录结构
[ ] 编写 SKILL.md（<50 行）
[ ] 添加使用示例
[ ] 测试触发成功率
[ ] 添加错误处理
[ ] 文档化故障排查步骤
[ ] （可选）限制 allowed-tools
[ ] （可选）添加单元测试

Skill 质量自检表

检查项	标准	我的 Skill
description 长度	100-200 字符	⬜
SKILL.md 长度	<50 行（主文件）	⬜
触发测试	>90% 成功率	⬜
执行时间	<5 秒（简单任务）	⬜
错误处理	有明确错误提示	⬜
文档完整性	有示例 + 故障排查	⬜
安全性	限制了工具权限	⬜
可移植性	无硬编码路径	⬜

常用命令速查

bash

# 调试模式
claude --debug

# 列出所有 Skills
ls ~/.claude/skills/
ls .claude/skills/          # Project Skills

# 手动测试脚本
python scripts/script.py args

# 检查 YAML 格式
cat SKILL.md | head -n 10

# 搜索 Skills
grep -r "keyword" ~/.claude/skills/

🎓 学习路径建议

初学者路径（第 1-2 周）

Week 1: 基础概念

[ ] 理解 Skills vs MCP 区别
[ ] 学习 SKILL.md 格式
[ ] 创建第一个 Hello Skill
[ ] 掌握三种存储位置

Week 2: 实践应用

[ ] 创建 Markdown Report Skill（带模板）
[ ] 创建 CSV Analyzer Skill（带脚本）
[ ] 测试 description 触发
[ ] 学习基础调试

进阶路径（第 3-4 周）

Week 3: 高级技巧

[ ] 实践 Skills 组合
[ ] 采用分层设计
[ ] 添加条件逻辑
[ ] 优化性能（缓存、并行）

Week 4: 团队协作

[ ] Git + Project Skills
[ ] 代码审查流程
[ ] 创建团队 Plugin
[ ] 安全审计实践

专家路径（第 5+ 周）

深度优化

[ ] 性能基准测试
[ ] 高级错误恢复
[ ] 动态模板引擎集成
[ ] 企业级安全加固

生态贡献

[ ] 向 anthropics/skills 贡献
[ ] 创建开源 Skills
[ ] 分享最佳实践
[ ] 参与社区讨论

📚 推荐资源

官方资源

Claude Blog - Skills 介绍
- https://www.claude.com/blog/skills
- 为什么需要 Skills，核心理念
官方文档
- https://code.claude.com/docs/en/skills
- 完整技术文档和 API 参考
工程博客
- https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
- 技术深度解析
官方 Skills 仓库 ⭐⭐⭐
- https://github.com/anthropics/skills
- 最佳实践示例，强烈推荐

社区资源

Skills Gallery: 社区贡献的 Skills 集合
Discord/论坛: 问题讨论和经验分享
博客文章: 实战经验总结

🚀 下一步行动

立即实践（今天）

创建你的第一个 Skill
- 选择一个日常重复任务
- 用 10 分钟创建 Hello Skill
- 测试触发是否成功
加入官方示例
- 克隆 https://github.com/anthropics/skills
- 运行一个示例 Skill
- 理解其工作原理

本周目标

创建 3 个实用 Skills
- 1 个个人工具（Personal）
- 1 个项目工具（Project）
- 1 个团队工具（共享）
优化触发成功率
- 测试 10 次不同提问
- 达到 >90% 触发率

本月目标

建立团队 Skills 库
- Git + Project Skills 工作流
- 至少 5 个团队共享 Skills
- 代码审查流程
贡献开源社区
- 向官方仓库提交 PR
- 分享你的最佳实践

💬 结语

Skills 是 Claude Code 最强大的扩展机制之一，它让 Claude 从"通用助手"进化为"领域专家"。

核心价值：

✅ 封装最佳实践，避免重复劳动
✅ 知识共享，提升团队效率
✅ 模块化设计，灵活组合
✅ 持续优化，不断进化

记住：

好的 Skill 不是写出来的，是用出来的。

从今天开始，创建你的第一个 Skill，让 Claude 成为你的专属助手！

恭喜你完成 Module 2: Skills 核心概念！ 🎉

下一步： Module 3: MCP 深度解析（即将推出）

Claude Code Skills 教程 v1.0 | 2025 Edition | 基于官方文档和最佳实践

2.5 本章小结 ​

🎯 本章核心知识点回顾 ​

1. Skills 的本质定位 ​

2. Skills vs MCP 核心区别 ​

3. SKILL.md 文件结构 ​

4. 三种存储位置 ​

5. 创建 Skill 的三步法 ​

6. 高级技巧总结 ​

💡 常见问题 (FAQ) ​

Q1: Skill 和 MCP 应该选哪个？ ​

Q2: 如何提高 Skill 触发成功率？ ​

Q3: SKILL.md 太长了怎么办？ ​

Q4: 如何调试 Skill 不生效？ ​

Q5: Skills 可以调用其他 Skills 吗？ ​

Q6: 如何在团队中共享 Skills？ ​

Q7: Skills 有安全风险吗？ ​

Q8: 如何优化 Skill 性能？ ​

📋 快速参考指南 ​

Skill 创建清单 ​

Skill 质量自检表 ​

常用命令速查 ​

🎓 学习路径建议 ​

初学者路径（第 1-2 周） ​

进阶路径（第 3-4 周） ​

专家路径（第 5+ 周） ​

📚 推荐资源 ​

官方资源 ​

社区资源 ​

🚀 下一步行动 ​

立即实践（今天） ​

本周目标 ​

本月目标 ​

💬 结语 ​

2.5 本章小结

🎯 本章核心知识点回顾

1. Skills 的本质定位

2. Skills vs MCP 核心区别

3. SKILL.md 文件结构

4. 三种存储位置

5. 创建 Skill 的三步法

6. 高级技巧总结

💡 常见问题 (FAQ)

Q1: Skill 和 MCP 应该选哪个？

Q2: 如何提高 Skill 触发成功率？

Q3: SKILL.md 太长了怎么办？

Q4: 如何调试 Skill 不生效？

Q5: Skills 可以调用其他 Skills 吗？

Q6: 如何在团队中共享 Skills？

Q7: Skills 有安全风险吗？

Q8: 如何优化 Skill 性能？

📋 快速参考指南

Skill 创建清单

Skill 质量自检表

常用命令速查

🎓 学习路径建议

初学者路径（第 1-2 周）

进阶路径（第 3-4 周）

专家路径（第 5+ 周）

📚 推荐资源

官方资源

社区资源

🚀 下一步行动

立即实践（今天）

本周目标

本月目标

💬 结语