写给小白的 Claude Code 进阶指南:用 Skills 10 倍提升效率

cover

上一篇文章我们讲了 Claude Code 的基础用法,你已经能用它来写代码、调试 Bug、重构项目了。但如果只停留在这个层面,你只用到了 Claude Code 20% 的能力。

真正让 Claude Code 变成”超级助手”的,是 Skills。

我第一次用 Skills 是在处理一份 PDF 合同的时候。以前我会让 Claude 给我写一段 Python 脚本,然后自己去跑。有了 document-skills 之后,我直接说”提取这份合同的表单字段”,它就直接给结果了。省掉了写脚本、装依赖、调试的整个过程。

什么是 Skills?为什么它这么重要

Skills 就像是给 Claude 装上的”技能包”。

默认情况下,Claude 是一个通用的 AI 助手。它很聪明,但不够”专业”。比如你让它处理 PDF,它可能会给你一堆代码让你自己运行;你让它设计前端界面,它可能会给你一个千篇一律的紫色渐变页面。

但有了 Skills,情况完全不同。

PDF Skill 让 Claude 知道如何提取文本、合并文件、填写表单。前端设计 Skill 教会它你的设计哲学、品牌风格、交互规范。文档协作 Skill 让它能处理 Word、Excel、PPT,保留格式、追踪修订。

27.7 万次安装——这是截至 2026 年 3 月,官方前端设计 Skill 的安装量。这个数字说明了一件事:让 AI 生成的界面不再千篇一律,是一个真实的痛点。

Skills 的三大优势:

按需加载:Claude 只在需要时加载相关技能,不会占用你的上下文空间。

跨平台通用:一次创建,可以在 Claude Code、Claude.ai 和 API 中使用。

智能触发:Claude 会根据你的任务自动判断该用哪个 Skill,你甚至不需要手动指定。

如何安装和使用官方 Skills

让我们从最简单的开始:安装官方 Skills。

第一步:添加 Skills 市场

打开 Claude Code,输入:

1
/plugin marketplace add anthropics/skills

这会把 Anthropic 官方的 Skills 市场添加到你的 Claude Code 中。

第二步:浏览和安装 Skills

输入:

1
/plugin

选择 “Select marketplace”,你会看到所有可用的 Skills。

用方向键浏览,空格键选中你想安装的 Skills,最后按 i 键安装。

推荐新手先安装这几个:

  • document-skills:处理 PDF、Word、Excel、PPT
  • frontend-design:创建现代化的前端界面
  • doc-coauthoring:文档协作和编辑
  • algorithmic-art:生成算法艺术作品

安装完成后,你可以在 ~/.claude/skills 目录下看到这些 Skills。

第三步:使用 Skills

使用 Skills 有两种方式:

方式一:显式调用

1
用 PDF 技能提取 ./contract.pdf 中的表单字段
1
Use the frontend-design skill to create a dashboard component

方式二:让 Claude 自动识别

1
帮我分析这个 Excel 表格的销售数据

Claude 会自动识别你需要 Excel 处理能力,调用对应的 Skill。

这就是 Skills 的智能之处:你不需要记住每个 Skill 的名字,只需要描述你的需求。

创建你的第一个自定义 Skill

官方 Skills 很强大,但真正的威力在于自定义。

假设你经常需要解释代码,而且希望 Claude 用图表和类比的方式来解释。我们来创建一个 “explain-code” Skill。

第一步:创建 Skill 目录

1
mkdir -p ~/.claude/skills/explain-code

个人 Skills 放在 ~/.claude/skills/ 目录下,可以在所有项目中使用。

如果你想创建项目专属的 Skill,放在项目的 .claude/skills/ 目录下,可以通过 Git 与团队共享。

第二步:编写 SKILL.md 文件

~/.claude/skills/explain-code/ 目录下创建 SKILL.md 文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
---
name: explain-code
description: 用可视化图表和类比方式解释代码,适合初学者理解复杂逻辑
---

# 代码解释技能

当用户要求解释代码时,按以下方式进行:

## 解释步骤

1. **概述**:用一句话总结这段代码的作用
2. **可视化**:用 ASCII 图表或流程图展示代码逻辑
3. **类比**:用生活中的例子类比代码的工作方式
4. **逐行解释**:详细解释关键代码行
5. **潜在问题**:指出可能的 Bug 或改进点

## 示例

输入:解释这个排序函数

输出:
- 概述:这是一个冒泡排序,通过反复比较相邻元素来排序
- 可视化:[5,2,8,1] → [2,5,1,8] → [2,1,5,8] → [1,2,5,8]
- 类比:就像气泡上浮,大的数字逐渐"浮"到数组末尾
- 逐行解释:...
- 潜在问题:时间复杂度 O(n²),大数据集性能差

## 注意事项

- 避免使用过于技术化的术语
- 多用图表和示例
- 确保初学者能理解

