12 · /init 教程：生成与维护 CLAUDE.md

用 /init 扫描项目并生成 CLAUDE.md 的流程、生成结果的检查方法和后续维护原则，让 Claude 快速理解项目。

Claude Code 有个很贴心的能力：一条 `/init` 命令，就能自动扫描你的项目、生成一份项目说明书（CLAUDE.md）。

「流程」很简单：在项目目录里敲 `/init`，它会去读你的项目结构、关键文件、依赖配置，然后生成一份 CLAUDE.md，概括这个项目是干什么的、怎么构建、有什么约定。

「生成的 CLAUDE.md」是给 Claude 看的「项目速览」。有了它，Claude 每次任务开始前就能快速理解项目，而不是从头摸索。

「检查生成结果」这一步不能省。自动生成的东西不一定准，你要亲自过一遍：它有没有把关键信息抓对、有没有遗漏、有没有理解错的地方。生成是「草稿」，审查后才算「定稿」。

「维护原则」是重点：CLAUDE.md 不是写一次就完事的。项目在变，它就得跟着变。把它当成项目的一部分，随代码一起演进。

一个常见误区是「生成完就不管了」。结果项目早就变了，CLAUDE.md 还停在老版本，反而误导 Claude。所以要么定期更新，要么养成「项目有大改动时顺手更新」的习惯。

`/init` 的价值，是帮你「快速起步」——省去从零手写项目说明的功夫。但真正的质量，取决于你后面的审查和维护。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。