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导读Roo Code 是一个运行在 VS Code 之内的 AI 编程助手扩展官方将其定位为你的 AI 驱动开发团队直接就在编辑器里Your AI-Powered Dev Team, Right in Your Editor。它通过自然语言交互覆盖从需求理解、方案设计、代码编写、调试修复到文档维护的完整研发链路。本文基于项目 README含荷兰语版 locales/nl/README.md 与英文版 README.md展开并结合仓库源码深入讲解其核心能力、内置模式Modes体系的实现原理、自定义模式配置方法以及 MCP 服务器集成方式帮助读者从会用进阶到会用得明白。Roo Code 能为你做什么Roo Code 的定位不是单一的代码补全工具而是一个可以在编辑器内完成完整开发工作流的 AI 代理。根据 README 的功能清单它的核心能力可以归纳为七个方面从自然语言生成代码直接描述需求和规格由 AI 代理生成对应的代码实现。通过模式Modes自适应工作方式内置 Code、Architect、Ask、Debug 四种模式并支持自定义模式。重构与调试现有代码在已有代码库上执行重构、排查缺陷。编写与更新文档生成 README、注释、接口说明等文档内容。回答代码库问题对项目结构、代码逻辑进行问答式解读。自动化重复性任务把频繁的手工操作沉淀为可自动执行的流程。使用 MCP 服务器通过 Model Context Protocol 接入外部工具与数据源。这些能力并非相互独立的营销词汇而是由仓库中的真实工具系统支撑的。在 src/shared/tools.ts 中可以看到为这些能力服务的工具分组Tool Groupread读文件、搜索文件、代码库检索、edit应用 diff、写文件、生成图片、command执行命令、读取命令输出、mcp调用 MCP 工具、访问 MCP 资源以及modes切换模式、创建子任务。模式系统正是通过组合这些工具分组来定义这个模式下 AI 能做什么的边界。模式Modes让 Roo Code 适应你的工作方式README 中强调的核心设计理念是Roo Code 适应你的工作方式而不是反过来Roo Code past zich aan jouw werkwijze aan。模式即一组预定义的角色定义roleDefinition、使用时机whenToUse、自定义指令customInstructions与工具权限groups的组合。当用户切换模式时系统 Prompt 中的角色设定、可用工具集合以及允许操作的文件范围都会随之改变。内置模式的完整定义位于 packages/types/src/mode.ts 的DEFAULT_MODES数组中模式解析与合并逻辑位于 src/shared/modes.ts。下面逐一说明四种核心内置模式。Code 模式日常编码Code 模式面向写、改、重构代码的日常场景。它的角色定义为一位精通多种编程语言、框架、设计模式和最佳实践的资深软件工程师工具组为[read, edit, command, mcp]即可以读文件、编辑文件、执行命令、调用 MCP 工具覆盖完整开发闭环。它的whenToUse明确说明适用于实现功能、修复缺陷、创建新文件以及跨语言框架的代码改进。Architect 模式先规划后实施Architect 模式聚焦实施之前的规划与设计。它的角色是经验丰富的技术负责人核心工作方式是先通过工具收集上下文 → 向用户提问澄清需求 → 将任务拆解为清晰的 todo 列表 → 使用switch_mode请求用户切换到其他模式去实施。从源码可以看到它的工具组配置非常特别groups: [read, [edit, { fileRegex: \\.md$, description: Markdown files only }], mcp]即 Architect 模式只能读取文件、调用 MCP而编辑权限被限制为只允许修改 Markdown 文件通过fileRegex正则\.md$约束。这从机制上保证了架构师只产出规划和文档不直接改动代码。其自定义指令还要求聚焦产出可执行的 todo 列表而非冗长文档为任务拆分提供足够清晰、可被其他模式独立执行的步骤不提供工时估算。Ask 模式提问与答疑Ask 模式是一个只读答疑模式角色为知识型技术助手工具组为[read, mcp]——只能读代码和访问 MCP 资源没有任何编辑与命令执行权限。它的自定义指令强调除非用户明确要求否则不切换到代码实现当图表有助于解释时允许输出 Mermaid 图。适合用来理解概念、分析已有代码、获取技术建议而不产生任何副作用。Debug 模式系统性排查问题Debug 模式面向问题诊断角色为系统化问题诊断与解决的调试专家。它的工具组与 Code 模式相同[read, edit, command, mcp]但其工作方法在自定义指令中得到了强约束先反思 5–7 个可能导致问题的原因筛选出最可能的 1–2 个然后添加日志验证假设在修复之前必须显式请求用户确认诊断结果。这种先假设、后验证、再修复、修复前确认的流程正是 README 所述追踪问题、添加日志、隔离根因能力的机制保障。模式系统的底层实现除了四个文档明确列出的模式仓库中还定义了第五个内置模式orchestrator任务编排者用于把复杂任务拆解为子任务并委托给合适的专业模式执行其工具组为空数组[]完全依靠new_task、attempt_completion等通用工具完成协作。所有模式的解析逻辑集中在 src/shared/modes.ts关键函数包括getToolsForMode(groups)根据模式的工具组展开其实际可用的工具集合并把ALWAYS_AVAILABLE_TOOLSask_followup_question、attempt_completion、switch_mode、new_task、update_todo_list、run_slash_command、skill无条件并入。getModeBySlug(slug, customModes)查找模式时自定义模式优先其次才回退到内置模式。getAllModes(customModes)返回全部模式自定义模式按 slug 覆盖或追加内置模式。getModeSelection(...)当存在自定义模式时整体采用自定义配置否则以内置模式为基础用promptComponent的roleDefinition、customInstructions进行合并。自定义模式Aangepaste Modi为团队打造专属模式README 将构建面向团队或工作流的专业化模式列为模式体系的重要能力。自定义模式通过两类配置文件定义其完整 JSON Schema 位于 schemas/roomodes.json类型定义与校验逻辑位于 packages/types/src/mode.ts 的modeConfigSchema。配置字段说明字段是否必填说明slug是模式唯一标识正则约束为^[a-zA-Z0-9-]$仅字母、数字、连字符name是模式显示名称长度至少 1roleDefinition是角色定义注入系统 Prompt 以塑造 AI 行为whenToUse否描述该模式适合何时使用供模型判断description否模式描述展示在模式选择界面customInstructions否追加到系统 Prompt 的自定义指令groups是工具组数组决定模式可用的工具集合source否模式来源global全局或project项目级其中groups支持两种写法直接写分组名如read或以元组形式附加文件限制如[edit, { fileRegex: \\.md$, description: Markdown files only }]。fileRegex会通过FileRestrictionError定义于 src/shared/modes.ts在模式尝试越界编辑文件时抛出明确错误信息。当配置中出现重复 slug 或重复工具组时schema 校验会直接拒绝。.roomodes 与全局配置的作用域自定义模式可以存放在两个位置由 src/core/config/CustomModesManager.ts 统一管理全局配置位于 Roo 全局设置目录下的custom_modes.yaml对所有项目生效。项目级配置位于工作区根目录的.roomodes文件随项目走便于团队共享。两者的优先级规则在mergeCustomModes中实现项目级模式优先当 slug 冲突时以.roomodes中的定义为准全局模式下新增的模式再追加其后。管理器通过createFileSystemWatcher监听两个文件的变更、创建与删除事件实现热更新读取到的模式会合并写入globalState并缓存 10 秒cacheTTL 10_000。此外解析 YAML 时还做了容错处理自动清除零宽字符、智能引号、各种连字符等隐形或易错字符YAML 解析失败时对.roomodes回退尝试 JSON 解析。一个典型的.roomodes配置示例customModes: - slug: security-review name: Security Reviewer roleDefinition: You are Roo, a security expert who reviews code for vulnerabilities. whenToUse: Use this mode when reviewing code for security issues. description: Review code for security vulnerabilities customInstructions: | Focus on common vulnerability classes such as injection, XSS, and insecure deserialization. Report findings with file paths and line numbers. groups: - read - [edit, { fileRegex: \\.md$, description: Reports only }]通过 MCP 服务器扩展能力MCPModel Context Protocol是 Roo Code 接入外部工具与数据源的标准方式对应 README 中的利用 MCP 服务器能力。在模式工具组中加入mcp分组即可获得use_mcp_tool调用 MCP 工具与access_mcp_resource访问 MCP 资源两项能力。MCP 的客户端实现位于 src/services/mcp/McpHub.ts从源码看它基于官方modelcontextprotocol/sdk支持三种传输协议stdio通过command、args、env配置本地进程型服务器如npx、uvx启动的本地服务。sse通过url与可选的headers连接基于 Server-Sent Events 的远程服务器。streamable-http通过url与可选headers连接流式 HTTP 服务器。每个服务器的通用配置字段包括disabled禁用开关、timeout超时秒数1–3600默认 60、alwaysAllow始终允许的工具白名单、disabledTools禁用的工具列表以及watchPaths监听路径变化时自动重启服务器。源码中的校验逻辑还会在 stdio 与 sse/streamable-http 字段混用时给出明确的错误提示。连接状态被建模为ConnectedMcpConnection与DisconnectedMcpConnection的判别联合类型便于界面呈现与重连管理。资源与许可Roo Code 的官方使用文档涵盖了安装、配置与进阶用法如自定义模式、模式切换的完整说明可在仓库的 apps/docs/docs 目录中查阅 Markdown 源文件遇到缺陷或希望跟踪开发进展可通过仓库的 Issues 反馈。项目采用 Apache 2.0 许可证发布© 2025 Roo Code, Inc.。需要说明的是官方对扩展及其关联第三方工具、模型产生的任何输出不作担保工具按原样AS IS和可用AS AVAILABLE提供使用过程中可能涉及知识产权侵权、网络安全漏洞、模型偏见、输出不准确、缺陷或病毒等风险使用者需自行承担全部责任并对其使用的合法性、适当性与结果负全责。这一免责声明详见 locales/nl/README.md 的 Disclaimer 小节。小结Roo Code 的核心设计可以概括为一句话用角色模式 工具权限分组 外部能力MCP三个维度把通用的 AI 编码助手塑造成贴合个人或团队工作流的开发团队。理解内置模式的分工Architect 规划、Code 实施、Ask 答疑、Debug 排障、Orchestrator 编排掌握.roomodes自定义模式的字段语义与作用域优先级再配合 MCP 服务器接入外部工具就能把这套体系真正用于日常研发流程。本文涉及的关键实现文件src/shared/modes.ts、packages/types/src/mode.ts、src/core/config/CustomModesManager.ts、src/shared/tools.ts、schemas/roomodes.json、src/services/mcp/McpHub.ts均可直接在仓库中继续深入阅读。【免费下载链接】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 开发团队（模式系统与 MCP 集成详解）
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导读Roo Code 是一个运行在 VS Code 之内的 AI 编程助手扩展官方将其定位为你的 AI 驱动开发团队直接就在编辑器里Your AI-Powered Dev Team, Right in Your Editor。它通过自然语言交互覆盖从需求理解、方案设计、代码编写、调试修复到文档维护的完整研发链路。本文基于项目 README含荷兰语版 locales/nl/README.md 与英文版 README.md展开并结合仓库源码深入讲解其核心能力、内置模式Modes体系的实现原理、自定义模式配置方法以及 MCP 服务器集成方式帮助读者从会用进阶到会用得明白。Roo Code 能为你做什么Roo Code 的定位不是单一的代码补全工具而是一个可以在编辑器内完成完整开发工作流的 AI 代理。根据 README 的功能清单它的核心能力可以归纳为七个方面从自然语言生成代码直接描述需求和规格由 AI 代理生成对应的代码实现。通过模式Modes自适应工作方式内置 Code、Architect、Ask、Debug 四种模式并支持自定义模式。重构与调试现有代码在已有代码库上执行重构、排查缺陷。编写与更新文档生成 README、注释、接口说明等文档内容。回答代码库问题对项目结构、代码逻辑进行问答式解读。自动化重复性任务把频繁的手工操作沉淀为可自动执行的流程。使用 MCP 服务器通过 Model Context Protocol 接入外部工具与数据源。这些能力并非相互独立的营销词汇而是由仓库中的真实工具系统支撑的。在 src/shared/tools.ts 中可以看到为这些能力服务的工具分组Tool Groupread读文件、搜索文件、代码库检索、edit应用 diff、写文件、生成图片、command执行命令、读取命令输出、mcp调用 MCP 工具、访问 MCP 资源以及modes切换模式、创建子任务。模式系统正是通过组合这些工具分组来定义这个模式下 AI 能做什么的边界。模式Modes让 Roo Code 适应你的工作方式README 中强调的核心设计理念是Roo Code 适应你的工作方式而不是反过来Roo Code past zich aan jouw werkwijze aan。模式即一组预定义的角色定义roleDefinition、使用时机whenToUse、自定义指令customInstructions与工具权限groups的组合。当用户切换模式时系统 Prompt 中的角色设定、可用工具集合以及允许操作的文件范围都会随之改变。内置模式的完整定义位于 packages/types/src/mode.ts 的DEFAULT_MODES数组中模式解析与合并逻辑位于 src/shared/modes.ts。下面逐一说明四种核心内置模式。Code 模式日常编码Code 模式面向写、改、重构代码的日常场景。它的角色定义为一位精通多种编程语言、框架、设计模式和最佳实践的资深软件工程师工具组为[read, edit, command, mcp]即可以读文件、编辑文件、执行命令、调用 MCP 工具覆盖完整开发闭环。它的whenToUse明确说明适用于实现功能、修复缺陷、创建新文件以及跨语言框架的代码改进。Architect 模式先规划后实施Architect 模式聚焦实施之前的规划与设计。它的角色是经验丰富的技术负责人核心工作方式是先通过工具收集上下文 → 向用户提问澄清需求 → 将任务拆解为清晰的 todo 列表 → 使用switch_mode请求用户切换到其他模式去实施。从源码可以看到它的工具组配置非常特别groups: [read, [edit, { fileRegex: \\.md$, description: Markdown files only }], mcp]即 Architect 模式只能读取文件、调用 MCP而编辑权限被限制为只允许修改 Markdown 文件通过fileRegex正则\.md$约束。这从机制上保证了架构师只产出规划和文档不直接改动代码。其自定义指令还要求聚焦产出可执行的 todo 列表而非冗长文档为任务拆分提供足够清晰、可被其他模式独立执行的步骤不提供工时估算。Ask 模式提问与答疑Ask 模式是一个只读答疑模式角色为知识型技术助手工具组为[read, mcp]——只能读代码和访问 MCP 资源没有任何编辑与命令执行权限。它的自定义指令强调除非用户明确要求否则不切换到代码实现当图表有助于解释时允许输出 Mermaid 图。适合用来理解概念、分析已有代码、获取技术建议而不产生任何副作用。Debug 模式系统性排查问题Debug 模式面向问题诊断角色为系统化问题诊断与解决的调试专家。它的工具组与 Code 模式相同[read, edit, command, mcp]但其工作方法在自定义指令中得到了强约束先反思 5–7 个可能导致问题的原因筛选出最可能的 1–2 个然后添加日志验证假设在修复之前必须显式请求用户确认诊断结果。这种先假设、后验证、再修复、修复前确认的流程正是 README 所述追踪问题、添加日志、隔离根因能力的机制保障。模式系统的底层实现除了四个文档明确列出的模式仓库中还定义了第五个内置模式orchestrator任务编排者用于把复杂任务拆解为子任务并委托给合适的专业模式执行其工具组为空数组[]完全依靠new_task、attempt_completion等通用工具完成协作。所有模式的解析逻辑集中在 src/shared/modes.ts关键函数包括getToolsForMode(groups)根据模式的工具组展开其实际可用的工具集合并把ALWAYS_AVAILABLE_TOOLSask_followup_question、attempt_completion、switch_mode、new_task、update_todo_list、run_slash_command、skill无条件并入。getModeBySlug(slug, customModes)查找模式时自定义模式优先其次才回退到内置模式。getAllModes(customModes)返回全部模式自定义模式按 slug 覆盖或追加内置模式。getModeSelection(...)当存在自定义模式时整体采用自定义配置否则以内置模式为基础用promptComponent的roleDefinition、customInstructions进行合并。自定义模式Aangepaste Modi为团队打造专属模式README 将构建面向团队或工作流的专业化模式列为模式体系的重要能力。自定义模式通过两类配置文件定义其完整 JSON Schema 位于 schemas/roomodes.json类型定义与校验逻辑位于 packages/types/src/mode.ts 的modeConfigSchema。配置字段说明字段是否必填说明slug是模式唯一标识正则约束为^[a-zA-Z0-9-]$仅字母、数字、连字符name是模式显示名称长度至少 1roleDefinition是角色定义注入系统 Prompt 以塑造 AI 行为whenToUse否描述该模式适合何时使用供模型判断description否模式描述展示在模式选择界面customInstructions否追加到系统 Prompt 的自定义指令groups是工具组数组决定模式可用的工具集合source否模式来源global全局或project项目级其中groups支持两种写法直接写分组名如read或以元组形式附加文件限制如[edit, { fileRegex: \\.md$, description: Markdown files only }]。fileRegex会通过FileRestrictionError定义于 src/shared/modes.ts在模式尝试越界编辑文件时抛出明确错误信息。当配置中出现重复 slug 或重复工具组时schema 校验会直接拒绝。.roomodes 与全局配置的作用域自定义模式可以存放在两个位置由 src/core/config/CustomModesManager.ts 统一管理全局配置位于 Roo 全局设置目录下的custom_modes.yaml对所有项目生效。项目级配置位于工作区根目录的.roomodes文件随项目走便于团队共享。两者的优先级规则在mergeCustomModes中实现项目级模式优先当 slug 冲突时以.roomodes中的定义为准全局模式下新增的模式再追加其后。管理器通过createFileSystemWatcher监听两个文件的变更、创建与删除事件实现热更新读取到的模式会合并写入globalState并缓存 10 秒cacheTTL 10_000。此外解析 YAML 时还做了容错处理自动清除零宽字符、智能引号、各种连字符等隐形或易错字符YAML 解析失败时对.roomodes回退尝试 JSON 解析。一个典型的.roomodes配置示例customModes: - slug: security-review name: Security Reviewer roleDefinition: You are Roo, a security expert who reviews code for vulnerabilities. whenToUse: Use this mode when reviewing code for security issues. description: Review code for security vulnerabilities customInstructions: | Focus on common vulnerability classes such as injection, XSS, and insecure deserialization. Report findings with file paths and line numbers. groups: - read - [edit, { fileRegex: \\.md$, description: Reports only }]通过 MCP 服务器扩展能力MCPModel Context Protocol是 Roo Code 接入外部工具与数据源的标准方式对应 README 中的利用 MCP 服务器能力。在模式工具组中加入mcp分组即可获得use_mcp_tool调用 MCP 工具与access_mcp_resource访问 MCP 资源两项能力。MCP 的客户端实现位于 src/services/mcp/McpHub.ts从源码看它基于官方modelcontextprotocol/sdk支持三种传输协议stdio通过command、args、env配置本地进程型服务器如npx、uvx启动的本地服务。sse通过url与可选的headers连接基于 Server-Sent Events 的远程服务器。streamable-http通过url与可选headers连接流式 HTTP 服务器。每个服务器的通用配置字段包括disabled禁用开关、timeout超时秒数1–3600默认 60、alwaysAllow始终允许的工具白名单、disabledTools禁用的工具列表以及watchPaths监听路径变化时自动重启服务器。源码中的校验逻辑还会在 stdio 与 sse/streamable-http 字段混用时给出明确的错误提示。连接状态被建模为ConnectedMcpConnection与DisconnectedMcpConnection的判别联合类型便于界面呈现与重连管理。资源与许可Roo Code 的官方使用文档涵盖了安装、配置与进阶用法如自定义模式、模式切换的完整说明可在仓库的 apps/docs/docs 目录中查阅 Markdown 源文件遇到缺陷或希望跟踪开发进展可通过仓库的 Issues 反馈。项目采用 Apache 2.0 许可证发布© 2025 Roo Code, Inc.。需要说明的是官方对扩展及其关联第三方工具、模型产生的任何输出不作担保工具按原样AS IS和可用AS AVAILABLE提供使用过程中可能涉及知识产权侵权、网络安全漏洞、模型偏见、输出不准确、缺陷或病毒等风险使用者需自行承担全部责任并对其使用的合法性、适当性与结果负全责。这一免责声明详见 locales/nl/README.md 的 Disclaimer 小节。小结Roo Code 的核心设计可以概括为一句话用角色模式 工具权限分组 外部能力MCP三个维度把通用的 AI 编码助手塑造成贴合个人或团队工作流的开发团队。理解内置模式的分工Architect 规划、Code 实施、Ask 答疑、Debug 排障、Orchestrator 编排掌握.roomodes自定义模式的字段语义与作用域优先级再配合 MCP 服务器接入外部工具就能把这套体系真正用于日常研发流程。本文涉及的关键实现文件src/shared/modes.ts、packages/types/src/mode.ts、src/core/config/CustomModesManager.ts、src/shared/tools.ts、schemas/roomodes.json、src/services/mcp/McpHub.ts均可直接在仓库中继续深入阅读。【免费下载链接】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），仅供参考