2.7 Claude Code Skills：让 AI 自动按你的套路办事

你有没有发现，用 Claude Code 做项目的时候，每次都要重复说同样的话？

「记得先 build 检查错误…」 「部署到 Vercel 前先配置环境变量…」 「多语言要加 hreflang 标签…」

说着说着你会发现——你在重复当 Claude 的「产品经理」。

每次都要手把手教它怎么部署、怎么检查 SEO、怎么配置多语言。最烦的是，Claude 有时候会「发挥创意」，跳过某个关键步骤，导致部署失败。

Skills 就是来解决这个问题的。

Skills 是什么？

直接说：给 Claude 配置「专业技能包」。

你把工作流程、脚本、最佳实践打包成一个文件夹，Claude 需要的时候会自动调用。不用你每次重复说明。

技术原理（看不懂可跳过）

Skills 用「渐进式披露」设计，分三层加载：

好处：你可以在 Skill 里塞很多东西，但不会占用 Claude 的上下文窗口。需要什么才加载什么。

第一步：理解 Skill 的结构（3分钟）

一个 Skill 就是一个文件夹，里面至少有一个 SKILL.md 文件。

my-skill/
├── SKILL.md          # 核心指令文件（必须）
├── scripts/          # 脚本（可选）
│   └── deploy.sh
└── docs/             # 参考文档（可选）
    └── checklist.md

SKILL.md 长什么样？

---
name: 部署到 Vercel
description: 自动化 GitHub 仓库创建和 Vercel 部署。当用户说「部署」「上线」「发布」时触发。
---
 
## 部署工作流
 
- [ ] Step 1: 运行 build 检查错误
- [ ] Step 2: 创建 GitHub 仓库
- [ ] Step 3: 推送代码到 GitHub
- [ ] Step 4: 部署到 Vercel
- [ ] Step 5: 验证部署成功
 
**Step 1: 运行 build**
执行: `npm run build`
**如果 build 失败**: 检查错误，修复后重新运行。
**只有 build 成功才能继续下一步。**

第二步：安装你的第一个 Skill（5分钟）

最快的上手方式：下载现成的 Skill。

mkdir -p ~/.claude/skills

cd ~/.claude/skills
git clone https://github.com/anthropics/skills.git anthropic-skills

~/.claude/skills/
└── anthropic-skills/
    ├── deploying-to-production/
    ├── webapp-testing/
    ├── skill-creator/
    └── ... (更多 Skills)

/skills

第三步：使用 Skill（2分钟）

安装好后，使用超级简单。

方式1：自动触发

直接说你想做什么，Claude 会自动判断用哪个 Skill：

帮我部署这个网站到 Vercel

Claude 看到「部署」「Vercel」这些关键词，会自动调用「部署到生产环境」Skill。

方式2：手动调用

用 /skill 命令 + Skill 名字：

/skill deploying-to-production 帮我部署当前项目

使用效果对比

第四步：创建你自己的 Skill（10分钟）

用一段时间后，你会发现自己有固定的工作流程。把它做成 Skill，以后就不用重复说了。

例子：我的「博客发布」Skill

我每次发布博客都要做这些事：

1. 检查 frontmatter 格式
2. 确认 pubDatetime 是过去的时间
3. 检查图片引用
4. 运行 build
5. 提交 Git

以前每次都要说一遍，现在做成 Skill：

步骤 1：创建 Skill 文件夹

mkdir -p ~/.claude/skills/blog-publishing

步骤 2：创建 SKILL.md 文件

touch ~/.claude/skills/blog-publishing/SKILL.md

步骤 3：写入内容

用编辑器打开 SKILL.md，写入以下内容（注意：开头的 name 和 description 部分用三个短横线包裹）：

name: 博客发布工作流
description: 发布 Astro 博客文章的完整流程。当用户说「发布博客」「发文章」「blog publish」时触发。

## 博客发布检查清单

