待办事项写入工具（todo_write）

本文档介绍 Qwen Code 的 todo_write 工具。

描述

使用 todo_write 创建并管理当前编码会话的结构化待办事项列表。该工具可帮助 AI 助手跟踪进度、组织复杂任务，使您清晰了解当前正在进行的工作。

参数

todo_write 接受一个参数：

• todos（数组，必需）：待办事项条目数组，每个条目包含以下字段：
  • content（字符串，必需）：任务描述。
  • status（字符串，必需）：当前状态（pending、in_progress 或 completed）。
  • activeForm（字符串，必需）：描述当前正在执行动作的现在进行时形式（例如：“运行测试”、“构建项目”）。

如何将 todo_write 与 Qwen Code 配合使用

AI 助手在处理复杂、多步骤任务时会自动调用此工具。你无需显式请求，但若希望查看助手为你请求所规划的执行方案，可主动要求其生成待办事项列表。

该工具将待办事项列表存储在你的主目录下（~/.qwen/todos/），并为每次会话生成独立的文件，因此每次编码会话都拥有专属的任务列表。

AI 调用此工具的场景

助手会在以下情况下使用 todo_write：

• 需要多个步骤完成的复杂任务
• 包含多个组件的功能实现
• 涉及多个文件的重构操作
• 任何包含 3 个或以上明确操作的工作

对于简单、单步任务或纯信息查询类请求，助手不会调用此工具。

todo_write 示例

创建功能实现计划：

todo_write(todos=[
  {
    "content": "创建用户偏好模型",
    "status": "pending",
    "activeForm": "正在创建用户偏好模型"
  },
  {
    "content": "为偏好设置添加 API 端点",
    "status": "pending",
    "activeForm": "正在为偏好设置添加 API 端点"
  },
  {
    "content": "实现前端组件",
    "status": "pending",
    "activeForm": "正在实现前端组件"
  }
])

重要说明

• 自动使用： AI 助手会在执行复杂任务期间自动管理待办事项列表。
• 进度可见性： 随着工作推进，您将实时看到待办事项列表的更新。
• 会话隔离： 每个编码会话都有其独立的待办事项列表，彼此互不干扰。