Lzh on GitHub

任务待办事项列表

了解如何使用 Roo Code 的任务待办事项列表功能来跟踪复杂任务的进度、管理子任务并保持井井有条。

借助集成的待办事项管理功能，让你的任务步入正轨，帮助你保持井井有条并专注于你的开发目标。任务待办事项列表提供了交互式、持久的清单，可直接在聊天界面中跟踪你在复杂、多步骤工作流程中的进度。

待办事项列表触发器
待办事项列表会自动为复杂任务、多步骤工作流程或使用“架构师”模式时创建。你也可以通过要求 Roo“使用 update_todo_list 工具”或“创建待办事项列表”来手动触发它们。
有关自动和手动触发器的详细信息，请参阅 Roo 何时创建待办事项列表。

用例

之前： 在脑海中或单独的笔记文件中手动跟踪复杂任务的步骤，这很容易让你忘记进度和下一步。

有了任务待办事项列表后： Roo Code 会自动创建和管理嵌入在对话中的结构化清单。你可以查看每个项目的状态，看着 AI 将项目标记为完成，并在 Roo 呈现更新以供批准时提供反馈。

工作原理

任务待办事项列表功能由 update_todo_list 工具提供支持，该工具支持在聊天界面中进行动态任务管理。

Roo 何时创建待办事项列表

Roo 通过自动检测和手动请求来创建待办事项列表：

  • 检测到任务复杂性 - 在你的请求中识别出多个步骤、阶段或依赖项。
  • 在“架构师”模式下工作 - 始终创建待办事项列表作为其主要规划工具，用于组织工作。
  • 直接工具请求 - 说“使用 update_todo_list 工具”或“请使用 update_todo_list”。

请记住： 即使是手动触发，Roo 也保留对待办事项列表内容和工作流程的控制权。你在批准对话框中提供反馈，但 Roo 根据任务需求管理列表。

显示和交互

待办事项列表出现在多个地方：

  1. 任务标题摘要： 一个紧凑的、只读的显示，通过 TodoListDisplay 组件显示进度和下一个重要项目。
  2. 交互式工具块： 聊天界面中的一个界面，通过 UpdateTodoListToolBlock 组件，允许你：
  • 查看所有待办事项及其当前状态。
  • 点击“编辑”按钮进入编辑模式，你可以在其中：
    • 直接修改任务描述。
    • 使用下拉选择器更改任务状态。
    • 使用 × 按钮删除任务。
    • 使用“+ 添加待办事项”按钮添加新任务。
  • 暂存更改，这些更改在 Roo 下次更新列表时应用。
  • 随着 Roo 管理待办事项工作流程，查看进展。
  1. 环境详情： 待办事项列表在 environment_details 部分中显示为“REMINDERS”表，为 AI 提供对当前待办事项状态的持久访问。注意： 如果 todoListEnabled 设置被禁用，提醒部分将不会出现在环境详情中。

展开的待办事项视图

当你点击任务标题中折叠的待办事项摘要时，会出现一个带有增强功能的浮动面板：

  • 背景叠加： 点击面板外部以关闭它。
  • 完整的待办事项列表显示： 显示所有待办事项及其当前状态指示器。
  • 自动滚动： 自动滚动到当前正在进行的任务。
  • 流畅的动画： 折叠和展开过渡，以提供更好的用户体验。
  • 持久状态： 在重新打开时保持你的滚动位置。

理解任务状态

Roo Code 会根据任务进度自动管理状态进展。每个待办事项都有三种状态之一：

待定： 显示一个带有边框的空心圆圈，表示任务尚未开始。

进行中： 显示一个实心黄色圆圈，表示任务正在进行中。

已完成： 显示一个实心绿色圆圈，确认任务已完全完成。

在批准期间编辑待办事项列表

当 Roo 呈现待办事项列表更新以供批准时，你可以通过“编辑”模式完全控制：

  1. 点击“编辑”进入编辑模式。
  2. 进行你的更改：
  • 内联编辑任务描述。
  • 使用下拉菜单更改状态（待定/进行中/已完成）。
  • 使用 × 按钮移除任务。
  • 使用底部的“+ 添加待办事项”按钮添加新任务。
  1. 保存或取消你的更改。
  2. 批准或拒绝整个更新。

注意： 你的编辑是暂存的，只有当 Roo 处理下一个待办事项列表更新时才会应用。这在给予你对任务细节的输入的同时，保持了 Roo 对工作流程的控制。

常见问题解答

“我可以创建自己的待办事项列表吗？” 是的，你可以通过要求 Roo“使用 update_todo_list 工具”或“创建待办事项列表”来手动触发待办事项列表的创建。但是，Roo 保持对所有待办事项列表内容和工作流程的控制——你在批准对话框中提供指导和反馈，但 Roo 根据任务需求管理列表。

“我可以使用待办事项列表来处理简单任务吗？” Roo Code 通常只为复杂、多步骤的任务创建待办事项列表，因为它们在那里提供了明确的价值。对于简单任务，列表管理的开销是不必要的。

“为什么我不能直接控制待办事项列表？” 这是一个架构设计决策，Roo Code 保持对任务管理的权威。你提供指导和反馈，但 Roo 控制工作流程，以确保一致的任务进展和准确的状态跟踪。

配置

禁用待办事项列表

你可以通过 todoListEnabled 设置完全禁用待办事项列表。禁用后：

  • Roo 不会为任何任务创建待办事项列表。
  • REMINDERS 部分不会出现在环境详情中。
  • 现有的待办事项列表仍然可见，但不会被更新。

自动批准待办事项列表更新

你可以启用自动批准待办事项列表更新，以减少冗长工作流程中的中断。启用后，Roo 将自动更新任务进度，无需为每次更改请求确认。

要配置此功能，请参阅 更新待办事项列表自动批准 设置。