待办工具 (`write_todos`)

待办工具 (write_todos)

本文档描述了 Gemini CLI 的 write_todos 工具。

描述

write_todos 工具允许 Gemini 代理创建和管理复杂用户请求的子任务列表。这为您提供了更多关于代理计划及其当前进展的可见性。这也有助于对齐，使代理更不可能丢失当前目标。

参数

write_todos 需要一个参数：

• todos（对象数组，必填）：待办事项的完整列表。这将替换现有列表。每个项目包括：
  • description（字符串）：任务描述。
  • status（字符串）：当前状态（pending、in_progress、completed 或 cancelled）。

行为

代理使用此工具将复杂的分步请求分解为明确的计划。

• 进度跟踪： 代理在执行工作时更新此列表，完成任务后标记为 completed。
• 单一焦点： 同时只有一个任务会被标记为 in_progress，表示代理当前正在处理的确切任务。
• 动态更新： 随着代理发现新信息，计划可能会发展，导致新任务被添加或取消不必要的任务。

当活动时，当前的 in_progress 任务会显示在输入框上方，使您了解即将执行的操作。您可以通过按 Ctrl+T 随时切换待办事项列表的完整视图。

使用示例（内部表示）：

write_todos({
  todos: [
    { description: 'Initialize new React project', status: 'completed' },
    { description: 'Implement state management', status: 'in_progress' },
    { description: 'Create API service', status: 'pending' },
  ],
});

重要说明

• 启用： 此工具默认启用。您可以在 settings.json 文件中通过设置 "useWriteTodos": false 来禁用它。

• 预期用途： 此工具主要由代理用于复杂的多轮任务。通常不用于简单的单轮问题。