Roo Code 如何用 /init 命令为新项目初始化 AI 助手配置与规则文件

Roo Code 如何用 /init 命令为新项目初始化 AI 助手配置与规则文件

【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code

接手一个新项目时，AI 助手默认并不知道这个项目的技术栈、构建方式、测试约定和代码风格。Roo Code（VS Code 编辑器插件）从 v3.26.0（2025-08-26 发布）起内置了/init斜杠命令，用来解决这个问题：它在聊天中分析整个代码库，把分析结果写成项目专属的 AI 助手配置与规则文件。本文按实际操作顺序说明：/init会做哪些分析、如何触发它、生成的文件落在哪里并如何生效、以及如何核对结果。

前提只有一个：你已经在 VS Code 中启用 Roo Code 并打开了目标项目，可以直接在它的聊天输入框中输入命令。/init是内置命令，不需要预先创建任何.md文件。

/init 执行的五阶段分析

根据 Slash Commands 文档，/init是一个完整的 AI 助手配置工具，执行时会做以下多阶段分析：

• Discovery（发现）：扫描项目结构，识别关键技术；
• Project Identification（项目识别）：判断项目类型、框架和依赖；
• Architecture Mapping（架构映射）：分析代码组织方式与设计模式；
• Build/Test Detection（构建与测试检测）：识别构建工具、测试框架和脚本；
• Code Style Extraction（代码风格提取）：捕获编码约定和模式。

它的目标不是生成大而全的项目说明书，而是记录"那些仅从代码结构看不出来的项目专属信息"（v3.26.0 发布说明原话：documenting project-specific information that isn't obvious from the code structure alone）。生成的文档遵循 "non-obvious-only"（只记非显而易见内容）原则，保持简短、高信息密度，并附带用于项目初始化的 todo 列表，同时会记录安全与性能方面的注意事项。

触发 /init 命令

执行方式很简单：在 Roo Code 的聊天输入框中直接输入/init并发送。输入/会先弹出命令选择菜单，可以在其中看到/init并选中它。

文档给出的适用场景提示是：刚开始接手一个新项目、或者希望团队内建立一致的 AI 助手行为时，/init尤其有用。

执行过程中 AI 会按上述阶段读取和分析代码，最终把结果写入文件。写入文件属于常规的工具操作，仍受 Roo Code 的审批机制约束（例如自动审批设置决定是否需要逐次确认写入）。

生成的文件落在哪里

/init的产物是模式专属的AGENTS.md文件，写入.roo/rules-*目录，例如为 Code、Architect、Debug 等不同 Roo Code 模式各生成一份规则（Slash Commands 文档）。它同时支持多种 AI 助手的格式（Claude、Cursor、Copilot）。

这些目录正是 Roo Code 加载自定义指令的位置。按照 Custom Instructions 文档 的说明：

• 模式专属规则：.roo/rules-{modeSlug}/目录（例如.roo/rules-code/）只对对应模式生效；
• 工作区级规则：.roo/rules/目录对当前项目的所有模式生效；
• 目录会被递归读取（含子目录），文件按文件名字母顺序追加进系统提示词，每个目录规则文件会带有# Rules from {absolute path}:来源头；
• 加载顺序是先全局规则（~/.roo/）再工作区规则（项目根.roo/），冲突时工作区规则优先；同一层内模式专属规则先于通用规则加载。

也就是说，/init生成的规则文件不需要任何手动注册，之后每次对话都会自动随系统提示词加载。

另外注意区分：Roo Code 还会默认读取工作区根目录下的AGENTS.md（或AGENT.md作为后备），该行为由 VS Code 设置项roo-cline.useAgentRules控制（默认true），设为"roo-cline.useAgentRules": false可关闭。这是独立于/init的既有加载机制，团队也可以把规则文件直接放进版本库共享。

验证初始化结果

文档没有给出固定的成功日志，可核对的落点是文件与加载配置：

1. 命令可见：在聊天输入框输入/，命令菜单中应出现/init。如果菜单里看不到，按 Slash Commands 文档 的排查项：确认扩展已正常加载，必要时重载 VS Code 窗口（reload window）。
2. 文件生成：执行完成后，检查工作区根目录下的.roo/目录，应出现rules-*形式的子目录，其中包含AGENTS.md规则文件。打开文件核对内容，应能看到项目类型、框架、构建/测试命令和代码约定等与本项目相关的条目。
3. 规则已生效：发起任务时，这些规则文件的内容会按上述顺序追加进系统提示词。若发现根目录AGENTS.md内容未被采纳，检查roo-cline.useAgentRules是否被设置为false；空的或只含空白的AGENTS.md会被直接忽略。

如果输入/init后提示命令未找到，文档说明 LLM 会看到一条错误信息，指明命令应当存放的位置，可据此确认扩展状态或重载窗口。

可选：让 AI 自动执行 /init

从 v3.26.6 起，Roo Code 提供了run_slash_command工具，AI 可以在自己的工作流程中自动调用/init这类斜杠命令（v3.26.6 发布说明）。这是一条可选的自动化路径，注意它的边界：

• 该工具是实验性功能，默认关闭，需要在 Settings > Experimental Settings 中启用 "Run Slash Command"（必要时重启 VS Code）；
• 命令解析优先级为：项目级（.roo/commands/）> 全局级（~/.roo/commands/）> 内置级，/init作为内置命令位于最低优先级；
• 命令名匹配区分大小写，每次工具调用只能执行一个命令，且所有执行都需要用户审批。

文档给出的调用示例如下（这是 AI 侧的工具调用格式，不是让你在聊天里手动输入的文本）：

<run_slash_command> <command>init</command> </run_slash_command>

详见 run_slash_command 工具文档。

限制与注意事项

• 内置命令不可覆盖：文档明确说明 built-in commands cannot be overridden，即不能用自定义命令替换/init；通过 UI 创建重名自定义命令时会自动追加数字（如new-command-1）。
• 产物风格是"少而准"：/init遵循 non-obvious-only 原则生成简洁规则，不是把整个项目文档化；生成结果需要人工审阅，团队可将其纳入版本控制以统一 AI 助手行为。
• 工作区规则优先于全局规则：如果项目里已有~/.roo/下的全局规则与/init生成的工作区规则冲突，以工作区（项目内）规则为准，这是文档规定的加载行为，不是 bug。
• /init分析的是当前工作区的项目；多根工作区等环境下的行为文档未单独说明，建议以单项目工作区使用。

完成/init之后，接下来通常是审阅生成的.roo/rules-*规则文件，按团队约定修订后提交到版本库；如果还需要更细的行为定制，可继续参考 Custom Instructions 文档 中关于全局规则目录与模式专属规则的说明。

【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code