CLAUDE.md 确实非常好用。只需编写一份项目规范文档，Claude 便会自动读取，无需反复重申规则。这样一来，提示词缩短了一半，代码质量也显著提升了一个档次。

不过，在持续使用过程中，一些令人困扰的问题逐渐浮现出来。

痛点一：CLAUDE.md 文档不断膨胀，导致 Claude 处理速度逐渐变慢。

起初只有 200 行，不知不觉竟膨胀到 600 行——涵盖了代码规范、错误处理、数据库约定、测试要求、安全红线、禁止事项……恨不得把所有规则全部塞进去。结果呢？即便你只是编写一个简单的工具函数，Claude 也必须先通读整部“项目宪法”。

痛点二：不同任务需要完全不同的“专家知识”体系。

当让 Claude 编写 API 接口时，它需要掌握你的 RESTful 风格、DTO 校验方式以及错误码体系；当让它开发前端组件时，它必须熟悉你的 UI 组件库、样式方案和状态管理约定；当要求它生成文档时，它又需要了解文档格式、术语表和模板。

这三类任务所需的知识图谱几乎完全不重叠，然而 CLAUDE.md 却是“一锅端”——无论你执行什么任务，所有知识都会被一股脑儿全部加载进来。

痛点三：工作流程是立体多维的，远不止文字规范那么简单。

很多任务背后都有一套完整的工作流程。例如进行代码审查，通常遵循固定的五个步骤：执行 lint → 类型检查 → 业务逻辑审查 → 安全扫描 → 最后生成审查报告。

这个流程中既包含“规范”（应该怎么做），也包含“脚本”（用什么工具实现），还包含“模板”（报告的结构与样式）。然而，CLAUDE.md 只能存放文字指令，无法容纳脚本和模板。最终导致指令留在 CLAUDE.md 中，脚本散落在 scripts/ 目录下，模板则不知藏在哪个 .md 文件里，Claude 很难将它们作为一个整体来理解。

这些问题，单靠 CLAUDE.md 确实无法解决。不过，另一项功能可以完美应对——Skills。

Skills 到底是什么

2025 年 10 月，Anthropic 正式推出了 Skills 系统。

用一句话概述：Skills 是一种可按需加载的模块化专家知识包。

如果把 CLAUDE.md 比喻成你给 Claude 准备的“入职手册”——入职第一天就必须从头读到尾；那么 Skills 则更像是一个“操作手册库”，里面分类摆放着十几本手册。Claude 会根据当前任务，自行从书架上取出需要的那一本，用完后再放回去。

两者的关键区别在于：CLAUDE.md 采用“全量加载”，而 Skills 采用“按需加载”。

当项目规范内容很少（例如 100-200 行）时，两者差别不大。然而，当你的知识库不断膨胀——包括编码规范、API 设计、文档生成、测试策略、安全审查、部署流程……累计轻松超过上千行——Skills 这种按需加载的模式，其优势就变得十分显著了。

一个 Skill 的“骨架”

每个 Skill 就是一个文件夹，其核心文件是 SKILL.md，此外还包含一些可选的脚本、参考资料和模板：

my-skill/
├── SKILL.md          <-- 核心：这个 Skill 的完整说明
├── scripts/          <-- 可选：运行脚本（shell、Python等）
├── references/       <-- 可选：参考资料（论文、文档、代码片段）
└── templates/        <-- 可选：输出模板（报告、代码生成等）

这样一来，你的“知识资产”就不再是一篇杂乱冗长的文档，而是变成了一个个清晰、独立、可复用的模块。Claude 也能明确知道在什么场景下该使用哪个模块，什么情况下不该使用。