跳到主要内容

Skills（技能包）

什么是 Skills​

Skills 是 Claude Code 中预先封装好的工作流模块。每个 Skill 包含一组特定领域的提示词、工具调用逻辑和最佳实践，用完即走，不会持续占用上下文窗口。

核心特性

Skills 的设计理念是"按需加载"：只在需要时注入到对话中，任务完成后自动卸载，不产生长期的上下文负担。

Skills 与普通提示词的区别在于：

特性普通提示词Skills
上下文占用持续占用用完释放
可复用性低高
标准化程度无有版本管理
分发方式手动复制npm/本地安装
维护成本高低

官方 Skills 库​

官方 Skills 托管在 GitHub：https://github.com/anthropics/skills

常用官方 Skills​

Skill 名称用途适用场景
frontend-design前端 UI 设计与实现React/Vue 组件开发
doc-coauthoring文档协作撰写技术文档、API 文档
canvas-design画布交互设计图形编辑器、白板应用
pdfPDF 生成与处理报告生成、文档导出
algorithmic-art算法艺术生成可视化、创意编程

安装官方 Skills​

使用 npx skills-installer 安装官方 Skills：

# 安装前端设计 Skill
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code

# 安装文档协作 Skill
npx skills-installer install @anthropics/claude-code/doc-coauthoring --client claude-code

# 安装画布设计 Skill
npx skills-installer install @anthropics/claude-code/canvas-design --client claude-code

# 安装 PDF 处理 Skill
npx skills-installer install @anthropics/claude-code/pdf --client claude-code

# 安装算法艺术 Skill
npx skills-installer install @anthropics/claude-code/algorithmic-art --client claude-code

安装完成后，Skills 会保存到 ~/.claude/skills/ 目录。

查看已安装的 Skills​

在 Claude Code 中运行：

/skills

这会列出所有已安装的 Skills 及其描述。

自定义 Skill 创建​

你可以创建自己的 Skill 来封装团队特有的工作流。

目录结构​

my-skill/
├── skill.json        # Skill 元数据配置
├── skill.md          # Skill 核心提示词和说明
├── api/              # API 接口定义（可选）
│   └── endpoints.md
└── tools/            # 自定义工具定义（可选）
    └── custom-tool.js

skill.json 示例​

{
  "name": "my-custom-skill",
  "description": "团队代码审查与优化工作流",
  "version": "1.0.0",
  "author": "Your Name <you@example.com>",
  "categories": [
    "code-review",
    "optimization",
    "best-practices"
  ],
  "license": "MIT",
  "skill": {
    "file": "skill.md",
    "description": "执行标准化的代码审查流程，包括性能分析、安全检查和代码风格验证"
  }
}

skill.md 示例​

# 代码审查专家

## 职责
你是一位经验丰富的代码审查专家，负责对提交的代码进行全面审查。

## 审查流程

### 第一步：代码质量
- 检查命名规范是否符合团队标准
- 验证函数/方法的单一职责原则
- 确认没有重复代码（DRY 原则）

### 第二步：安全审查
- 检查 SQL 注入风险
- 验证输入数据的合法性
- 确认敏感信息没有硬编码

### 第三步：性能分析
- 识别潜在的 N+1 查询问题
- 检查不必要的循环嵌套
- 评估内存使用是否合理

## 输出格式
以 Markdown 格式输出审查报告，包含：
- 总体评分（1-10）
- 问题列表（按严重程度排序）
- 改进建议
- 优点总结

安装自定义 Skill​

方法一：直接复制​

# 将自定义 Skill 复制到 Claude Code 的 Skills 目录
cp -r my-skill ~/.claude/skills/

方法二：通过安装器​

# 从本地路径安装
npx skills-installer install ./my-skill --client claude-code

# 从 GitHub 仓库安装（需要仓库包含 skill.json）
npx skills-installer install github:your-org/your-skill --client claude-code
最佳实践

将团队共用的 Skills 托管在私有 Git 仓库中，通过 npx skills-installer 统一安装，确保团队成员使用一致的工作流版本。

使用 Skills​

安装后，在 Claude Code 对话中直接调用：

/skills my-custom-skill

或者在对话中自然地描述需求，Claude Code 会自动匹配合适的 Skill：

请帮我用代码审查 Skill 审查这个文件...
注意事项

Skills 在使用期间会占用上下文空间，但任务完成后会自动释放。如果对话中同时使用多个 Skills，可能会增加上下文压力，建议按需逐一使用。

Skills 生命周期​

调用 Skill → 注入提示词到上下文 → 执行工作流 → 任务完成 → 上下文释放

Skills 的无状态设计使其非常适合以下场景：

  • 一次性分析任务：代码审查、文档生成
  • 批量处理：多文件格式化、批量翻译
  • 专业领域工作：需要特定领域知识的任务

🎯 实战案例：提高工作效率​

案例 1：代码审查自动化​

场景： 团队代码库有 200+ 个文件，代码风格不统一，需要大规模审查和重构。

传统方式： 2-3 周人工审查 + 修复

使用 Claude Code + Skills：

# 创建团队代码审查 Skill
npx skills-installer install ./my-custom-skill --client claude-code

# 执行自动审查
/review-all-files

# Claude Code 会自动：
# ✅ 遍历所有文件
# ✅ 按照 Skill 标准检查
# ✅ 生成审查报告
# ✅ 提出改进建议

