之前写了一篇VSCodeRooCode搭建的文章最近越用越多感觉真的很好用的。。。看到其实可以在还有很多高级用法提升效率。所以详细记录一下。官方的网址是https://github.com/RooCodeInc/Roo-Code首先是五种模式Code Mode: everyday coding, edits, and file opsArchitect Mode: plan systems, specs, and migrationsAsk Mode: fast answers, explanations, and docsDebug Mode: trace issues, add logs, isolate root causesCustom Modes: build specialized modes for your team or workflow一般来说最常用的就是Code然后Debug问问题就是Ask。Architect感觉过于强大了。。。1 规则文件如果你是在 Windows VS Code Roo CodeRooCode Agent 环境下想给 AI 配置统一规则Rules MD目前官方推荐的方式是使用 .roo/rules/ 目录而不是老的 .roorules 文件。(Roocode)在Windows中就是C:\Users\用户名\.roo\rules\这里创建了一个test.txt之后就可以直接生效之后就显示了它的全局规则。1. 自定义模式Custom Modes—— 核心的全局规格Roo Code 允许你定义全局的自定义模式规格主要通过以下文件文件作用域说明.roomodes工作区级别放在项目根目录随项目共享.vscode/roomodes.json工作区设置VS Code 工作区设置全局roomodes.json用户全局用户级别的全局模式定义.roomodes文件格式示例{ customModes: [ { slug: my-custom-mode, name: 我的自定义模式, roleDefinition: 你是一个专门处理 X 任务的助手..., groups: [ read, edit, command, mcp ], fileRegex: .*\\.(py|md)$ } ] }关键字段说明slug— 模式的唯一标识符roleDefinition— 模式的角色定义系统提示词groups— 权限组read读文件、edit编辑文件、command执行命令、mcpMCP 操作、browser浏览器fileRegex— 可编辑的文件匹配模式2. 规则文件Rules—— 全局指令加载你已经在使用的..\.roo\rules\test.txt就是规则加载的体现。规则文件的加载优先级如下.roo/rules/ (项目级规则) .roo/rules-debug/ (调试模式规则) .vscode/roomodes.json (工作区设置) 用户全局设置规则文件的内容会被注入到每次对话的系统提示中成为全局规格的一部分。3. 实现自定义配置的步骤创建 .roomodes 文件定义 customModes 数组设置 slug / name / roleDefinition配置 groups 权限组设置 fileRegex 编辑范围重启 Roo Code 生效或者通过规则文件加载全局指令.roo/ ├── rules/ # 项目全局规则 │ ├── test.txt # ← 你已经有的规则 │ ├── always.txt # 始终加载的规则 │ └── security.txt # 安全相关规则 ├── rules-debug/ # 调试模式专用规则 └── modes.json # 模式定义核心结论全局规格 规则文件 (.roo/rules/) 自定义模式 (.roomodes)规则文件通过目录约定自动加载到系统提示中自定义模式通过.roomodes或roomodes.json定义2 使用的命令主要是 to add context, / for commands, hold shift to drag in files)1.— 添加上下文Context在输入框中输入可以引用文件或文件夹作为上下文传递给 Roo。例如输入效果neo_la.dts引用该文件内容作为上下文build.log.txt引用构建日志plans/引用整个 plans 目录Roo 会自动读取这些文件内容无需手动复制粘贴。Roo Code 可以读取 PDF 文件并提取其中的文本内容。2./— 执行命令输入/可以快速切换模式或执行预设命令命令效果/architect切换到架构师模式/code切换到代码模式/ask切换到问答模式当前模式/debug切换到调试模式3.Shift 拖拽文件— 快速引用文件按住Shift键从 VS Code 文件树或系统文件管理器中拖拽文件到聊天输入框可以快速添加文件引用效果等同于用引用文件。1. 全局规则所有项目生效Windows路径C:\Users\用户名\.roo\rules\例如C:\Users\Tom\.roo\ └── rules\ ├── 01-general.md ├── 02-coding-style.md └── 03-android-bsp.mdRoo会自动读取这里所有 md/txt 文件。(Roocode)例如03-android-bsp.md# Android BSP Rules You are a senior Qualcomm BSP engineer. Requirements: 1. Always analyze logs before suggesting code changes. 2. Explain call flow first. 3. When discussing DTS, show complete node examples. 4. Prefer AOSP official solutions. 5. Explain Qualcomm-specific terms. 6. Use diagrams when architecture is complex.2. 项目规则推荐假设你的工程D:\AR1_Project\创建D:\AR1_Project\ └── .roo\ └── rules\ ├── 01-project.md └── 02-build.md例如01-project.md# Project Context Platform: - Qualcomm AR1 Android: - Android 15 Kernel: - 6.6 Requirements: 1. All code examples should use this platform. 2. Prefer DTS modifications. 3. Explain build impact. 4. Consider power consumption.这样打开这个工程时VSCode ↓ Roo ↓ 自动加载规则不需要每次重复说。项目规则优先级高于全局规则。(Roocode)3. Mode专用规则如果只希望在 Code 模式生效.roo/ └── rules-code/ └── 01-cpp.md例如# C Rules 1. Use C17. 2. Avoid raw pointers. 3. Prefer std::unique_ptr. 4. Add comments for public APIs.Roo支持rules-code rules-debug rules-architect以及自定义 mode。(Roocode)4. Android BSP工程推荐规则如果你现在主要做高通 Android BSP我建议直接建一个.roo/rules/里面放01-role.mdYou are a Qualcomm Android BSP architect. Explain problems from: - Hardware - Bootloader - Kernel - HAL - Framework perspective.02-debug.mdFor bug analysis: 1. Request logs first. 2. Explain root cause. 3. Show debugging path. 4. Show verification method.03-build.mdFor build issues: 1. Explain dependency chain. 2. Explain Android.bp. 3. Explain Soong. 4. Explain Makefile.04-english.mdWhen English is used: 1. Correct grammar first. 2. Then answer technical question. 3. Explain common meeting expressions.这其实非常适合你目前的工作习惯5. 一个我比较推荐的个人规则# Response Style For technical questions: 1. Give short answer first. 2. Then detailed explanation. 3. Then real project example. 4. Then debugging commands. For Qualcomm BSP: Always include: - Location of source code - DTS path - Build command - Verification method这样 Roo 回答问题时会更像一个 BSP 老工程师而不是泛泛而谈的 AI。另外从 2025 年之后 Roo 官方已经明确推荐使用.roo/rules/*.md而不是.roorules .clinerules .cursorrules这些旧方式要么是兼容模式要么已经逐步被替代。(Roocode)如果你有 10~20 个PDFAudio、Camera、PMIC、Boot、DTS 等我甚至建议用一个脚本自动把它们转换成 Markdown然后生成一个knowledge_index.md。这样 DeepSeek 在 AR1 Bringup 场景下的回答质量会明显提高。3 MCP Servers
嵌入式开发Agent的搭建2--RooCode（TODO）
之前写了一篇VSCodeRooCode搭建的文章最近越用越多感觉真的很好用的。。。看到其实可以在还有很多高级用法提升效率。所以详细记录一下。官方的网址是https://github.com/RooCodeInc/Roo-Code首先是五种模式Code Mode: everyday coding, edits, and file opsArchitect Mode: plan systems, specs, and migrationsAsk Mode: fast answers, explanations, and docsDebug Mode: trace issues, add logs, isolate root causesCustom Modes: build specialized modes for your team or workflow一般来说最常用的就是Code然后Debug问问题就是Ask。Architect感觉过于强大了。。。1 规则文件如果你是在 Windows VS Code Roo CodeRooCode Agent 环境下想给 AI 配置统一规则Rules MD目前官方推荐的方式是使用 .roo/rules/ 目录而不是老的 .roorules 文件。(Roocode)在Windows中就是C:\Users\用户名\.roo\rules\这里创建了一个test.txt之后就可以直接生效之后就显示了它的全局规则。1. 自定义模式Custom Modes—— 核心的全局规格Roo Code 允许你定义全局的自定义模式规格主要通过以下文件文件作用域说明.roomodes工作区级别放在项目根目录随项目共享.vscode/roomodes.json工作区设置VS Code 工作区设置全局roomodes.json用户全局用户级别的全局模式定义.roomodes文件格式示例{ customModes: [ { slug: my-custom-mode, name: 我的自定义模式, roleDefinition: 你是一个专门处理 X 任务的助手..., groups: [ read, edit, command, mcp ], fileRegex: .*\\.(py|md)$ } ] }关键字段说明slug— 模式的唯一标识符roleDefinition— 模式的角色定义系统提示词groups— 权限组read读文件、edit编辑文件、command执行命令、mcpMCP 操作、browser浏览器fileRegex— 可编辑的文件匹配模式2. 规则文件Rules—— 全局指令加载你已经在使用的..\.roo\rules\test.txt就是规则加载的体现。规则文件的加载优先级如下.roo/rules/ (项目级规则) .roo/rules-debug/ (调试模式规则) .vscode/roomodes.json (工作区设置) 用户全局设置规则文件的内容会被注入到每次对话的系统提示中成为全局规格的一部分。3. 实现自定义配置的步骤创建 .roomodes 文件定义 customModes 数组设置 slug / name / roleDefinition配置 groups 权限组设置 fileRegex 编辑范围重启 Roo Code 生效或者通过规则文件加载全局指令.roo/ ├── rules/ # 项目全局规则 │ ├── test.txt # ← 你已经有的规则 │ ├── always.txt # 始终加载的规则 │ └── security.txt # 安全相关规则 ├── rules-debug/ # 调试模式专用规则 └── modes.json # 模式定义核心结论全局规格 规则文件 (.roo/rules/) 自定义模式 (.roomodes)规则文件通过目录约定自动加载到系统提示中自定义模式通过.roomodes或roomodes.json定义2 使用的命令主要是 to add context, / for commands, hold shift to drag in files)1.— 添加上下文Context在输入框中输入可以引用文件或文件夹作为上下文传递给 Roo。例如输入效果neo_la.dts引用该文件内容作为上下文build.log.txt引用构建日志plans/引用整个 plans 目录Roo 会自动读取这些文件内容无需手动复制粘贴。Roo Code 可以读取 PDF 文件并提取其中的文本内容。2./— 执行命令输入/可以快速切换模式或执行预设命令命令效果/architect切换到架构师模式/code切换到代码模式/ask切换到问答模式当前模式/debug切换到调试模式3.Shift 拖拽文件— 快速引用文件按住Shift键从 VS Code 文件树或系统文件管理器中拖拽文件到聊天输入框可以快速添加文件引用效果等同于用引用文件。1. 全局规则所有项目生效Windows路径C:\Users\用户名\.roo\rules\例如C:\Users\Tom\.roo\ └── rules\ ├── 01-general.md ├── 02-coding-style.md └── 03-android-bsp.mdRoo会自动读取这里所有 md/txt 文件。(Roocode)例如03-android-bsp.md# Android BSP Rules You are a senior Qualcomm BSP engineer. Requirements: 1. Always analyze logs before suggesting code changes. 2. Explain call flow first. 3. When discussing DTS, show complete node examples. 4. Prefer AOSP official solutions. 5. Explain Qualcomm-specific terms. 6. Use diagrams when architecture is complex.2. 项目规则推荐假设你的工程D:\AR1_Project\创建D:\AR1_Project\ └── .roo\ └── rules\ ├── 01-project.md └── 02-build.md例如01-project.md# Project Context Platform: - Qualcomm AR1 Android: - Android 15 Kernel: - 6.6 Requirements: 1. All code examples should use this platform. 2. Prefer DTS modifications. 3. Explain build impact. 4. Consider power consumption.这样打开这个工程时VSCode ↓ Roo ↓ 自动加载规则不需要每次重复说。项目规则优先级高于全局规则。(Roocode)3. Mode专用规则如果只希望在 Code 模式生效.roo/ └── rules-code/ └── 01-cpp.md例如# C Rules 1. Use C17. 2. Avoid raw pointers. 3. Prefer std::unique_ptr. 4. Add comments for public APIs.Roo支持rules-code rules-debug rules-architect以及自定义 mode。(Roocode)4. Android BSP工程推荐规则如果你现在主要做高通 Android BSP我建议直接建一个.roo/rules/里面放01-role.mdYou are a Qualcomm Android BSP architect. Explain problems from: - Hardware - Bootloader - Kernel - HAL - Framework perspective.02-debug.mdFor bug analysis: 1. Request logs first. 2. Explain root cause. 3. Show debugging path. 4. Show verification method.03-build.mdFor build issues: 1. Explain dependency chain. 2. Explain Android.bp. 3. Explain Soong. 4. Explain Makefile.04-english.mdWhen English is used: 1. Correct grammar first. 2. Then answer technical question. 3. Explain common meeting expressions.这其实非常适合你目前的工作习惯5. 一个我比较推荐的个人规则# Response Style For technical questions: 1. Give short answer first. 2. Then detailed explanation. 3. Then real project example. 4. Then debugging commands. For Qualcomm BSP: Always include: - Location of source code - DTS path - Build command - Verification method这样 Roo 回答问题时会更像一个 BSP 老工程师而不是泛泛而谈的 AI。另外从 2025 年之后 Roo 官方已经明确推荐使用.roo/rules/*.md而不是.roorules .clinerules .cursorrules这些旧方式要么是兼容模式要么已经逐步被替代。(Roocode)如果你有 10~20 个PDFAudio、Camera、PMIC、Boot、DTS 等我甚至建议用一个脚本自动把它们转换成 Markdown然后生成一个knowledge_index.md。这样 DeepSeek 在 AR1 Bringup 场景下的回答质量会明显提高。3 MCP Servers
