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 CodeVS Code 编辑器插件从 v3.26.02025-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 isnt 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的既有加载机制团队也可以把规则文件直接放进版本库共享。验证初始化结果文档没有给出固定的成功日志可核对的落点是文件与加载配置命令可见在聊天输入框输入/命令菜单中应出现/init。如果菜单里看不到按 Slash Commands 文档 的排查项确认扩展已正常加载必要时重载 VS Code 窗口reload window。文件生成执行完成后检查工作区根目录下的.roo/目录应出现rules-*形式的子目录其中包含AGENTS.md规则文件。打开文件核对内容应能看到项目类型、框架、构建/测试命令和代码约定等与本项目相关的条目。规则已生效发起任务时这些规则文件的内容会按上述顺序追加进系统提示词。若发现根目录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 commandinit/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 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 CodeVS Code 编辑器插件从 v3.26.02025-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 isnt 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的既有加载机制团队也可以把规则文件直接放进版本库共享。验证初始化结果文档没有给出固定的成功日志可核对的落点是文件与加载配置命令可见在聊天输入框输入/命令菜单中应出现/init。如果菜单里看不到按 Slash Commands 文档 的排查项确认扩展已正常加载必要时重载 VS Code 窗口reload window。文件生成执行完成后检查工作区根目录下的.roo/目录应出现rules-*形式的子目录其中包含AGENTS.md规则文件。打开文件核对内容应能看到项目类型、框架、构建/测试命令和代码约定等与本项目相关的条目。规则已生效发起任务时这些规则文件的内容会按上述顺序追加进系统提示词。若发现根目录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 commandinit/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考