跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

Todo 列表工具

启用会话任务列表,区分进度标记和实际完成证据。

todo_write 为当前会话维护结构化任务列表,适合多步骤实施、跨文件重构等工作。它默认关闭,启用后重启 Qwen Code:

{
  "tools": {"todoWrite": {"enabled": true}}
}

启用允许模型选择该工具,不保证每个请求都会创建列表;简单问答或一步操作通常不需要。

数据结构

唯一参数 todos 是数组,每项有唯一 id、描述 content 和 status。状态仅 pending、in_progress、completed。

{
  "todos": [
    {"id": "inspect", "content": "Inspect the existing implementation", "status": "completed"},
    {"id": "change", "content": "Implement the requested behavior", "status": "in_progress"},
    {"id": "verify", "content": "Verify the changed behavior", "status": "pending"}
  ]
}

这是工具输入,不是 settings 文件。列表写入 ~/.qwen/todos/ 的会话专属文件,不同会话分别管理。

与其他任务机制区分

Todo 描述进度,不是后台进程、定时任务,也不是有预算和证据状态的 Goal。将一项设 completed 不能替代构建输出、真实工具结果或用户验收。

需要记录长期目标见Goals,观察后台执行见Monitor;监听 Todo 变化的 Hook 则见状态观察事件。