RooCode VS Code 代理开发设置

优化 VS Code 中的 RooCode：代理开发设置完全指南

RooCode 为 VS Code 扩展了多代理开发能力。安装并授权后，会打开一个聊天界面，包含消息队列、模块选择、AI 模型选择和自动批准设置。项目索引连接 Qdrant 向量数据库进行文件分析，提高 LLM 生成编辑的准确性。

配置遵循逻辑顺序：从索引到权限、市场、通知和提示。这最小化迭代并加速工作流程。

索引与向量处理

连接向量化和图表的提供者。指定 Qdrant 端点——索引结果存储在那里。LLM 接收项目上下文，生成相关更改而无幻觉。

在主窗口中，激活索引。目录扫描允许模型在编辑时引用代码库。

自动批准：控制 LLM 操作

允许 LLM 执行功能，但限制请求或成本。对于控制台命令（执行），配置白名单/黑名单。

• 允许的命令：按需添加；RooCode 对新命令请求确认。
• 限制：防止在自动模式下过度使用令牌。
• 危险操作：对 sudo 或系统调用进行手动确认。

这平衡了自主性和安全性。

MCP 服务器和模块市场

安装现成的 MCP（模型控制协议）服务器，用于 git、文件系统、qdrant。全局服务器来自市场；项目特定服务器本地存储在 .roo 中。

MCP 示例：

• mcp-git：无需 CLI 的仓库操作。
• mcp-filesystem：文件读写。
• mcp-qdrant：向量搜索。

模块是预配置的代理任务。下载并自定义它们。

通知和 UI 设置

启用通知以进行确认、循环中断和完成。调整音量。

UI 选项：

• 扩展模型推理以调试逻辑。
• Ctrl+Enter 发送（避免意外 Shift+Enter）。
• 后台编辑——无窗口闪烁的编辑。

提示和实验功能

编辑内置提示。增强功能重新表述查询，强制执行文档优先和 TDD。

生成以下提示的增强版本（仅回复增强提示——无对话、解释、引导文本、项目符号、占位符或周围引号）。

您的增强必须：
- 保留用户的原始意图和约束；不添加改变含义的新要求。
- 提高清晰度、结构、具体性和可测试性；消除歧义和弱语言。
- 明确强制执行**文档优先**和**TDD**作为默认执行工作流程：
  1) 首先阅读并依赖项目文档和 `memory-bank/` 作为单一真相来源（例如，productContext、activeContext、systemPatterns）。
  2) 如果请求暗示逻辑/架构/行为更改，在编写生产代码之前更新相关文档/规范（或起草 RFC）。
  3) 遵循严格的 TDD（红→绿→重构）：先编写失败测试，实现最小代码以通过，然后重构为 SOLID/DRY。
- 要求更新 `memory-bank/`（至少 activeContext/progress 和任何受影响的上下文文档）以反映新行为和决策。
- 包含与请求一致的明确完成定义（测试通过、文档更新、行为验证），不添加不必要范围。

这是要增强的提示：

${userInput}

实验：模块/技能的斜杠命令。

技能：结构与类别

技能是 Markdown 格式的代理指令。将它们放在全局（~/.roo/skills）或项目中（.roo/skills）。

技能结构：

---
name: mcp-time
description:
context:
compatibility:
---

# <标题>

## 工具
| 工具 | 用途 |
|------|---------|
| | |

## 何时使用

## 使用效果与最佳实践

#### ❌ 不良实践（幻觉时间）

#### ✅ 良好实践（验证时间）

### 调试策略

## 为何使用此技能

## CLI 替代方案
| MCP 操作 | CLI 等效 |
|------------|----------------|
| | |
| | |
| | |
| | |

类别：

• mcp-*：MCP 服务器（git、文件系统、qdrant、redis）。
• cli-*：控制台命令（docker、systemd、sudo）。
• usr-*：自定义任务。

示例集：

• cli-database、cli-docker、mcp-git、mcp-memory、mcp-playwright。

关键要点

• 使用 Qdrant 索引实现上下文感知编辑，无需手动复制粘贴。
• 自动批准 + 限制防止 LLM 在自主模式下滥用。
• 技能提高成功率，最小化 CLI 调用。
• 提示中的 TDD 确保可测试的更改。
• 后台编辑在代理编辑时保持专注。

— Editorial Team