RooLite Basic Tools

1. 核心定位：RooLite 的基础能力集#

• 定义: Basic Tools 是 RooLite 的标准、内置工具集，提供了文件操作、代码修改和系统交互等核心功能。
• 普遍性: 这些工具是所有操作模式（Code, Debug, DevOps 等）都可以使用的基础能力，构成了 RooLite 执行任务的基石。

2. 四大工具类别#

Basic Tools 可以清晰地分为四大类：

A. 文件操作工具 (File Operations)

• 核心工具:

B. 代码修改工具 (Code Modification)

• 核心理念: 提供精确、上下文感知的代码修改能力，避免对文件进行大规模、不必要的重写。
• 核心工具与策略:

C. 系统与控制工具 (System and Control)

• 核心工具:

D. 任务完成工具 (Task Completion)

• attempt_completion: 见上文。

3. 强制性的使用协议和流程#

• XML 格式: 所有工具调用必须使用标准化的 XML 格式，确保了调用的规范性和一致性。
• 一次一工具: 每次与用户的交互中，Roo 最多只能调用一个工具。
• 逐步确认: 每执行一个工具后，都需要等待用户的确认，这提供了强大的控制和纠错机会。
• 强制初始化: 任何操作前，必须先读取 tools_guide，这是不可逾越的规则。

4. 效率优化模式 (Efficiency Patterns)#

文档强调了一些最佳实践组合，以提高工作效率：

• 文件发现模式: 先用 list_files 找到目标文件，再用 read_file 精确读取。
• 代码分析模式: list_code_definition_names -> search_files -> read_file，这是一个从宏观到微观的分析流程。
• 搜索与修改模式: search_files -> read_file -> apply_diff，先定位，再确认，最后精确修改。

总之，Basic Tools 是 RooLite 的“手和脚”，提供了所有具体操作的能力。这份文档不仅列出了每个工具的功能，更重要的是定义了何时使用哪个工具 (策略)、如何正确使用它们 (XML 格式)，以及如何组合使用它们以达到最高效率 (模式)。这些规则和模式是保证 RooLite 可靠、高效运行的关键。