- 检查 frontmatter 格式是否正确
- 确认 pubDatetime 是过去的时间（不能是未来）
- 检查所有图片引用是否存在
- 运行 pnpm run build 确保无错误
- 生成 Git commit 并推送

## 详细步骤

Step 1: Frontmatter 检查
必须包含：title, pubDatetime, description, tags

Step 2: 时间检查
pubDatetime 必须小于等于当前时间，否则文章不会显示

Step 3: 图片检查
遍历文章中所有图片引用，确认文件存在于 public/images/

Step 4: Build 检查
运行 pnpm run build
如果失败，分析错误并修复

Step 5: Git 提交
git add .
git commit -m "blog: 发布新文章"
git push

步骤 4：测试你的 Skill

打开 Claude Code，输入 /skills，应该能看到「博客发布工作流」。

然后试试：帮我发布这篇博客文章

创建 Skill 的 3 个关键经验

1. 描述要精准

description 字段很重要，Claude 靠它判断什么时候触发 Skill。

关键是包含：触发关键词 + 具体场景

# ❌ 不好的描述
description: 部署网站
 
# ✅ 好的描述
description: 自动化 GitHub 仓库创建和 Vercel 部署。当用户说「部署」「上线」「发布」「deploy」「vercel」时触发。

2. 指令要简洁

Claude 已经很聪明了，不要写太多废话。假设它已经懂基础知识，只写它不知道的。

# ❌ 啰嗦
Step 1: 首先，你需要打开终端，然后输入 npm run build 命令，
这个命令会编译你的代码，检查是否有语法错误...
 
# ✅ 简洁
Step 1: 运行 `npm run build`
如果失败：检查错误信息，修复后重试

3. 加入反馈循环

复杂流程要加「验证-修复-重试」机制：

## Step 1: Build 检查
 
执行: `npm run build`
 
**如果成功**: 继续下一步
**如果失败**:
1. 分析错误信息
2. 定位问题文件
3. 修复问题
4. 重新执行 build
5. 重复直到成功

推荐的 Skills

官方 Skills

Anthropic 提供了 12 个开箱即用的 Skills：

# 一键安装官方 Skills
cd ~/.claude/skills
git clone https://github.com/anthropics/skills.git anthropic-skills

社区 Skills

更多高质量的 Skills，可以去 AgentSkills.best  探索。

这个网站收录了：

• Anthropic 官方的 12 个 Skills
• 社区贡献的优质 Skills
• 每个 Skill 都有详细使用说明和下载链接
• 支持搜索和分类筛选

无论你是想快速上手，还是寻找特定领域的工作流，都可以在这里找到。

常见问题

Q1: Skill 和 CLAUDE.md 有什么区别？

简单理解：

• CLAUDE.md：「这个项目要怎么做」
• Skill：「这类事情要怎么做」

Q2: Skill 会占用上下文窗口吗？

不会。Skills 使用渐进式加载：

• 平时只加载名字和描述（约100 token）
• 触发时才加载完整指令
• 脚本和文档按需读取

Q3: 怎么让 Claude 优先使用某个 Skill？

在对话开头明确说：

使用 deploying-to-production skill，帮我部署这个项目

或者用命令：

/skill deploying-to-production

Q4: 我的 Skill 不触发怎么办？

检查 description 字段：

1. 是否包含你常用的触发词
2. 关键词是否太少或太模糊

例如，如果你常说「上线」，但 description 只写了「deploy」，就不会触发。

总结

Skills 的核心价值：从「每次重复写 prompt」变成「配置一次，长期使用」。

用好 Skills：

1. ✅ 先用官方和社区的 Skills 上手
2. ✅ 发现自己的固定流程后，做成 Skill
3. ✅ description 要精准，包含触发关键词
4. ✅ 指令要简洁，加入反馈循环

下一节：常见问题与最佳实践 - 解决使用中的各种疑难杂症