使用 /init 生成 CLAUDE.md

在对话面板中输入一条命令

打开一个已加载该项目的对话，输入 /init 并发送。技能随即启动——Agent 会遍历文件树，读取明显的入口点（README.md、package.json、Cargo.toml、Makefile、.github/、scripts/ 等），查看近期提交记录以了解进行中的工作，然后在项目根目录写出 CLAUDE.md 草稿。

对于一般规模的项目，整个过程需要一两分钟。Agent 会展示其工作过程——你可以在对话中实时看到它读取的文件。输出的是一个真实存在于磁盘上的文件，随时可以查阅。

重点检查三件事

打开 CLAUDE.md，一份好的草稿应包含：

• 项目是做什么的。 开头一段说清楚。Agent 通常能通过读取 README 把这部分写对。
• 如何构建、测试和运行。 提供 Agent 应该使用的具体命令，而不是模糊的描述。npm test 比"用 npm 运行测试"有用得多。
• 约定与注意事项。 命名规范、需要小心的文件、"不要手动编辑 X"、只有内部人才知道的事情。Agent 能从 .editorconfig、lint 配置和近期提交中推断出一部分，但其余的它会遗漏。

一份差的草稿读起来像 README——只有描述，没有指导。这时就应该动手编辑，而不是照单全收。

加入团队内部知识

草稿善于捕捉代码中可见的事实，却会遗漏只有人类才知道的东西：

• "我们正在从 X 迁移出去，不要新增对它的使用。"
• "这个文件看起来很重要，但实际上已经废弃了——忽略它。"
• "这整个子目录由另一个团队维护，改动前请先沟通。"
• "integration/ 里的测试在慢速机器上不稳定；如果偶尔失败，重跑一次，不用深究。"

这些条目才是回报最丰厚的部分。用你自己的语言把它们加进去。Agent 不是在写一份精致的文档——它只是在替你播下种子，等待你来培育。

它属于仓库

像对待其他文件一样，将 CLAUDE.md 暂存并提交。它是项目级的上下文；你的队友发起对话时同样受益。每次新克隆、每位新开发者的第一次对话、每次 CI Agent 运行——所有人都会获得同一份上下文。

一个合理的提交信息：Add CLAUDE.md for agent context。

几乎不需要；通常直接手动编辑

一旦 CLAUDE.md 就位，重新运行 /init 会覆盖它。这几乎永远不是你想要的——你已经添加了 Agent 看不到、也不会重新生成的人工撰写内容。

在以下情况下可以重新运行 /init：

• 项目结构发生了重大变化（大规模重写、顶层目录结构调整）。
• 你对现有版本一直不满意，想要从头来过。

其他情况直接手动编辑即可。大多数更新只是一行新增：记录一个新踩到的坑、补充一条废弃说明、记下一个约定。

项目、用户与子目录三级作用域

LingCode 会从三个位置读取 CLAUDE.md，并在对话开始时合并：

• 项目根目录 — 即 /init 写入的位置。对该项目下的每次对话都会加载。
• 用户级，位于 ~/.claude/CLAUDE.md — 跨项目的个人习惯（"我希望提交信息始终使用祈使语气"）。/init 不会触及此文件。
• 子目录 — 子文件夹内的 CLAUDE.md 仅在该文件夹内工作时生效。适用于每个包有自己约定的 monorepo。

若对话处于 packages/api/ 目录下，则三者同时生效：用户级、项目根目录以及 packages/api/CLAUDE.md。项目约定会覆盖用户习惯；子目录规则会覆盖项目根目录。