Verboo Code 的 /init：一条命令生成项目的 CLAUDE.md

在新仓库里打开 Verboo Code，智能体并不知道测试要用 make test 运行、包管理器是 pnpm，也不知道 .cursorrules 里有一条全队都遵守的规则。/init 一条命令就能解决：它读取项目，写出一个包含命令和架构的 CLAUDE.md，此后每次会话 CLI 都会加载它。

/init 在 Verboo Code 里做什么？

它分析仓库，并在你打开会话的目录中创建项目指令文件 CLAUDE.md。运行期间，CLI 会显示 analyzing your codebase。

npm install -g @verboo/code
cd ~/projects/my-app
verboo

会话打开后输入：

/init

请在仓库根目录打开，也就是 package.json、pyproject.toml 或 go.mod 所在的位置。文件会写入会话目录，而 CLI 会从当前目录向上查找指令文件。

/init 读取什么，写入什么？

它读取项目里已有的文档，只写两类内容：命令和架构。下表来自 src/commands/init.ts 中该命令的提示词。

读取	写入 CLAUDE.md
README.md	构建、lint 和测试命令
Cursor 规则：.cursor/rules/ 和 .cursorrules	如何只运行单个测试
Copilot 规则：.github/copilot-instructions.md	高层架构，即需要读多个文件才能理解的部分
已有的 CLAUDE.md	改进建议，而不是新文件

提示词还要求智能体跳过显而易见的内容：不写“编写单元测试”，不罗列每个文件，也不编造读过的文件里不存在的“开发技巧”之类章节。结果通常很短，这是有意为之。

能用 /init 从 Cursor 或 Copilot 迁移吗？

可以，而且是最快的方式。如果仓库里有 .cursorrules、.cursor/rules/ 或 .github/copilot-instructions.md，/init 会被要求把其中重要的部分带进 CLAUDE.md。无需逐条复制：运行命令，再确认关键内容都已写入。

如何审阅生成的 CLAUDE.md？

逐行问自己：没有这一行，智能体会出错吗？不会，就删掉。文件里的所有内容都会进入每次会话的上下文，代码中把每个文件的建议上限设为 40,000 个字符。

# CLAUDE.md

## Commands
- Install: pnpm install (never npm)
- Tests: make test
- Single test: pnpm vitest run src/api/users.test.ts

## Architecture
- src/api exposes REST; src/jobs runs the queues. Both read src/core.
- Migrations live in db/migrations, generated with make migration name=...

之后要编辑，用 /memory，它会在你的编辑器中打开该文件。不该进入 git 的个人规则放在 CLAUDE.local.md，不由 /init 生成。

如果仓库已经有 AGENTS.md 怎么办？

只保留一个根文件。在同一目录中，Verboo Code 加载 AGENTS.md，只有在 AGENTS.md 不存在时才使用 CLAUDE.md。两者不会叠加。如果运行 /init 后两个文件都在，把新内容并入 AGENTS.md 并删除另一个：

cat CLAUDE.md >> AGENTS.md
rm CLAUDE.md

然后打开 AGENTS.md 删去重复内容。如果仓库没有 AGENTS.md，生成的 CLAUDE.md 就是项目文件，无需这些步骤。

什么时候再次运行 /init？

在结构性变化之后：更换包管理器、单体仓库新增服务、测试命令改变。已有 CLAUDE.md 时，/init 会提出改进而不是从头开始，你审阅差异、接受合理的部分即可。想调整某个具体点，就在下一条消息里说，例如：“补充如何运行集成测试”。

它和其他命令如何配合？

• /plan 会按照指令文件来制定计划。
• /context 显示该文件占用了多少上下文。
• 指令是请求，不是锁。要真正阻止某个命令，请用 /permissions。