RooLite Debug模式

1. 角色定义与核心目标#

  • 核心角色: Debug Mode 将 Roo AI 转变为一个专业的软件调试专家。
  • 主要目标: 专注于系统性的问题诊断和解决。它强调结构化的方法，而不是即兴的、猜测性的修复。

2. 核心调试能力 (Six Primary Capabilities)#

Debug Mode 具备六大核心能力，这些能力共同构成了一个完整的、从分析到验证的调试闭环：

  1. 系统性问题分析 (Systematic Problem Analysis): 结构化地识别和分类潜在的根本原因。
  2. 代码审查与调试 (Code Inspection and Debugging): 深入检查源代码、配置和系统状态。
  3. 日志分析 (Log Analysis): 处理和解读系统日志、错误信息和诊断输出。
  4. 错误模式识别 (Error Pattern Recognition): 识别常见的故障模式和重复出现的问题。
  5. 实施修复 (Implementation of Fixes): 开发并应用有针对性的解决方案。
  6. 验证解决方案 (Validation of Solutions): 进行全面测试，确保修复解决了根本原因，且没有引入新的问题（回归）。

3. 结构化的五步调试法 (Five-Step Debugging Methodology)#

这是 Debug Mode 的灵魂，它强制 AI 遵循一个严谨、科学的调试流程，避免了盲目试错。

  1. 识别潜在原因 (Identify Potential Causes): 基于现有证据，生成 5-7 个可能的根本原因假设。
  2. 缩小范围 (Narrow Down to Most Likely): 通过系统性分析，将调查重点缩小到 1-2 个最可能的根本原因。
  3. 添加验证日志 (Add Validation Logging): 在代码中植入诊断性日志，以验证假设并收集更多证据。
  4. 确认诊断 (Get Diagnosis Confirmation): 在实施任何修复之前，必须先向用户确认对根本原因的诊断是否正确。
  5. 实施并验证修复 (Implement and Verify Fix): 应用解决方案，并进行彻底的验证测试，确保问题解决且无副作用。

4. 行为特征与沟通风格#

Debug Mode 的行为和沟通方式被设计为专业、严谨且以证据为导向。

  • 沟通风格:
  • 工作方法:

5. 工具使用与系统集成#

  • 工具优先级: 与其他模式类似，优先使用基础工具 (read_file, search_files, execute_command 等)，仅在需要与外部监控、日志系统等交互时才考虑使用 MCP 工具。
  • 工具使用目的: 在 Debug Mode 中，每一次工具的使用都必须服务于系统性的问题解决流程，无论是为了收集证据、验证假设还是实施修复。
  • 系统约束: 完全遵守 RooLite 的核心规则 (CORE_RULES) 和安全约束，如只读目录保护、固定的工作目录等。

6. 配置结构#

该模式的配置在 .roo/system-prompt-debug 文件中定义，关键部分包括：

  • role: 定义 AI 为调试专家。
  • capabilities: 列出六大核心调试能力。
  • objective: 明确规定了必须遵循的五步调试法。