效果对比：

指标传统方式Claude Code
审查时间2-3 周2-3 小时
覆盖率70%100%
一致性中等高度统一
成本3-4 人周1-2 小时

效率提升： 50-100 倍

案例 2：测试用例自动生成​

场景： 新增 50 个 API 端点，需要为每个端点编写完整的单元测试。

传统方式： 每个 API 10-20 分钟手写测试，共需 8-16 小时

使用 Claude Code + Skills：

# 使用测试生成 Skill
/generate-tests --coverage=100%

# Claude Code 会：
# ✅ 分析 API 签名
# ✅ 生成正常案例、边界案例、异常案例
# ✅ 添加 mock 数据
# ✅ 生成完整的测试套件

实际执行：

输入：50 个 API 定义（OpenAPI spec）
处理时间：15-20 分钟
输出：500+ 完整测试用例
覆盖率：95%+

效率提升： 30-50 倍

案例 3：文档自动化​

场景： 项目有 30 个模块，需要生成 API 文档、使用说明、变更日志。

传统方式： 手工编写 + 维护，耗时 3-5 天，容易过时

使用 Claude Code + doc-coauthoring Skill：

# 安装官方 doc-coauthoring Skill
npx skills-installer install @anthropics/claude-code/doc-coauthoring --client claude-code

# 执行自动文档生成
/generate-documentation

# Claude Code 会：
# ✅ 分析代码结构
# ✅ 提取 JSDoc / Docstring
# ✅ 生成 API 参考文档
# ✅ 创建快速开始指南
# ✅ 自动更新变更日志

效果：

  • API 文档：自动从代码注释生成，与代码同步更新
  • 使用说明：自动示例代码生成
  • 变更日志：从 Git commit 自动整理

效率提升： 10-20 倍，且保持文档始终最新

案例 4：批量代码迁移​

场景： 从 Webpack 4 升级到 Webpack 5，需要更新 50 个项目配置、依赖、兼容代码。

传统方式： 逐个手工升级，2-3 周时间，容易遗漏

使用 Claude Code + 自定义 Skill：

# 创建升级 Skill
npx skills-installer install ./webpack5-upgrade-skill --client claude-code

# 执行批量升级
/batch-migrate-to-webpack5

# Claude Code 会自动处理：
# ✅ 更新所有 package.json
# ✅ 修改配置文件语法
# ✅ 适配不兼容的 API
# ✅ 运行测试确保可用性
# ✅ 生成升级报告

执行结果：

升级 50 个项目配置
更新 200+ 文件
自动修复 95% 兼容性问题
生成详细升级报告
总耗时：3-4 小时（vs 2-3 周）

效率提升： 50-100 倍

案例 5：性能优化分析​

场景： 大型应用性能下降，需要找出瓶颈、生成优化方案。

传统方式： 人工使用各种工具分析，1-2 天

使用 Claude Code + Performance Skill：

# 执行性能分析 Skill
/analyze-performance --generate-fixes

# Claude Code 会：
# ✅ 扫描所有代码文件
# ✅ 识别常见的性能问题
# ✅ 生成优化建议
# ✅ 提供修复代码示例
# ✅ 估算性能提升幅度

生成的报告：

  • 性能问题列表（按优先级）
  • 每个问题的详细说明
  • 修复代码示例
  • 预期性能提升
  • 测试验证方案

时间对比：

工作传统方式Claude Code
问题识别4-6 小时15 分钟
方案制定4-6 小时20 分钟
代码修复8-12 小时1-2 小时
合计16-24 小时2-3 小时

效率提升： 8-12 倍

🚀 快速创建你的第一个 Skill​

为团队创建代码审查 Skill​

步骤 1：创建目录结构

mkdir my-code-review-skill
cd my-code-review-skill

步骤 2：创建 skill.json

{
  "name": "code-review",
  "version": "1.0.0",
  "description": "团队标准代码审查工作流",
  "skill": {
    "file": "skill.md",
    "description": "执行代码质量审查、安全检查和性能分析"
  }
}

步骤 3：创建 skill.md

# 代码审查工作流

## 你的职责
作为代码审查专家，按照以下流程审查代码：

### 代码质量检查
- [ ] 命名规范符合 camelCase / PascalCase
- [ ] 函数长度 &lt;50 行
- [ ] 注释清晰
- [ ] 无重复代码

### 安全检查
- [ ] 没有 SQL 注入风险
- [ ] 输入数据已验证
- [ ] 敏感信息没有硬编码

### 性能检查
- [ ] 没有 N+1 问题
- [ ] 循环嵌套合理
- [ ] 内存使用正常

## 输出格式
生成 Markdown 审查报告，包含：
1. 总体评分（1-10）
2. 关键问题（按严重程度）
3. 改进建议
4. 优点总结

步骤 4：安装和使用

# 安装 Skill
npx skills-installer install ./my-code-review-skill --client claude-code

# 使用 Skill
claude
> /code-review

💡 最佳实践​

  1. Keep it focused — 每个 Skill 解决一个明确的问题
  2. Clear documentation — 说明 Skill 的输入、处理逻辑、输出
  3. Team sharing — 将团队 Skills 托管在 Git，统一版本管理
  4. Version control — 在 skill.json 中明确版本号，跟踪演变
  5. Reusability — 设计 Skill 时考虑多个项目的通用性