Roo Code 功能与 Modes 模式体系全解在编辑器内驾驭 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 开发团队”直接带进你的编辑器。本文以官方土耳其语 READMElocales/tr/README.md为骨架结合仓库源码深入讲解 Roo Code 的核心能力、内置 Modes模式体系与自定义模式的底层机制帮助你理解它是如何通过“模式”这一设计来适配不同开发场景并学会配置属于自己的工作流。Roo Code 能为你做什么根据官方简介Roo Code 面向开发者的核心能力可以归纳为以下七项从自然语言描述和规格说明生成代码直接以对话方式描述需求Roo 负责将其转化为可运行的实现。通过 Modes 适配工作方式内置 Code、Architect、Ask、Debug 等模式并可创建自定义模式让同一款工具在不同阶段扮演不同角色。重构与调试现有代码对既有代码库进行结构优化与缺陷修复。编写与更新文档自动产出并维护项目文档。回答关于代码库的问题基于工作区上下文进行问答分析。自动化重复性任务把高频、机械的工作交给 Agent 循环处理。使用 MCP 服务器通过 Model Context Protocol 接入外部工具与数据源扩展能力边界。从架构实现上看这些能力统一由 src/core/task/Task.ts 驱动的主 Agent 循环承载Agent 在“读取文件→搜索代码→执行命令→编辑文件→完成任务”之间循环推进直到把用户请求落地。你可以通过 apps/cli/docs/AGENT_LOOP.md 了解这一循环的完整描述。ModesRoo Code 的核心设计“Roo Code 适配你的工作方式而不是让你去适配它”是官方反复强调的设计理念。Modes模式本质上是一组预置的**角色定义role definition 工具权限tool groups**的组合切换到某个模式就等于让 Agent 换上一套专属的“人设”和“工具箱”。在源码层面每个内置模式的完整配置定义在 packages/types/src/mode.ts 的DEFAULT_MODES常量中包含slug唯一标识、name、roleDefinition角色定义、whenToUse适用场景、description描述、customInstructions自定义指令以及groups允许使用的工具分组等字段。内置模式一览官方简介列出了以下内置模式每种模式的能力边界都通过groups字段精确划定模式用途允许的工具分组源码依据Code代码日常编码、修改与文件操作read、edit、command、mcpArchitect架构师规划系统、规格说明与迁移方案read、edit仅限.md文件、mcpAsk提问快速解答、解释与文档生成read、mcpDebug调试追踪问题、添加日志、隔离根因read、edit、command、mcpCustom自定义为团队或特定工作流打造专属模式由你在配置文件中自行定义工具分组的具体构成定义在 src/shared/tools.tsreadread_file、search_files、list_files、codebase_search——只读类信息获取工具editapply_diff、write_to_file、generate_image以及edit、search_replace、apply_patch等可选自定义工具——文件修改类commandexecute_command、read_command_output——终端命令执行类mcpuse_mcp_tool、access_mcp_resource——MCP 服务器调用类modesswitch_mode、new_task——模式切换与任务委派该组标记为alwaysAvailable对所有模式始终开放。此外还有一组始终可用工具ALWAYS_AVAILABLE_TOOLS见 src/shared/tools.ts包括ask_followup_question追问澄清、attempt_completion任务收尾、switch_mode请求切换模式、new_task创建子任务、update_todo_list维护待办清单、run_slash_command运行斜杠命令和skill加载技能。这意味着无论身处哪个模式Agent 都保有基本的“沟通、收尾、转场”能力模式差异主要体现在对文件与命令等强副作用工具的授权上。值得注意的是DEFAULT_MODES中还定义了第六个内置模式Orchestrator协调者它的groups为空数组专注于通过new_task将复杂任务拆解委派给各专业模式再汇总结果——这正是官方 README 所述“整套 AI 开发团队”的组织形式可由 src/core/tools/NewTaskTool.ts 与 src/core/tools/SwitchModeTool.ts 等工具佐证。模式的解析与合并机制src/shared/modes.ts 提供了模式系统的运行时核心逻辑getModeBySlug(slug, customModes?)先查自定义模式再回退到内置模式getAllModes(customModes?)将自定义模式合并进内置模式同 slug 时以自定义配置覆盖内置定义getModeSelection(mode, promptComponent?, customModes?)确定最终生效的角色定义与指令规则是“自定义模式优先其次内置模式未命中则回退到默认模式”getToolsForMode(groups)把模式的groups展开为实际可用的工具名集合并统一并入始终可用工具。这套解析链保证了模式配置既灵活又可预测你覆盖了某个内置模式改动即刻生效你新增了一个模式它会被追加到模式列表尾部。创建自定义模式团队与工作流的专属化官方简介强调自定义模式可以“为你的团队或工作流创建专属模式”。在实现上自定义模式由 src/core/config/CustomModesManager.ts 统一管理支持全局与项目级两种来源全局模式存放在用户全局配置目录下的customModes.yaml文件名常量见 src/shared/globalFileNames.ts对所有项目生效项目模式存放在工作区根目录的.roomodes文件中随仓库共享给团队由 schemas/roomodes.json 提供 JSON Schema 校验支持。两者按 slug 合并项目模式优先源码见mergeCustomModes与getCustomModes位于 src/core/config/CustomModesManager.ts。管理器还会通过文件系统 watcher 监听这两个文件的增删改事件自动刷新模式状态无需重启扩展。一个自定义模式的典型 YAML 配置如下字段定义依据 packages/types/src/mode.ts 的modeConfigSchemacustomModes: - slug: security-review # 仅允许字母、数字与连字符 name: 安全评审 roleDefinition: 你是 Roo一名资深安全工程师专注于代码审计与漏洞分析。 whenToUse: 审查代码安全性、扫描常见漏洞时使用。 description: 专注代码安全审计 customInstructions: | 1. 优先使用 codebase_search 与 search_files 定位输入点与敏感操作。 2. 按 OWASP 分类输出发现并标注风险等级。 3. 不直接修改代码除非用户明确要求。 groups: - read - mcp字段含义与校验规则slug唯一标识正则约束为^[a-zA-Z0-9-]$name必填模式显示名称roleDefinition必填角色定义直接注入系统提示词决定 Agent 的行为人设whenToUse/description可选供 UI 展示与模式选择参考customInstructions可选追加到系统提示词中的专属指令groups必填允许的工具分组数组也支持元组写法为某组附加约束例如 Architect 模式使用的[edit, { fileRegex: \\.md$, description: 仅限 Markdown 文件 }]表示该模式下编辑工具只能作用于匹配正则的文件见 packages/types/src/mode.ts 的groupOptionsSchemasource可选标记global或project。模式配置在保存前会经过modeConfigSchema严格校验非法配置会被拒绝并给出错误提示见 src/core/config/CustomModesManager.ts。此外该管理器还提供了模式的导出/导入能力exportModeWithRules/importModeWithRules可以把模式连同其.roo/rules-{slug}/目录下的规则文件一起打包成 YAML 分享给团队导入时对相对路径做了防目录穿越校验。模式相关的更多官方用法可参阅 docs/docs/basic-usage 与 docs/docs/advanced-usage 目录下的文档。通过 MCP 扩展能力边界官方简介将“使用 MCP 服务器”列为 Roo Code 的核心能力之一。MCPModel Context Protocol允许 Agent 以标准化方式调用外部工具如数据库查询、API 服务、文件系统工具等或读取外部资源。在源码层MCP 的接入与生命周期由 src/services/mcp/McpHub.ts 与 src/services/mcp/McpServerManager.ts 负责用户在工作区.mcp.json或全局配置中声明的服务器会被动态加载。工具侧对应两个入口见 src/shared/tools.tsuse_mcp_tool调用某个 MCP 服务器上的工具参数为server_name、tool_name与argumentsaccess_mcp_resource读取 MCP 服务器暴露的资源参数为server_name与uri。由于mcp工具组被 Code、Architect、Ask、Debug 等内置模式默认包含接入 MCP 服务器后Agent 就能在现有工作流中直接调用这些外部能力而无需切换上下文。资源与使用须知官方文档完整的中文安装、配置与使用指南位于 docs/docs 目录从 docs/docs/index.mdx 开始阅读可获得最佳路径多语言版本本仓库为 README 提供了 17 种语言的翻译英文主文档见 README.md其余语言位于 locales 目录下如简体中文版 locales/zh-CN/README.md问题反馈可在项目仓库的 Issues 中报告缺陷并跟踪开发进展。免责声明需要特别说明的是Roo Code 官方对与产品相关的任何第三方工具、模型及其产出不作任何明示或暗示的担保这些工具均按“现状”AS IS与“可用”AS AVAILABLE原则提供。使用相关工具或产出的全部风险由使用者自行承担风险范围包括但不限于知识产权侵权、网络安全漏洞或攻击、偏见与不准确性、错误与缺陷、病毒、中断、财产损失以及人身伤害等。使用者须对自身使用行为的合法性、适当性与结果负全部责任。开源许可本项目采用 Apache 2.0 协议开源© 2025 Roo Code, Inc.完整许可文本见 LICENSE。小结Roo Code 通过“Modes”这一精巧设计把自然语言编程、代码重构与调试、文档生成、代码库问答、任务自动化以及 MCP 生态扩展统一进了编辑器内的工作流内置模式提供了开箱即用的角色分工自定义模式则允许你以 YAML 配置精确定制 Agent 的人设、指令与工具权限实现“团队级”的工作方式沉淀与共享。掌握其模式系统的配置与合并规则是充分驾驭这款工具、构建专属 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辅助生成（AIGC），仅供参考 Roo Code 功能与 Modes 模式体系全解：在编辑器内驾驭 AI 开发团队的实战指南
Roo Code 功能与 Modes 模式体系全解在编辑器内驾驭 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 开发团队”直接带进你的编辑器。本文以官方土耳其语 READMElocales/tr/README.md为骨架结合仓库源码深入讲解 Roo Code 的核心能力、内置 Modes模式体系与自定义模式的底层机制帮助你理解它是如何通过“模式”这一设计来适配不同开发场景并学会配置属于自己的工作流。Roo Code 能为你做什么根据官方简介Roo Code 面向开发者的核心能力可以归纳为以下七项从自然语言描述和规格说明生成代码直接以对话方式描述需求Roo 负责将其转化为可运行的实现。通过 Modes 适配工作方式内置 Code、Architect、Ask、Debug 等模式并可创建自定义模式让同一款工具在不同阶段扮演不同角色。重构与调试现有代码对既有代码库进行结构优化与缺陷修复。编写与更新文档自动产出并维护项目文档。回答关于代码库的问题基于工作区上下文进行问答分析。自动化重复性任务把高频、机械的工作交给 Agent 循环处理。使用 MCP 服务器通过 Model Context Protocol 接入外部工具与数据源扩展能力边界。从架构实现上看这些能力统一由 src/core/task/Task.ts 驱动的主 Agent 循环承载Agent 在“读取文件→搜索代码→执行命令→编辑文件→完成任务”之间循环推进直到把用户请求落地。你可以通过 apps/cli/docs/AGENT_LOOP.md 了解这一循环的完整描述。ModesRoo Code 的核心设计“Roo Code 适配你的工作方式而不是让你去适配它”是官方反复强调的设计理念。Modes模式本质上是一组预置的**角色定义role definition 工具权限tool groups**的组合切换到某个模式就等于让 Agent 换上一套专属的“人设”和“工具箱”。在源码层面每个内置模式的完整配置定义在 packages/types/src/mode.ts 的DEFAULT_MODES常量中包含slug唯一标识、name、roleDefinition角色定义、whenToUse适用场景、description描述、customInstructions自定义指令以及groups允许使用的工具分组等字段。内置模式一览官方简介列出了以下内置模式每种模式的能力边界都通过groups字段精确划定模式用途允许的工具分组源码依据Code代码日常编码、修改与文件操作read、edit、command、mcpArchitect架构师规划系统、规格说明与迁移方案read、edit仅限.md文件、mcpAsk提问快速解答、解释与文档生成read、mcpDebug调试追踪问题、添加日志、隔离根因read、edit、command、mcpCustom自定义为团队或特定工作流打造专属模式由你在配置文件中自行定义工具分组的具体构成定义在 src/shared/tools.tsreadread_file、search_files、list_files、codebase_search——只读类信息获取工具editapply_diff、write_to_file、generate_image以及edit、search_replace、apply_patch等可选自定义工具——文件修改类commandexecute_command、read_command_output——终端命令执行类mcpuse_mcp_tool、access_mcp_resource——MCP 服务器调用类modesswitch_mode、new_task——模式切换与任务委派该组标记为alwaysAvailable对所有模式始终开放。此外还有一组始终可用工具ALWAYS_AVAILABLE_TOOLS见 src/shared/tools.ts包括ask_followup_question追问澄清、attempt_completion任务收尾、switch_mode请求切换模式、new_task创建子任务、update_todo_list维护待办清单、run_slash_command运行斜杠命令和skill加载技能。这意味着无论身处哪个模式Agent 都保有基本的“沟通、收尾、转场”能力模式差异主要体现在对文件与命令等强副作用工具的授权上。值得注意的是DEFAULT_MODES中还定义了第六个内置模式Orchestrator协调者它的groups为空数组专注于通过new_task将复杂任务拆解委派给各专业模式再汇总结果——这正是官方 README 所述“整套 AI 开发团队”的组织形式可由 src/core/tools/NewTaskTool.ts 与 src/core/tools/SwitchModeTool.ts 等工具佐证。模式的解析与合并机制src/shared/modes.ts 提供了模式系统的运行时核心逻辑getModeBySlug(slug, customModes?)先查自定义模式再回退到内置模式getAllModes(customModes?)将自定义模式合并进内置模式同 slug 时以自定义配置覆盖内置定义getModeSelection(mode, promptComponent?, customModes?)确定最终生效的角色定义与指令规则是“自定义模式优先其次内置模式未命中则回退到默认模式”getToolsForMode(groups)把模式的groups展开为实际可用的工具名集合并统一并入始终可用工具。这套解析链保证了模式配置既灵活又可预测你覆盖了某个内置模式改动即刻生效你新增了一个模式它会被追加到模式列表尾部。创建自定义模式团队与工作流的专属化官方简介强调自定义模式可以“为你的团队或工作流创建专属模式”。在实现上自定义模式由 src/core/config/CustomModesManager.ts 统一管理支持全局与项目级两种来源全局模式存放在用户全局配置目录下的customModes.yaml文件名常量见 src/shared/globalFileNames.ts对所有项目生效项目模式存放在工作区根目录的.roomodes文件中随仓库共享给团队由 schemas/roomodes.json 提供 JSON Schema 校验支持。两者按 slug 合并项目模式优先源码见mergeCustomModes与getCustomModes位于 src/core/config/CustomModesManager.ts。管理器还会通过文件系统 watcher 监听这两个文件的增删改事件自动刷新模式状态无需重启扩展。一个自定义模式的典型 YAML 配置如下字段定义依据 packages/types/src/mode.ts 的modeConfigSchemacustomModes: - slug: security-review # 仅允许字母、数字与连字符 name: 安全评审 roleDefinition: 你是 Roo一名资深安全工程师专注于代码审计与漏洞分析。 whenToUse: 审查代码安全性、扫描常见漏洞时使用。 description: 专注代码安全审计 customInstructions: | 1. 优先使用 codebase_search 与 search_files 定位输入点与敏感操作。 2. 按 OWASP 分类输出发现并标注风险等级。 3. 不直接修改代码除非用户明确要求。 groups: - read - mcp字段含义与校验规则slug唯一标识正则约束为^[a-zA-Z0-9-]$name必填模式显示名称roleDefinition必填角色定义直接注入系统提示词决定 Agent 的行为人设whenToUse/description可选供 UI 展示与模式选择参考customInstructions可选追加到系统提示词中的专属指令groups必填允许的工具分组数组也支持元组写法为某组附加约束例如 Architect 模式使用的[edit, { fileRegex: \\.md$, description: 仅限 Markdown 文件 }]表示该模式下编辑工具只能作用于匹配正则的文件见 packages/types/src/mode.ts 的groupOptionsSchemasource可选标记global或project。模式配置在保存前会经过modeConfigSchema严格校验非法配置会被拒绝并给出错误提示见 src/core/config/CustomModesManager.ts。此外该管理器还提供了模式的导出/导入能力exportModeWithRules/importModeWithRules可以把模式连同其.roo/rules-{slug}/目录下的规则文件一起打包成 YAML 分享给团队导入时对相对路径做了防目录穿越校验。模式相关的更多官方用法可参阅 docs/docs/basic-usage 与 docs/docs/advanced-usage 目录下的文档。通过 MCP 扩展能力边界官方简介将“使用 MCP 服务器”列为 Roo Code 的核心能力之一。MCPModel Context Protocol允许 Agent 以标准化方式调用外部工具如数据库查询、API 服务、文件系统工具等或读取外部资源。在源码层MCP 的接入与生命周期由 src/services/mcp/McpHub.ts 与 src/services/mcp/McpServerManager.ts 负责用户在工作区.mcp.json或全局配置中声明的服务器会被动态加载。工具侧对应两个入口见 src/shared/tools.tsuse_mcp_tool调用某个 MCP 服务器上的工具参数为server_name、tool_name与argumentsaccess_mcp_resource读取 MCP 服务器暴露的资源参数为server_name与uri。由于mcp工具组被 Code、Architect、Ask、Debug 等内置模式默认包含接入 MCP 服务器后Agent 就能在现有工作流中直接调用这些外部能力而无需切换上下文。资源与使用须知官方文档完整的中文安装、配置与使用指南位于 docs/docs 目录从 docs/docs/index.mdx 开始阅读可获得最佳路径多语言版本本仓库为 README 提供了 17 种语言的翻译英文主文档见 README.md其余语言位于 locales 目录下如简体中文版 locales/zh-CN/README.md问题反馈可在项目仓库的 Issues 中报告缺陷并跟踪开发进展。免责声明需要特别说明的是Roo Code 官方对与产品相关的任何第三方工具、模型及其产出不作任何明示或暗示的担保这些工具均按“现状”AS IS与“可用”AS AVAILABLE原则提供。使用相关工具或产出的全部风险由使用者自行承担风险范围包括但不限于知识产权侵权、网络安全漏洞或攻击、偏见与不准确性、错误与缺陷、病毒、中断、财产损失以及人身伤害等。使用者须对自身使用行为的合法性、适当性与结果负全部责任。开源许可本项目采用 Apache 2.0 协议开源© 2025 Roo Code, Inc.完整许可文本见 LICENSE。小结Roo Code 通过“Modes”这一精巧设计把自然语言编程、代码重构与调试、文档生成、代码库问答、任务自动化以及 MCP 生态扩展统一进了编辑器内的工作流内置模式提供了开箱即用的角色分工自定义模式则允许你以 YAML 配置精确定制 Agent 的人设、指令与工具权限实现“团队级”的工作方式沉淀与共享。掌握其模式系统的配置与合并规则是充分驾驭这款工具、构建专属 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辅助生成（AIGC），仅供参考