《Claude Code 从入门到精通》番外1：Skills 是什么？为什么它比 CLAUDE.md 更强大

本文是《Claude Code 从入门到精通》番外篇第1篇 阅读时长：约20分钟 · 难度：★★★☆☆ 前置知识：建议先学完正篇第08课（CLAUDE.md） 学完之后：你会理解 Skills 的三级架构和触发机制，知道什么时候该用 CLAUDE.md、什么时候该用 Skills

你以为 CLAUDE.md 就是终点？

《Claude Code 从入门到精通》试读篇：Claude Code 是什么？你可能从第一步就用错了

《Claude Code 从入门到精通》试读篇：你的第一次 Director Mode 体验（二）

《Claude Code 从入门到精通》试读篇：写好 Prompt 的结构化思维，10组正反对比，看完直接套用（三）

《Claude Code 从入门到精通》试读篇：当 Claude 理解错了怎么办（四）

《Claude Code 从入门到精通》目标优于指令，Director Mode 第一支柱（五）

第06课：让 Claude 自己分配任务——并行 Agent 策略

《Claude Code 从入门到精通》第07课：结果验证——你最不能省的一步

第08课：CLAUDE.md，让 Claude 永远记住你的规矩

第09课：10个高频场景 Prompt 模板库，复制、改几个词、直接用

第10课：Agent 体系，认识你的 AI 团队成员

第11课：Multi-Agent 实战，并行编排的5种模式

第12课：MCP 与 Hooks——给 Claude Code 装上插件和自动化引擎

第13课：日常开发工作流，从晨会到代码提交

第14课：团队协作中的 Claude Code

第15课：3 个真实可用的 GitHub Actions，让 Claude 每天帮你自动做代码审查和安全扫描

第16课：用了 Claude Code，怎么证明你变快了

第17课：Claude Code实战案例一，从零开发一个完整 API 模块

第18课：实战案例二，线上紧急 Bug 修复全过程

《Claude Code 从入门到精通》完结篇：实战案例三，老项目系统性重构

第08课你学了 CLAUDE.md——写一份项目规范，Claude 每次自动读取，不用重复说规矩。效果很好，prompt 短了一半，代码质量稳了一截。

但你有没有遇到过这些情况？

情况1：CLAUDE.md 越写越长，Claude 越来越慢。

你的 CLAUDE.md 从最初的200行长到了600行——代码规范、错误处理、数据库约定、测试要求、安全红线、禁止事项……全都塞在里面。每次 Claude 启动都要加载这600行，不管你这次的任务用不用得到。

写个简单的工具函数？Claude 也要先读完你那段600行的"项目宪法"。

情况2：不同任务需要完全不同的"专家知识"。

你让 Claude 写 API 接口，它需要知道你的 RESTful 规范、DTO 校验方式、错误码体系。你让 Claude 做前端组件，它需要知道你的 UI 组件库、样式方案、状态管理约定。你让 Claude 生成文档，它需要知道你的文档格式、术语表、模板。

这三类任务需要的"专家知识"完全不同，但 CLAUDE.md 是一锅端——不管你做什么，所有知识全部加载。

情况3：你有一套完整的工作流，不只是规范。

比如你每次做代码审查都是固定的5步：跑 lint → 检查类型 → 审查业务逻辑 → 安全扫描 → 生成审查报告。这个工作流不只是"规范"（应该怎么做），还包括"脚本"（用什么工具做）和"模板"（报告长什么样）。

CLAUDE.md 只能放文字指令，放不了脚本和模板。你的工作流被拆成了好几块——指令在 CLAUDE.md 里，脚本在 scripts/ 目录下，模板在某个不知道哪里的 .md 文件里。Claude 不知道它们是一套的。

这些问题，CLAUDE.md 解决不了。Skills 可以。

Skills 到底是什么

2025年10月，Anthropic 正式发布了 Skills 系统。

用一句话定义：Skills 是可以按需加载的、模块化的专家知识包。

如果说 CLAUDE.md 是你给 Claude 写的"入职手册"——一入职就全部读完。那 Skills 就是"操作手册库"——有十几本，Claude 根据当前任务自己去拿需要的那本，用完放回去。

CLAUDE.md 的工作方式：
┌─────────────────────────────────────┐
│          每次对话开始                 │
│                                     │
│  Claude 加载 → 全部 600 行规范       │
│                                     │
│  不管你问什么，都背着全部知识        │
│  写工具函数也好，做安全审查也好      │
│  600 行全在上下文里                  │
└─────────────────────────────────────┘

Skills 的工作方式：
┌─────────────────────────────────────┐
│          每次对话开始                 │
│                                     │
│  Claude 加载 → 只有每个 Skill 的     │
│                名称和简介（各1-2行） │
│                                     │
│  你说"写 API 接口"                  │
│  → Claude 识别匹配 → 加载 api-dev   │
│    Skill 的完整指令（50行）          │
│                                     │
│  你说"做安全审查"                   │
│  → Claude 识别匹配 → 加载 security  │
│    Skill 的完整指令（80行）          │
│                                     │
│  按需加载，用什么拿什么              │
└─────────────────────────────────────┘

关键区别：CLAUDE.md 是"全量加载"，Skills 是"按需加载"。

当你的项目规范很少的时候（100-200行），两者差别不大。但当你的知识库越来越大——编码规范、API 设计、文档生成、测试策略、安全审查、部署流程……加在一起可能上千行——Skills 的按需加载优势就非常明显了。

一个 Skill 的内部结构

每个 Skill 是一个文件夹，核心是一个 SKILL.md 文件，外加可选的脚本、参考资料和模板：

my-skill/