Roo Code 模式体系与核心功能深度解析把一支 AI 开发团队装进代码编辑器【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeRoo Code 是一款在 VS Code 中运行的 AI 编程助手其官方定位是把一支 AI 开发团队直接带到你的编辑器里Il tuo team di sviluppo con IA, direttamente nel tuo editor。本文以其意大利语版官方 READMElocales/it/README.md为骨架结合仓库内源码与官方文档系统拆解 Roo Code 的七大核心能力、内置 Modes 模式体系、自定义模式配置方法以及 MCP 集成原理。读完本文你将掌握 Roo Code 的完整功能地图理解每个模式背后的工具权限与提示词机制并能独立编写、导入、导出与覆盖自定义模式。一、Roo Code 是什么Roo Code 是一个面向开发者的 AI 编程扩展可从 VS Code MarketplaceRooVeterinaryInc.roo-cline安装。它将规划、编码、答疑、调试等多种 AI 能力整合进编辑器工作流核心设计理念是让 AI 适应你的工作方式而不是让你去适应 AIRoo Code si adatta al tuo modo di lavorare, non il contrario。仓库同时维护了 18 种语言的 README 版本locales 目录覆盖英语、意大利语、德语、法语、简体中文、繁体中文等方便全球开发者以母语了解项目。从源码结构看该仓库是一个多包 monorepo核心扩展代码位于 src/VS Code 扩展宿主、packages/core核心逻辑、packages/types类型与 schema 定义、webview-ui聊天面板界面、apps/cli命令行版本与 apps/docs官方文档站。这些子项目的组织方式直接反映了本文将要讲解的各个功能模块。二、七大核心能力官方 README 将 Roo Code 的能力概括为七个方面下面逐条展开并结合源码验证其实现路径。1. 根据自然语言描述生成代码你可以在聊天输入框中用自然语言描述需求含规格说明由 AI 直接产出代码。这条能力由工具系统中的文件写入与编辑工具承载例如write_to_file整文件写入与apply_diff增量修改其参数定义见 src/shared/tools.ts 中的NativeToolArgs类型。2. 用 Modes 模式适应不同任务这是 Roo Code 最核心的设计。它内置了多种人格化模式Code、Architect、Ask、Debug 等每种模式拥有不同的角色定义、工具权限与行为指令详见下文第三、四章。五种模式的默认配置直接定义在 packages/types/src/mode.ts 的DEFAULT_MODES常量中。3. 重构与调试现有代码Roo Code 不只是从零写代码也能对既有代码进行重构与调试。edit工具组提供apply_diff、write_to_file、generate_image等文件操作能力以及可选的edit、search_replace、edit_file、apply_patch等兼容工具定义见 src/shared/tools.ts专门的 Debug 模式则内置了先假设、再验证的系统化排障流程见第四章。4. 编写与更新文档通过write_to_file/apply_diff等工具AI 可以撰写 README、API 文档和项目注释。更进一步你还可以通过自定义模式 规则文件为团队定制专属文档风格见第五章。5. 回答关于代码库的问题read工具组内置了read_file、search_files、list_files和codebase_search代码库语义搜索四项能力见 src/shared/tools.ts。配合 Ask 模式只读权限你可以安全地询问代码结构、函数语义或技术选型而不用担心 AI 误改文件。6. 自动化重复性任务重复性操作可以通过斜杠命令run_slash_command实现见 src/core/tools/RunSlashCommandTool.ts、技能skill实现见 src/core/tools/SkillTool.ts以及自动批准机制src/core/auto-approval来固化。run_slash_command与skill都被列入所有模式始终可用的工具列表src/shared/tools.ts。7. 使用 MCP 服务器Roo Code 完整支持 Model Context ProtocolMCPmcp工具组包含use_mcp_tool调用 MCP 工具与access_mcp_resource访问 MCP 资源实现见 src/core/tools/UseMcpToolTool.ts 与 src/core/tools/accessMcpResourceTool.ts。这意味着你可以把文件系统、数据库、浏览器等外部能力接入 AI 工作流。三、Modes适应你的工作方式Modes模式是 Roo Code 的行为定制机制。每种模式相当于一个拥有不同人格、专业领域和权限的 AI 助理你可以像切换队友一样在不同任务间切换模式。3.1 五种内置模式的官方描述意大利语 README 与源码一致地定义了以下内置模式完整的 slug、角色定义、工具组配置见 packages/types/src/mode.ts模式slug官方定位工具组适用场景 Codecode精通多种语言与设计模式的资深软件工程师readeditcommandmcp日常编码、文件修改与重构️ Architectarchitect经验丰富的技术领导者与规划者readedit仅限 MarkdownfileRegex: \.md$mcp系统设计、规格编写、迁移规划❓ Askask知识型技术助理readmcp快速答疑、代码讲解、文档阅读 Debugdebug系统化问题诊断专家readeditcommandmcp排查故障、添加日志、定位根因 Orchestratororchestrator工作流编排者又称 Boomerang 模式无直接工具通过new_task委派子任务复杂多步骤项目、跨模式协作几个值得注意的细节均来自 packages/types/src/mode.ts 的默认配置Architect 模式在edit组上附加了fileRegex: \\.md$约束即它只能编辑 Markdown 文件从机制上杜绝了规划者直接动代码Ask 模式只有read和mcp无法执行命令或修改文件天然适合安全地提问与学习Orchestrator 模式不直接操作任何工具组它的自定义指令要求通过new_task工具把复杂任务拆解给合适的专业模式并在子任务完成后汇总结果Debug 模式内置了经典排障方法论先反思 5–7 种可能原因压缩到 1–2 个最可能来源加日志验证假设并在修复前明确请求用户确认。3.2 工具组与始终可用工具每种模式能做什么取决于它拥有的工具组。工具组定义在 src/shared/tools.ts工具组包含工具能力说明readread_file、search_files、list_files、codebase_search读取、列出与搜索文件editapply_diff、write_to_file、generate_image另含可选的edit、search_replace、edit_file、apply_patch修改与创建文件commandexecute_command、read_command_output执行终端命令并读取输出mcpuse_mcp_tool、access_mcp_resource与 MCP 服务器交互modesswitch_mode、new_task切换模式、创建子任务所有模式始终可用此外以下 7 个工具被列为所有模式的始终可用工具src/shared/tools.tsask_followup_question、attempt_completion、switch_mode、new_task、update_todo_list、run_slash_command、skill。这意味着任何模式下 AI 都可以提问、声明完成、切换模式、维护待办列表和调用斜杠命令。3.3 模式记忆Sticky Models每种模式都会记住你最后一次使用的模型。切换模式时Roo Code 自动选中该模式上次使用的模型无需手动选择。你可以为不同模式分配不同模型例如 Architect 用推理强模型、Code 用编码快模型切换模式即自动换模型模式选择本身也会跨会话持久保存。3.4 四种切换模式的方式根据官方文档 apps/docs/docs/basic-usage/using-modes.md切换模式有四种途径下拉菜单点击聊天输入框左侧的模式选择器斜杠命令在消息开头输入/architect、/ask、/debug、/code或/orchestrator会切换到对应模式并清空输入框快捷键每次按下依次循环切换所有模式macOS 为⌘ .Windows / Linux 为Ctrl .接受建议当 Roo 判断当前任务更适合其他模式时会给出模式切换建议点击即可接受。四、为什么要用不同的模式使用模式化协作不是可有可无的装饰而是 Roo Code 安全模型的一部分任务专业化获得与当前任务精确匹配的协助类型安全控制在规划或学习阶段防止意外的文件修改例如 Ask 模式完全只读、Architect 模式只写 Markdown交互聚焦响应针对当前活动优化流程优化在规划、实现、调试、学习之间无缝过渡。当你试图编辑一个不符合当前模式fileRegex限制的文件时会触发FileRestrictionError定义见 src/shared/modes.ts错误信息会包含模式名、允许的文件模式、描述、目标路径与被拦截的工具帮助你快速理解为什么操作被阻止。五、自定义模式为团队定制专属 AI 队友内置模式无法覆盖所有工作流因此 Roo Code 允许创建自定义模式Custom Modes。官方文档详见 apps/docs/docs/features/custom-modes.mdx。自定义模式分为两类全局模式Global所有项目可用存储于全局设置目录的custom_modes.yaml或custom_modes.json项目模式Project仅当前工作区可用存储于项目根目录的.roomodes文件YAML 或 JSON 均可。5.1 创建方式的三种途径直接让 Roo 帮你创建推荐在聊天中描述需求例如创建一个名为 Documentation Writer 的模式它只能读取文件并编写 Markdown 文件Roo 会引导你补齐各项属性并生成 YAML 配置通过 Modes 页面打开 Roo Code 面板点击聊天框下的 Mode 菜单中的设置齿轮在 Modes 页面填写表单并点击Create Mode手动编辑配置文件点击设置齿轮下的 Edit Global Modes 打开全局配置或 Edit Project Modes (.roomodes) 打开工作区配置直接以 YAML首选或 JSON 编写。5.2 模式配置属性详解每个自定义模式由以下属性构成其 schema 校验定义在 packages/types/src/mode.ts 的modeConfigSchema中属性必填说明slug是唯一内部标识符必须匹配/^[a-zA-Z0-9-]$/仅字母、数字、连字符用于规则目录命名.roo/rules-{slug}/name是界面显示名称可包含空格与大小写description否模式选择器中显示的一句话简介roleDefinition是模式的核心身份与专业能力描述置于系统提示词开头whenToUse否供 Orchestrator 等自动化决策使用不显示在 UI 中customInstructions否附加行为准则置于系统提示词末尾groups是允许访问的工具组及文件权限限制YAML 示例同时适用于custom_modes.yaml与.roomodescustomModes: - slug: docs-writer name: Documentation Writer description: A specialized mode for writing and editing technical documentation. roleDefinition: You are a technical writer specializing in clear documentation. whenToUse: Use this mode for writing and editing documentation. customInstructions: Focus on clarity and completeness in documentation. groups: - read - - edit # 元组写法第一个元素是工具组名 - fileRegex: \.(md|mdx)$ # 第二个元素是限制选项 description: Markdown files onlyJSON 等价写法{ customModes: [ { slug: docs-writer, name: Documentation Writer, description: A specialized mode for writing and editing technical documentation., roleDefinition: You are a technical writer specializing in clear documentation., whenToUse: Use this mode for writing and editing documentation., customInstructions: Focus on clarity and completeness in documentation., groups: [ read, [edit, { fileRegex: \\.(md|mdx)$, description: Markdown files only }] ] } ] }5.3 工具组与文件权限限制groups支持两种写法纯字符串无限制访问该工具组例如edit元组两元素数组带限制的访问例如[edit, { fileRegex: \\.(md|mdx)$, description: Markdown files only }]。限制文件编辑范围时需要注意转义差异YAML 中通常使用单反斜杠如\.md$JSON 中必须双反斜杠如\\\\.md$。fileRegex匹配的是从工作区根目录开始的完整相对路径如src/components/button.js默认区分大小写非法正则会被 schema 拒绝并提示 Invalid regular expression patternpackages/types/src/mode.ts。常用正则示例意图YAML 写法JSON 写法仅 Markdown\.md$\\\\.md$仅 src 目录下^src/.*^src/.*CSS/SCSS\.(css\|scss)$\\.(css\|scss)$JS/TS 但排除测试文件^(?!.*(test\|spec))\.(js\|ts)$^(?!.*(test\|spec))\\.(js\|ts)$5.4 模式特定指令文件Rules除了customInstructions属性还可以通过文件/目录提供模式专属指令便于版本管理与团队协作首选方式——目录在工作区根目录创建.roo/rules-{slug}/如.roo/rules-docs-writer/目录内文件按文件名不区分大小写字母序递归加载自动排除.DS_Store、.swp等系统文件并支持带环检测的符号链接回退方式——单文件若目录不存在或为空则读取工作区根目录的.roorules-{slug}单文件旧版回退为兼容旧项目还会检查.clinerules-{slug}。优先级为目录方式 单文件方式。文件指令与customInstructions会合并文件内容通常追加在customInstructions之后。全局模式对应的规则目录位于系统全局 Roo 配置目录如~/.roo/rules-{slug}/。5.5 配置优先级模式配置按以下顺序生效实现于 src/core/config/CustomModesManager.ts 的mergeCustomModes逻辑见 src/core/config/CustomModesManager.ts项目模式.roomodes优先级最高全局模式custom_modes.yaml其次custom_modes.json内置默认模式。重要规则当相同 slug 的模式同时存在于.roomodes与全局设置时.roomodes版本完全覆盖全局版本所有属性整体替换、不做合并。你也可以通过定义与内置模式相同 slug如code、debug的自定义模式来覆盖内置模式从而为特定项目或全局定制默认行为。5.6 导入与导出Modes 页面提供导入/导出功能可将任意模式及其关联规则文件打包成单个可移植 YAML 文件便于团队共享、备份与模板化。导出时所有文件路径统一规范化为正斜杠以兼容跨平台导入时可选择Project写入.roomodes规则存入项目.roo/rules-{slug}/或Global写入全局设置规则存入~/.roo/rules-{slug}/。导出格式如下customModes: - slug: my-custom-mode name: My Custom Mode roleDefinition: You are a helpful assistant. groups: [read, edit] rulesFiles: - relativePath: rules-my-custom-mode/rules.md content: These are the rules for my custom mode.导入时若 slug 与已有模式冲突已有模式将被覆盖你还可以在导出文件中直接修改 slug导入流程会自动把规则文件路径同步为新 slug路径校验与防路径穿越逻辑见 src/core/config/CustomModesManager.ts。5.7 为什么首选 YAMLRoo Code 官方明确推荐 YAML 格式原因包括缩进式结构更易读、支持注释#、支持|保留换行与折叠换行多行字符串、标点更少、编辑器支持良好。全局模式在启动时会自动将custom_modes.json迁移为custom_modes.yaml保留原 JSON 用于回滚.roomodes不做启动期自动迁移但 Roo Code 会先尝试按 YAML 解析以自动检测格式且一旦通过 UI 编辑即自动转为 YAML 保存。JSON 仍完全受支持不会弃用。六、如何开始使用安装从 VS Code Marketplace 搜索并安装 Roo Code 扩展熟悉模式阅读 apps/docs/docs/basic-usage/using-modes.md 掌握内置模式与切换技巧自定义与进阶参考 apps/docs/docs/features/custom-modes.mdx 与 apps/docs/docs/index.mdx 了解自定义模式、技能、斜杠命令等高级用法参与反馈可以在仓库的 Issues 中报告 bug 并跟踪开发进展对应英文 README 的说明见 README.md。需要注意Roo Code 对任何由 AI 生成的代码、模型输出或关联第三方工具不提供任何明示或默示的保证所有工具均按 **AS IS现状**与AS AVAILABLE可用时提供使用相关工具或输出所产生的一切风险包括知识产权侵权、安全漏洞、偏差、不准确、病毒、宕机、财产损失等均由使用者自行承担。项目采用 Apache 2.0 许可协议发布完整条款见 LICENSE。结语Roo Code 的价值不在于一个能写代码的 AI而在于一套可编排、可约束、可共享的模式化协作体系——用内置模式覆盖规划、编码、答疑、调试的标准场景用自定义模式把团队规范、技术栈约束与文件权限固化进工作流再用 MCP 将外部能力接入其中。理解模式背后的工具组与提示词机制你就能让这支编辑器里的开发团队真正为你所用。【免费下载链接】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 模式体系与核心功能深度解析：把一支 AI 开发团队装进代码编辑器
Roo Code 模式体系与核心功能深度解析把一支 AI 开发团队装进代码编辑器【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeRoo Code 是一款在 VS Code 中运行的 AI 编程助手其官方定位是把一支 AI 开发团队直接带到你的编辑器里Il tuo team di sviluppo con IA, direttamente nel tuo editor。本文以其意大利语版官方 READMElocales/it/README.md为骨架结合仓库内源码与官方文档系统拆解 Roo Code 的七大核心能力、内置 Modes 模式体系、自定义模式配置方法以及 MCP 集成原理。读完本文你将掌握 Roo Code 的完整功能地图理解每个模式背后的工具权限与提示词机制并能独立编写、导入、导出与覆盖自定义模式。一、Roo Code 是什么Roo Code 是一个面向开发者的 AI 编程扩展可从 VS Code MarketplaceRooVeterinaryInc.roo-cline安装。它将规划、编码、答疑、调试等多种 AI 能力整合进编辑器工作流核心设计理念是让 AI 适应你的工作方式而不是让你去适应 AIRoo Code si adatta al tuo modo di lavorare, non il contrario。仓库同时维护了 18 种语言的 README 版本locales 目录覆盖英语、意大利语、德语、法语、简体中文、繁体中文等方便全球开发者以母语了解项目。从源码结构看该仓库是一个多包 monorepo核心扩展代码位于 src/VS Code 扩展宿主、packages/core核心逻辑、packages/types类型与 schema 定义、webview-ui聊天面板界面、apps/cli命令行版本与 apps/docs官方文档站。这些子项目的组织方式直接反映了本文将要讲解的各个功能模块。二、七大核心能力官方 README 将 Roo Code 的能力概括为七个方面下面逐条展开并结合源码验证其实现路径。1. 根据自然语言描述生成代码你可以在聊天输入框中用自然语言描述需求含规格说明由 AI 直接产出代码。这条能力由工具系统中的文件写入与编辑工具承载例如write_to_file整文件写入与apply_diff增量修改其参数定义见 src/shared/tools.ts 中的NativeToolArgs类型。2. 用 Modes 模式适应不同任务这是 Roo Code 最核心的设计。它内置了多种人格化模式Code、Architect、Ask、Debug 等每种模式拥有不同的角色定义、工具权限与行为指令详见下文第三、四章。五种模式的默认配置直接定义在 packages/types/src/mode.ts 的DEFAULT_MODES常量中。3. 重构与调试现有代码Roo Code 不只是从零写代码也能对既有代码进行重构与调试。edit工具组提供apply_diff、write_to_file、generate_image等文件操作能力以及可选的edit、search_replace、edit_file、apply_patch等兼容工具定义见 src/shared/tools.ts专门的 Debug 模式则内置了先假设、再验证的系统化排障流程见第四章。4. 编写与更新文档通过write_to_file/apply_diff等工具AI 可以撰写 README、API 文档和项目注释。更进一步你还可以通过自定义模式 规则文件为团队定制专属文档风格见第五章。5. 回答关于代码库的问题read工具组内置了read_file、search_files、list_files和codebase_search代码库语义搜索四项能力见 src/shared/tools.ts。配合 Ask 模式只读权限你可以安全地询问代码结构、函数语义或技术选型而不用担心 AI 误改文件。6. 自动化重复性任务重复性操作可以通过斜杠命令run_slash_command实现见 src/core/tools/RunSlashCommandTool.ts、技能skill实现见 src/core/tools/SkillTool.ts以及自动批准机制src/core/auto-approval来固化。run_slash_command与skill都被列入所有模式始终可用的工具列表src/shared/tools.ts。7. 使用 MCP 服务器Roo Code 完整支持 Model Context ProtocolMCPmcp工具组包含use_mcp_tool调用 MCP 工具与access_mcp_resource访问 MCP 资源实现见 src/core/tools/UseMcpToolTool.ts 与 src/core/tools/accessMcpResourceTool.ts。这意味着你可以把文件系统、数据库、浏览器等外部能力接入 AI 工作流。三、Modes适应你的工作方式Modes模式是 Roo Code 的行为定制机制。每种模式相当于一个拥有不同人格、专业领域和权限的 AI 助理你可以像切换队友一样在不同任务间切换模式。3.1 五种内置模式的官方描述意大利语 README 与源码一致地定义了以下内置模式完整的 slug、角色定义、工具组配置见 packages/types/src/mode.ts模式slug官方定位工具组适用场景 Codecode精通多种语言与设计模式的资深软件工程师readeditcommandmcp日常编码、文件修改与重构️ Architectarchitect经验丰富的技术领导者与规划者readedit仅限 MarkdownfileRegex: \.md$mcp系统设计、规格编写、迁移规划❓ Askask知识型技术助理readmcp快速答疑、代码讲解、文档阅读 Debugdebug系统化问题诊断专家readeditcommandmcp排查故障、添加日志、定位根因 Orchestratororchestrator工作流编排者又称 Boomerang 模式无直接工具通过new_task委派子任务复杂多步骤项目、跨模式协作几个值得注意的细节均来自 packages/types/src/mode.ts 的默认配置Architect 模式在edit组上附加了fileRegex: \\.md$约束即它只能编辑 Markdown 文件从机制上杜绝了规划者直接动代码Ask 模式只有read和mcp无法执行命令或修改文件天然适合安全地提问与学习Orchestrator 模式不直接操作任何工具组它的自定义指令要求通过new_task工具把复杂任务拆解给合适的专业模式并在子任务完成后汇总结果Debug 模式内置了经典排障方法论先反思 5–7 种可能原因压缩到 1–2 个最可能来源加日志验证假设并在修复前明确请求用户确认。3.2 工具组与始终可用工具每种模式能做什么取决于它拥有的工具组。工具组定义在 src/shared/tools.ts工具组包含工具能力说明readread_file、search_files、list_files、codebase_search读取、列出与搜索文件editapply_diff、write_to_file、generate_image另含可选的edit、search_replace、edit_file、apply_patch修改与创建文件commandexecute_command、read_command_output执行终端命令并读取输出mcpuse_mcp_tool、access_mcp_resource与 MCP 服务器交互modesswitch_mode、new_task切换模式、创建子任务所有模式始终可用此外以下 7 个工具被列为所有模式的始终可用工具src/shared/tools.tsask_followup_question、attempt_completion、switch_mode、new_task、update_todo_list、run_slash_command、skill。这意味着任何模式下 AI 都可以提问、声明完成、切换模式、维护待办列表和调用斜杠命令。3.3 模式记忆Sticky Models每种模式都会记住你最后一次使用的模型。切换模式时Roo Code 自动选中该模式上次使用的模型无需手动选择。你可以为不同模式分配不同模型例如 Architect 用推理强模型、Code 用编码快模型切换模式即自动换模型模式选择本身也会跨会话持久保存。3.4 四种切换模式的方式根据官方文档 apps/docs/docs/basic-usage/using-modes.md切换模式有四种途径下拉菜单点击聊天输入框左侧的模式选择器斜杠命令在消息开头输入/architect、/ask、/debug、/code或/orchestrator会切换到对应模式并清空输入框快捷键每次按下依次循环切换所有模式macOS 为⌘ .Windows / Linux 为Ctrl .接受建议当 Roo 判断当前任务更适合其他模式时会给出模式切换建议点击即可接受。四、为什么要用不同的模式使用模式化协作不是可有可无的装饰而是 Roo Code 安全模型的一部分任务专业化获得与当前任务精确匹配的协助类型安全控制在规划或学习阶段防止意外的文件修改例如 Ask 模式完全只读、Architect 模式只写 Markdown交互聚焦响应针对当前活动优化流程优化在规划、实现、调试、学习之间无缝过渡。当你试图编辑一个不符合当前模式fileRegex限制的文件时会触发FileRestrictionError定义见 src/shared/modes.ts错误信息会包含模式名、允许的文件模式、描述、目标路径与被拦截的工具帮助你快速理解为什么操作被阻止。五、自定义模式为团队定制专属 AI 队友内置模式无法覆盖所有工作流因此 Roo Code 允许创建自定义模式Custom Modes。官方文档详见 apps/docs/docs/features/custom-modes.mdx。自定义模式分为两类全局模式Global所有项目可用存储于全局设置目录的custom_modes.yaml或custom_modes.json项目模式Project仅当前工作区可用存储于项目根目录的.roomodes文件YAML 或 JSON 均可。5.1 创建方式的三种途径直接让 Roo 帮你创建推荐在聊天中描述需求例如创建一个名为 Documentation Writer 的模式它只能读取文件并编写 Markdown 文件Roo 会引导你补齐各项属性并生成 YAML 配置通过 Modes 页面打开 Roo Code 面板点击聊天框下的 Mode 菜单中的设置齿轮在 Modes 页面填写表单并点击Create Mode手动编辑配置文件点击设置齿轮下的 Edit Global Modes 打开全局配置或 Edit Project Modes (.roomodes) 打开工作区配置直接以 YAML首选或 JSON 编写。5.2 模式配置属性详解每个自定义模式由以下属性构成其 schema 校验定义在 packages/types/src/mode.ts 的modeConfigSchema中属性必填说明slug是唯一内部标识符必须匹配/^[a-zA-Z0-9-]$/仅字母、数字、连字符用于规则目录命名.roo/rules-{slug}/name是界面显示名称可包含空格与大小写description否模式选择器中显示的一句话简介roleDefinition是模式的核心身份与专业能力描述置于系统提示词开头whenToUse否供 Orchestrator 等自动化决策使用不显示在 UI 中customInstructions否附加行为准则置于系统提示词末尾groups是允许访问的工具组及文件权限限制YAML 示例同时适用于custom_modes.yaml与.roomodescustomModes: - slug: docs-writer name: Documentation Writer description: A specialized mode for writing and editing technical documentation. roleDefinition: You are a technical writer specializing in clear documentation. whenToUse: Use this mode for writing and editing documentation. customInstructions: Focus on clarity and completeness in documentation. groups: - read - - edit # 元组写法第一个元素是工具组名 - fileRegex: \.(md|mdx)$ # 第二个元素是限制选项 description: Markdown files onlyJSON 等价写法{ customModes: [ { slug: docs-writer, name: Documentation Writer, description: A specialized mode for writing and editing technical documentation., roleDefinition: You are a technical writer specializing in clear documentation., whenToUse: Use this mode for writing and editing documentation., customInstructions: Focus on clarity and completeness in documentation., groups: [ read, [edit, { fileRegex: \\.(md|mdx)$, description: Markdown files only }] ] } ] }5.3 工具组与文件权限限制groups支持两种写法纯字符串无限制访问该工具组例如edit元组两元素数组带限制的访问例如[edit, { fileRegex: \\.(md|mdx)$, description: Markdown files only }]。限制文件编辑范围时需要注意转义差异YAML 中通常使用单反斜杠如\.md$JSON 中必须双反斜杠如\\\\.md$。fileRegex匹配的是从工作区根目录开始的完整相对路径如src/components/button.js默认区分大小写非法正则会被 schema 拒绝并提示 Invalid regular expression patternpackages/types/src/mode.ts。常用正则示例意图YAML 写法JSON 写法仅 Markdown\.md$\\\\.md$仅 src 目录下^src/.*^src/.*CSS/SCSS\.(css\|scss)$\\.(css\|scss)$JS/TS 但排除测试文件^(?!.*(test\|spec))\.(js\|ts)$^(?!.*(test\|spec))\\.(js\|ts)$5.4 模式特定指令文件Rules除了customInstructions属性还可以通过文件/目录提供模式专属指令便于版本管理与团队协作首选方式——目录在工作区根目录创建.roo/rules-{slug}/如.roo/rules-docs-writer/目录内文件按文件名不区分大小写字母序递归加载自动排除.DS_Store、.swp等系统文件并支持带环检测的符号链接回退方式——单文件若目录不存在或为空则读取工作区根目录的.roorules-{slug}单文件旧版回退为兼容旧项目还会检查.clinerules-{slug}。优先级为目录方式 单文件方式。文件指令与customInstructions会合并文件内容通常追加在customInstructions之后。全局模式对应的规则目录位于系统全局 Roo 配置目录如~/.roo/rules-{slug}/。5.5 配置优先级模式配置按以下顺序生效实现于 src/core/config/CustomModesManager.ts 的mergeCustomModes逻辑见 src/core/config/CustomModesManager.ts项目模式.roomodes优先级最高全局模式custom_modes.yaml其次custom_modes.json内置默认模式。重要规则当相同 slug 的模式同时存在于.roomodes与全局设置时.roomodes版本完全覆盖全局版本所有属性整体替换、不做合并。你也可以通过定义与内置模式相同 slug如code、debug的自定义模式来覆盖内置模式从而为特定项目或全局定制默认行为。5.6 导入与导出Modes 页面提供导入/导出功能可将任意模式及其关联规则文件打包成单个可移植 YAML 文件便于团队共享、备份与模板化。导出时所有文件路径统一规范化为正斜杠以兼容跨平台导入时可选择Project写入.roomodes规则存入项目.roo/rules-{slug}/或Global写入全局设置规则存入~/.roo/rules-{slug}/。导出格式如下customModes: - slug: my-custom-mode name: My Custom Mode roleDefinition: You are a helpful assistant. groups: [read, edit] rulesFiles: - relativePath: rules-my-custom-mode/rules.md content: These are the rules for my custom mode.导入时若 slug 与已有模式冲突已有模式将被覆盖你还可以在导出文件中直接修改 slug导入流程会自动把规则文件路径同步为新 slug路径校验与防路径穿越逻辑见 src/core/config/CustomModesManager.ts。5.7 为什么首选 YAMLRoo Code 官方明确推荐 YAML 格式原因包括缩进式结构更易读、支持注释#、支持|保留换行与折叠换行多行字符串、标点更少、编辑器支持良好。全局模式在启动时会自动将custom_modes.json迁移为custom_modes.yaml保留原 JSON 用于回滚.roomodes不做启动期自动迁移但 Roo Code 会先尝试按 YAML 解析以自动检测格式且一旦通过 UI 编辑即自动转为 YAML 保存。JSON 仍完全受支持不会弃用。六、如何开始使用安装从 VS Code Marketplace 搜索并安装 Roo Code 扩展熟悉模式阅读 apps/docs/docs/basic-usage/using-modes.md 掌握内置模式与切换技巧自定义与进阶参考 apps/docs/docs/features/custom-modes.mdx 与 apps/docs/docs/index.mdx 了解自定义模式、技能、斜杠命令等高级用法参与反馈可以在仓库的 Issues 中报告 bug 并跟踪开发进展对应英文 README 的说明见 README.md。需要注意Roo Code 对任何由 AI 生成的代码、模型输出或关联第三方工具不提供任何明示或默示的保证所有工具均按 **AS IS现状**与AS AVAILABLE可用时提供使用相关工具或输出所产生的一切风险包括知识产权侵权、安全漏洞、偏差、不准确、病毒、宕机、财产损失等均由使用者自行承担。项目采用 Apache 2.0 许可协议发布完整条款见 LICENSE。结语Roo Code 的价值不在于一个能写代码的 AI而在于一套可编排、可约束、可共享的模式化协作体系——用内置模式覆盖规划、编码、答疑、调试的标准场景用自定义模式把团队规范、技术栈约束与文件权限固化进工作流再用 MCP 将外部能力接入其中。理解模式背后的工具组与提示词机制你就能让这支编辑器里的开发团队真正为你所用。【免费下载链接】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），仅供参考