《CLAUDE.md 与内容型知识库项目协作实战手册》介绍

这本小册解决什么问题

你正在用 Claude Code 做一个内容型项目——可能是技术文档站、知识库、FAQ 系统、Markdown 驱动的内容网站，或者任何以"内容文件"为核心资产的项目。

你每天都在和 Claude 协作写代码、改内容、调结构。

但你大概率遇到过这些问题：

每次新会话都要从头交代项目背景。 Claude 不记得你的技术栈、目录结构、命名规范。你每次都在重复同样的话，浪费大量时间。

Claude 经常"好心办坏事"。 你让它改一篇文章的分类，它改了——但没意识到分类聚合页、搜索索引、导航结构全部受影响。你让它优化一个 slug，它改了——旧 URL 全部 404，搜索引擎已收录的链接全部失效。

内容结构越改越乱。 Claude 随手新增 frontmatter 字段、发明新的标签写法、用不同的分类名称表达同一个意思。三个月后你发现，内容文件里的字段五花八门，聚合页缺内容，搜索索引残缺不全。

你知道应该写 CLAUDE.md，但不知道该写什么。 写少了没效果，写多了 Claude 反而开始忽略。你不确定哪些规则该放主文件，哪些该拆出去，怎么让 Claude 真正遵守。

这些问题的根源是同一个：

你缺的不是一个 CLAUDE.md 文件，而是一套完整的 AI 协作规则体系。

这本小册，就是帮你把这套体系从零搭建起来。

这本小册讲什么

一句话总结：

教你为内容型知识库项目设计一套"CLAUDE.md + 专项文档 + 验证机制 + 自动化"的完整协作规则体系，让 Claude 从"临时聊天助手"变成"稳定可控的项目协作者"。

它不只是教你"怎么写一个 CLAUDE.md"。

它教你从项目认知、结构设计、内容规范、数据治理、验证策略到自动化升级，完整地搭建一套让 Claude 在内容项目中"少犯错、更稳定、可维护"的规则系统。

为什么专门讲"内容型知识库项目"

市面上讲 CLAUDE.md 的文章不少，但几乎全是面向通用代码项目的。

而内容型知识库项目有一个特殊的难点：

一篇 Markdown 文件看起来只是文本，但它实际上同时是详情页的数据源、列表页的条目、搜索索引的输入、分类聚合的单元、路由系统的映射、SEO 的元数据来源。

Claude 改一个字段，可能同时影响 5 个系统环节。但它默认不会意识到这些连锁关系。

这就是为什么内容型项目比普通代码项目更需要精心设计的协作规则——也是为什么通用的 CLAUDE.md 教程在内容项目里效果不好。

这本小册，是目前市面上唯一专门为"内容型知识库项目"定制的 CLAUDE.md 实战手册。

这本小册适合谁

适合你，如果你是：

• 正在用 Claude Code 开发内容站、知识库、文档站、FAQ 系统的开发者
• 用 Markdown / MDX 驱动内容，有 frontmatter、分类、标签、搜索的项目维护者
• 已经在用 CLAUDE.md 但效果不理想，想系统提升的人
• 想从"每次都靠临时对话控制 Claude"升级到"规则预设 + 自动执行"的人
• 对 Claude Code 的 hooks、subagents 感兴趣，想知道怎么和 CLAUDE.md 配合的人

不太适合你，如果你是：

• 从没用过 Claude Code（建议先熟悉基本操作再来）
• 项目和内容完全无关，是纯代码/纯 API 项目（本册的规范设计偏内容场景）
• 只想要一个万能 CLAUDE.md 模板复制粘贴（本册教的是设计方法，不只是模板）

你会得到什么

📘 6 篇深度正文 + 1 篇导读 + 1 篇附录

不是零散的技巧合集，而是一条从认知到落地到升级的完整学习路径。

📦 14 份可直接使用的实战模板

这是这本小册最硬核的交付物——不是空泛的方法论，而是拿到项目里就能改的成品模板：

✅ CLAUDE.md 最小可用版模板
✅ CLAUDE.md 进阶增强版模板
✅ docs/content-rules.md 内容规范模板
✅ docs/data-schema.md 数据结构模板
✅ docs/build-process.md 构建流程模板
✅ docs/testing.md 验证策略模板
✅ docs/code-conventions.md 代码约定模板
✅ docs/deployment.md 发布流程模板
✅ 内容变更后检查清单
✅ 结构变更后检查清单
✅ 发布前/发布后检查清单
✅ 信息筛选决策流程（判断规则该不该写进 CLAUDE.md）
✅ hooks 配置示例
✅ 维护节奏建议清单

每份模板都专门为内容型知识库项目定制，不是通用模板硬套。

🧭 每篇附带的学习工具

• 核心认知回顾：帮你快速复习关键结论
• 检查清单：学完自测，确认是否掌握
• 实战练习：用你自己的项目做一次，把知识转化为行动

这本小册和免费文章有什么区别

网上关于 CLAUDE.md 的免费内容不少。但大多数文章有三个共同问题：

第一，只讲"怎么写一个文件"，不讲"怎么设计一套体系"。

CLAUDE.md 本身只是入口。如果你只有一个文件，那它要么太简单没效果，要么太臃肿被忽略。真正有效的是 CLAUDE.md + docs/ + 检查清单 + hooks 的完整组合。这本小册从头到尾讲的就是这套组合怎么设计。

第二，面向通用场景，对内容型项目没有针对性。

通用教程会教你写技术栈、目录结构、命令。但不会教你：frontmatter 字段怎么设计才稳定、slug 改动影响哪些环节、分类体系怎么防止被 Claude 搞乱、构建链路怎么验证。这些是内容型项目独有的难题，需要专门的解决方案。

第三，只有概念没有模板，看完还是不知道该写什么。

这本小册给你 14 份完整模板。不是空架子，而是填好了字段、写好了规则、标注了原因的成品。你拿到项目里，改掉项目名和目录名，就能开始用。

小册目录

导读    这本小册解决什么问题，以及你该怎么读

第 1 篇  重新理解 CLAUDE.md
         ——它不是文档，而是项目协作的配置中枢

第 2 篇  从零搭建
         ——一份内容型知识库项目的 CLAUDE.md 实战编写

第 3 篇  规则分层
         ——用 docs/ 文档体系实现渐进披露

第 4 篇  内容即数据
         ——frontmatter 规范、数据结构与构建链路的工程化设计

第 5 篇  让 Claude 少犯错
         ——验证机制、测试策略与发布检查清单

第 6 篇  从文件到系统
         ——CLAUDE.md 与 hooks、subagents 的协作升级

附录    全套模板汇总 + 一周落地计划 + 常见问题

阅读这本小册之后

一周后： 你的项目有了一份精准的 CLAUDE.md 和 3 份核心文档，Claude 开始"懂你的项目"。

两周后： 你的内容规范和数据结构都有了明确的规则文档，Claude 不再乱加字段、乱改 slug、乱用分类名。

一个月后： 你的验证清单和工作流已经跑顺，每次内容改动后你知道该检查什么。hooks 开始接管机械检查，你把精力放在真正重要的事情上。

三个月后： 你不再把 Claude 当"聊天工具"，而是当"项目协作者"。你的协作规则体系在持续迭代，越来越贴合真实工作流。新加入项目的人（或新启动的 Claude 会话）都能通过这套规则快速进入状态。

开始阅读

如果你正在用 Claude Code 做内容型项目，并且希望让 Claude 更稳定、更可控、更少犯错——

翻到下一页，我们从第 1 篇开始。