CLAUDE.md 分层架构：把 AI 当成每天失忆的助理，给它配一个工位
最近一堆技术大神在唱反调，说删掉你的 CLAUDE.md。他们只说了别塞，没说该塞到哪去。这篇拿我真正在用的视频工程，把 CLAUDE.md 拆成四样，一样一样拆给你看。
大神们其实在说同一件事
最近一堆技术大神在集体唱反调，刷屏的全部都是这种：删掉你的 CLAUDE.md 文件。有人说它在拖累 Claude Code，还有人说那个一键生成配置的斜杠 init 命令永远不要用，甚至还有研究发现，你自己手写、写精简一点，AI 干得更好；换成让 AI 自动生成一大堆塞得满满当当的，反而会帮倒忙，又慢又贵。他们其实都是在说同一个事情。
别把 CLAUDE.md 当成一个什么都往里塞的框，你塞的越多，AI 就越抓不住重点。但这些大神大多数都停在这里，只是告诉了你别塞、删掉、精简，没有人告诉你下一句：如果不放在这里，那么应该放到哪些地方。我的答案就是两个字，分家，也就是分门别类。可为什么非得分家，不能全部放在一张纸上？
一个每天失忆的助理，和它的工位
关键就在于 CLAUDE.md 这个文件。你就把 AI 想象成一个能力超强、但是每天上班就失忆的助理。你给他配一个工位，这个工位就是你的项目。你想让这个助理好好工作，那你的工位上面就得有这些东西，告诉他应该怎么去工作。首先第一个，桌上你得有一张便利贴。
这张便利贴就是 CLAUDE.md 文件，而大多数的问题恰恰就是栽在这里。本该单独放置的、本该交给机器的、本该做成工具的东西，全部都写在 CLAUDE.md 文件里面，反复地叮嘱，写完了一行又写一行。AI 在执行指令的时候，光是看这些内容就已经耗掉它一大半的注意力。这就是你的 CLAUDE.md 越写越不听话、你明明都把规矩写进去了它依旧我行我素的原因。所以这个文件对我来说不是越多越好，是越准越好。
下面我直接拿我真正在用的一个项目，把我的 CLAUDE.md 文件拆成四样，分门别类一样一样地拆给你看。
| 层 | 放什么 | 我的实例 |
|---|---|---|
| 便利贴：CLAUDE.md | 只放路由，告诉 AI 去哪里看 | 根目录 41 行，项目级 61 行 |
| 规则 | 想让 AI 遵守的规则手册 | 中英对照术语、出片前验收 |
| hooks | 机械闸门，检测到动作就打断或激活 | 动过出片代码但规则文档没改，就触发进化 skill |
| skills | 执行动作，用特定方式做特定的事 | 起手姿态五步法、进化 skill |
第一样：便利贴，CLAUDE.md 只放路由
这是我做视频的真实生产资料现场，Remotion 工程，拿真实现场来看会更加直观。根目录有一个 CLAUDE.md 文件，说明我这个视频工作台是什么样子的，还有硬规则。这些规则我不会写满，我是让它去看什么东西、默认什么东西，所有的东西都去查其他的文档。三层资源也是路由过去的：L0 官方的、共享的、出片的，目录在哪里，项目文件参考在哪里。这个文件只有 41 行，特别短。
再进到我真实的产出目录，里面也有一个 CLAUDE.md 文件，这个文件就是我真实制作的时候会读的文件：镜头组在哪里，全部都是路由。也就是说当我要什么东西，这里面给 AI 指向了它应该去什么地方看，它不会全部写在这里面。红线规则、组件本身，全部都是路由过去。这个文件也只有 61 行。
第二样：规则，让 AI 遵守的手册
规则这里我有一个规则文档，里面有几个规则。包括中英对照，这个规则是它在制作视频特效的时候需要看的名词术语是什么样的东西，这样它在做的时候就会更好地制作。还有出片前的验收之类的东西，这些都属于规则里面。
第三样：hooks，机械闸门
第三个就是 hooks。hooks 是什么呢？这些是我做的一些机械闸门。比如有一个结束钩子：本轮动过出片代码，却没动任何规则文档，就提示跑一遍，把学会的路由写回。比如说我在做完一个视频之后，本轮动了出片镜头代码，但规则文档一行没改，出现这个情况的时候，它就会去激活我的进化 skill。它是一道机械闸门，检测到我的代码进行了变动之后就会自动激活，激活了之后，它就会去激活我的 skill。
第四样：skills，执行动作
这个 skill 就是我们第四个，也就是工具这个层面。skills 里面装的是我这个视频制作台的一些 skill。一个是我的起手姿态，在我制作视频前的 skill，它决定这个画面怎么去做，比如五步法：意图、画面动作、标杆参考、怎么搭补沉淀。另一个是进化的 skill：规则文档每次都跟着进化，不靠人记得改，学到一条东西，路由到正确的源文件夹回写。手动触发是用户说「进化」「更新文档」，写规则的时候可以记一笔；自动触发就是收工时的文档进化。
飞轮：hooks 和 skill 联动
hooks 和进化 skill 两个是联动的。检测到本会话动过镜头出片代码，就会提醒跑这个 skill，所以它是自动去跑的。它首先会判定这个东西到底是纠正，还是新的角色，还是新的手法，然后写回。它就是一个循环的飞轮：我的视频制作越多，这个生产线就会不断地提高。
还有一个小点，变更日记也是它自动写入的：6 月 22 号做了哪些东西，6 月 21 号做了哪些东西。AI 在下一次进行创作的时候，就可以直接看到我的修改路径，都很快，并且这些东西都是它自己默认写的。
这就是我管理 CLAUDE.md 文件的方式：CLAUDE.md 文件只放路由，然后分门别类，规则放在规则里面，hooks 放在 hooks 里面，skill 放在 skill 里面。通过路由的形式，让它们不断地循环进化、不断地激发。当 hooks 监控到代码改变之后，就会激活进化 skill 去写进化；写进化的 skill 同时也会不断地把我的文件写回到变更日记里面。我只需要每一次去产出新的片子，它就会越来越好。
回顾：四样东西
- CLAUDE.md：得做成路由形式的，得薄。
- 规则文件：放你想让 AI 遵守的规则手册。
- hooks：一个机械闸门，在这里你可以设定动作，强制打断执行，或者激活。
- skills：一个执行动作，用特定的方式去做特定的事情，重复的事情就可以交给它。