第 1 课：认识 Skills：为什么需要自定义工作流

学习目标：

• 理解 Skills 解决的核心问题
• 识别适合用 Skill 自动化的工作场景
• 了解 Skills 的基本工作原理

前置要求：使用过 Claude Code 的基本功能 | 下一课 第 2 课 >>

你每次都在重复解释同一个流程

你正在用 Claude Code 整理会议记录。你说："帮我把这段会议录音转成结构化的要点，分成决策、行动项和待讨论三部分，每个行动项要标注负责人和截止日期。"

Claude 完成了。效果很好。

第二天，另一个会议。你又说了一遍同样的话。

第三天，第四天……每次开会后，你都在重复同样的指令。Claude 每次都能做好，但你每次都得重新解释。¹

这就是 Skills 要解决的问题：把你反复解释的工作流程，打包成一个可复用的指令。一次编写，随时调用。²

什么是 Skill

Skill 是一个目录，里面有一个 SKILL.md 文件，告诉 Claude 如何完成某个特定任务。³

它像是给 Claude 准备的作业指导书。你把步骤写清楚，Claude 看着做。不需要每次都从头解释。⁴

举个例子，会议记录整理 Skill 的核心内容可能是：

保存后，你只需要输入 /meeting-notes 加上会议内容，Claude 就知道该怎么做。¹

Skills 适合什么场景

适合 Skills 的场景有三个特征：

1. 重复性：你每周、每天、甚至每小时都在做同样的事
2. 步骤固定：流程可以写成清晰的步骤，不是每次都不一样
3. 可以验证：你能判断 Claude 做得对不对

典型场景：

• 代码审查（检查是否遵循团队规范）
• 文档格式转换（Markdown 转 Word，保留特定格式）
• 日志分析（从错误日志中提取关键信息）
• 测试用例生成（根据功能描述生成测试场景）
• 提交信息规范化（将简略的 commit 改写成团队约定的格式）

不适合 Skills 的场景：

• 一次性任务（比如"帮我设计这个页面的布局"）
• 每次都需要很多人工判断的任务
• 完全开放式的创意工作

Skills 如何工作

当你创建一个 Skill，你实际上是在做两件事：⁵

1. 写一个 YAML frontmatter（文件开头用 --- 包裹的部分），告诉 Claude「这个 Skill 叫什么名字、什么时候用它」
2. 写 Markdown 指令（frontmatter 后面的正文），告诉 Claude「拿到任务后具体怎么做」

两种使用方式：

• 手动调用：你输入 /meeting-notes，Claude 加载这个 Skill 的指令，然后执行
• 自动触发：你说"帮我整理这段会议记录"，Claude 看 description 觉得 meeting-notes 这个 Skill 相关，就自动加载它⁶

自动触发的前提是 description 写得好。这个我们第 2 课详细讲。

Skill 存在哪里

两个位置：¹

• Personal skills：~/.claude/skills/ - 你自己用的，所有项目都能访问
• Project skills：.claude/skills/ - 放在项目目录里，团队成员克隆代码后也能用

第一次创建 Skill，从 personal skills 开始。等你写了几个、确认有用了，再考虑把常用的放进项目目录，让团队一起用。

小结

• Skills 把重复的工作流打包成可复用的指令，避免每次都重新解释
• 适合 Skill 的场景：重复性、步骤固定、可验证
• Skill 是一个目录 + 一个 SKILL.md 文件，包含 YAML frontmatter 和 Markdown 指令
• 两种用法：手动调用（/skill-name）或自动触发（Claude 根据 description 判断）
• 两个位置：personal skills（~/.claude/skills/）和 project skills（.claude/skills/）

下一课，我们拆开一个真实的 SKILL.md 文件，看看里面每个部分是干什么的。

>> 第 2 课：Skill 的解剖