Todo 与实验性 Tracker

write_todos 保存当前会话的执行清单，tracker_* 提供更细的任务依赖图。两者用于记录计划和进度，不能仅凭 completed/closed 推断测试或外部操作已成功。

Todo 清单

write_todos 每次接收完整 todos 数组，元素包含 description 和 status。状态为 pending、in_progress、completed、cancelled 或 blocked；同一时刻只有一项 in_progress。状态范围为当前会话，Ctrl+T 可切换完整列表。

开启 Tracker

官方总表将 Tracker 标为 experimental，可通过 experimental.taskTracker 启用。工具包括：

工具	作用
tracker_create_task	建立 epic、task 或 bug，包含标题与描述
tracker_update_task	更新 open、in_progress、blocked、closed 等状态及依赖
tracker_get_task	按 6 字符十六进制 ID 查询
tracker_list_tasks	按状态、类型或父任务过滤
tracker_add_dependency	加入任务依赖
tracker_visualize	输出 ASCII 任务图

依赖形成 DAG，开始被阻塞任务前应先解决前置条件。进度及树显示在输入区上方。

持久化范围

工具专页列出的存储目录是 .gemini/tmp/tracker/<session-id>，状态按会话保存，不跨不同会话自动共享。路径按该页原样保留，不能将它擅自改写成聊天历史的用户目录路径。

查看图可以直接要求 Agent 调用 visualize；官方提到可能提供 CLI 命令但未列出稳定语法，本页不编造独立 gemini tracker 子命令。删除会话的保留策略也可能清理关联 tracker 数据。

先审阅步骤，再确认结果

可以要求 Agent“先列出迁移步骤，并在每个阶段后验证构建”，再审阅依赖顺序与遗漏项。发现任务范围变化时，明确告诉 Agent 哪一项应取消或暂缓，它可以更新清单。

任务教程给出 write_todos 与 Ctrl+T 的可见进度流程；这不是 Plan Mode 的权限开关。进入只研究和制定方案的阶段，应使用计划模式，任务是否完成仍以文件、测试和操作结果为依据。