第三步:使用你的 Skill

重启 Claude Code,然后试试:

1
用 explain-code 技能解释这个递归函数

Claude 会按照你定义的步骤来解释代码。

Skill 的高级用法

1. 控制 Skill 的触发方式

在 SKILL.md 的 frontmatter 中,你可以添加这些选项:

1
2
3
4
5
---
name: deploy
description: 部署应用到生产环境
disable-model-invocation: true
---

disable-model-invocation: true 表示只有你能手动调用这个 Skill,Claude 不会自动触发。

这对于有副作用的操作(比如部署、删除数据)特别重要。你不希望 Claude 因为误判就自动部署你的应用。

反过来,如果你想创建一个”背景知识” Skill:

1
2
3
4
5
---
name: legacy-system-context
description: 解释旧系统的架构和设计决策
user-invocable: false
---

user-invocable: false 表示只有 Claude 能使用,你不能手动调用。这适合用来存储项目的背景知识、编码规范等。

2. 在 Skill 中引用其他文件

如果你的 Skill 需要很多参考资料,可以把它们放在单独的文件中:

1
2
3
4
5
6
~/.claude/skills/api-guide/
├── SKILL.md
├── REFERENCE.md
└── examples/
├── auth.md
└── pagination.md

在 SKILL.md 中引用:

1
2
3
详细的 API 规范请参考 REFERENCE.md 文件。

认证示例见 examples/auth.md。

Claude 会在需要时读取这些文件。

3. 在 Skill 中包含可执行代码

对于复杂的任务,你可以在 Skill 中包含 Python 或 JavaScript 脚本:

1
2
3
~/.claude/skills/data-analysis/
├── SKILL.md
└── analyze.py

在 SKILL.md 中说明如何使用这个脚本,Claude 会在合适的时候运行它。

实战案例:创建一个 Git 提交规范 Skill

让我们创建一个实用的 Skill,帮助团队统一 Git 提交信息格式。

创建 ~/.claude/skills/git-commit-guide/SKILL.md

1
2
3
4
5
6
7
8
9
---
name: git-commit-guide
description: 生成符合团队规范的 Git 提交信息,包括类型、范围和描述
---

# Git 提交规范

## 提交信息格式

():

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

## 类型(type)

- feat: 新功能
- fix: Bug 修复
- docs: 文档更新
- style: 代码格式调整
- refactor: 重构
- test: 测试相关
- chore: 构建或辅助工具变动

## 范围(scope)

项目模块名,如:auth, api, ui, database

## 主题(subject)

- 用动词开头,如"添加"、"修复"、"更新"
- 不超过 50 个字符
- 结尾不加句号

## 示例

feat(auth): 添加 JWT Token 认证功能
  • 实现 Token 生成和验证
  • 添加 Token 刷新机制
  • 更新相关测试用例

Closes #123

1
2
3
4
5
6
7

## 使用方法

当用户要求创建提交信息时:
1. 询问改动的类型和范围
2. 根据规范生成提交信息
3. 确认后执行 git commit

现在,你只需要说:

1
帮我创建一个提交信息,我添加了用户注册功能

Claude 会按照你的规范生成标准的提交信息。

Skills 的最佳实践

1. 保持 Skill 专注

不要创建一个”万能 Skill”。每个 Skill 应该只做一件事,但把这件事做好。

好的例子:pdf-extract(只提取 PDF 内容)
不好的例子:document-handler(处理所有文档格式)

2. 写清楚 description

description 是 Claude 判断何时使用 Skill 的关键。要包含:

  • 这个 Skill 做什么
  • 什么时候使用
  • 相关的关键词

好的 description:

1
description: 提取 PDF 文件的文本、表格和表单字段。适用于合同分析、数据提取、表单处理等场景。关键词:PDF、提取、表单、合同

3. 提供具体示例

在 SKILL.md 中包含输入输出示例,让 Claude 理解”成功”是什么样子。

4. 定期更新

随着项目演进,你的 Skills 也需要更新。每个季度检查一次,删除过时的 Skills,更新不准确的内容。

5. 与团队共享

把项目级 Skills 放在 .claude/skills/ 目录下,提交到 Git。这样整个团队都能使用相同的规范和工作流。

写在最后

我现在的 ~/.claude/skills/ 目录里有七个 Skill,每一个都对应一个我以前要反复解释的场景。

最有用的是 git-commit-guide——不是因为它帮我写提交信息,而是因为它让团队里的人不再提交”fix bug”这种没有意义的信息。一个 Skill 文件,解决了一个持续了两年的团队问题。

Skills 的本质是把你的工作经验编码化。你踩过的坑、总结的规范、形成的习惯,都可以写进去,让 Claude 帮你执行。

我现在还没想清楚的一个问题是:Skills 越来越多之后,怎么管理?有没有人做过 Skills 的版本控制或者分类体系?这个问题我还没有好答案。