用途
该工具用于在单次聊天会话中维护一份共享的任务计划。计划显示在 Todo 面板中，随会话存在，不写入代码仓库。它既是代理执行任务时的进度轨道，也是用户无需阅读聊天记录即可了解当前进展的状态窗口。
主要能力
- 分组与步骤：一次用户请求对应一个任务组，组标题描述结果（如“修复登录重定向”），而不是过程。组内的条目是执行步骤，每个步骤包含标题、状态（pending → in_progress → done）和可选备注。
- 状态派生：任务组本身不存储状态，其状态由组内步骤的状态推导得出。
- 松散条目队列：未整理、半成形的输入作为松散条目保存在计划末尾，用户可在界面添加，代理也可通过 todo_add 写入。松散条目属于前期工作，不是即将执行的步骤。
- 提升机制：当开始处理某个松散条目时，用 todo_promote 以一次原子调用将其转为独立任务组，沿用原 id 和标题，避免重复或丢失。
- 备注与验证分离：备注是面向代理的工作细节（用于记录跟踪、提醒和完成标准）；标题是面向用户的、命令式的结果描述；完成代码变更的步骤还需填写 summary（变更内容与原因）和 verification（按“检查 → 结果”格式，或如实写“未验证”），并可提供 commitSubject 作为提交信息。
- 完成总结：最后一项完成后，用 todo_plan_summary 写出覆盖整个计划的交接说明，按 PR 正文格式组织为 Summary、Changes、Testing 三节。
使用方式
当任务被理解到可以识别出至少三个实质性执行步骤，或用户明确要求计划时，使用 todo_write 发布计划。执行时严格按顺序逐个步骤推进：开始时置为 in_progress，完成时置为 done；开始新步骤会自动把其他进行中步骤退回待办。选择下一项前、收到用户输入后以及完成前，用 todo_list 重新读取以同步用户编辑。单个变更优先使用 todo_update / todo_add 做外科式修改，todo_write 用于真正的重构式重排，并按组名加步骤标题匹配以保留已有进度。用户提出的修复请求应重新打开原步骤，而不是新建条目。
适用场景
适用于需要多步骤执行且用户希望透明看到进度的开发或分析任务；用户明确要求共享计划时；存在未整理的 TODO 待办时；以及需要在会话中记录任务状态、备注和完成验证信息的协作场景。
限制与注意事项
- 1–2 个执行步骤的请求不生成列表，除非用户明确要求计划。
- 步骤应可验证、约等于一次提交的大小，避免“第一阶段”这类模糊表述，也不应为“做计划”“读文件”等纯过程性动作创建条目。
- 已完成条目永不删除；todo_remove 仅在用户明确要求删除时使用。
- 不得为未运行的测试声称“通过”，也不得通过弱化检查使验证通过。
- 一个任务的步骤不得混入另一个任务组；当前组存在未完成步骤时不应开始下一组，除非任务确实被阻塞并说明原因。
- 该页面资料未提供具体的安装方式、命令行或代码示例。