update_todo_list
update_todo_list 工具可基于任务当前状态，以更新后的清单替换原待办清单全量内容。该工具支持分步任务追踪，允许在执行更新操作前确认任务完成状态，同时可对复杂任务执行过程中发现的新待办项进行动态追加。
参数说明
本工具接收以下参数：
todos（必填）：带任务描述与状态标识的Markdown格式待办清单
功能说明
本工具用于管理全维度待办清单，通过多类状态标识追踪任务进度。每次更新均会对原清单进行全量替换，确保清单当前状态可精准反映所有待执行、执行中及已完成任务。系统将在后续交互消息中展示该待办清单，作为任务提醒。
适用场景
- 任务包含多个步骤，需进行系统化追踪时
- 任务执行过程中发现新的可执行项时
- 需同时更新多项待办任务状态时
- 复杂项目需通过清晰的分步方式追踪进度时
- 需对存在依赖关系的多阶段工作流进行梳理时
核心特性
- 维护单层级 Markdown 待办清单，支持三类任务状态标识
- 支持单次操作更新多项任务状态
- 可对任务执行过程中发现的新待办项进行动态追加
- 通过状态标识实现任务进度的可视化追踪
- 与提醒系统集成，保障任务状态的持久化可见性
- 支持根据执行优先级对任务进行重排序
- 非显式移除的未完成任务将全部保留
- 支持高效的批量状态更新操作
限制说明
- 仅支持单层级待办清单，不支持嵌套结构或子任务
- 仅任务完成或失去相关性时，可对其执行移除操作
- 仅支持全量清单替换，不支持增量更新
- 需通过工具调用显式管理任务状态变更
- 无内置的任务依赖关系追踪能力
- 不支持为任务设置未来执行时间
- 仅支持三类任务状态标识（待执行、执行中、已完成）
状态标识规范
本工具采用三类差异化的任务状态标识，定义如下：
[ ]待执行（Pending）：任务尚未启动[-]执行中（In Progress）：任务当前正在执行[x]已完成（Completed）：任务全部执行完毕，无未解决问题
执行流程
调用update_todo_list工具后，系统将按以下流程执行操作：
状态校验
- 解析 Markdown 格式待办清单
- 校验状态标识的格式规范性
- 确保任务描述清晰、具备可执行性
清单替换
- 对原有待办清单执行全量替换
- 保留更新指令中指定的任务排序
- 完整保留任务描述与对应状态标识
提醒系统集成
- 将更新后的清单同步至提醒系统
- 在后续消息的头部区域展示当前任务
- 保障任务进度的持久化可视化
进度追踪
- 跨多次更新操作，持续追踪任务完成状态
- 保留任务历史记录，供后续查阅
- 支持跨会话的工作流续执行
最佳实践
任务管理准则
- 任务全部执行完毕后，立即将其标记为已完成
- 启动下一项任务前，将其状态更新为执行中
- 发现新待办项后，立即完成追加操作
- 为任务命名时，使用清晰、具描述性的名称，明确具体执行动作
- 按任务的逻辑执行顺序或优先级完成排序
状态更新规范
- 任务状态切换时，可同时更新多项任务的状态标识
- 标记任务为已完成前，先确认其执行完成状态
- 执行中任务仅聚焦当前正在开展的工作
- 发现任务依赖关系时，及时追加阻塞性任务
适用与禁用场景
推荐使用场景
- 任务包含多个执行步骤，或需要进行持续追踪时
- 任务执行过程中发现新的可执行项时
- 需同时更新多项待办任务的状态时
- 复杂任务需通过可视化方式清晰展示进度时
禁用场景
- 仅存在单一、简单的执行任务时
- 任务可通过1-2个简单步骤完成时
- 交互请求为纯对话式咨询或信息查询类需求时
典型应用场景
- 实现多组件功能模块，需同时完成前端、后端及数据库改造时
- 调试问题过程中，发现多个相关联问题并需逐一修复时
- 搭建开发环境，包含多项配置步骤时
- 编写系统文档，需完成调研、撰写、审核多阶段工作时
- 重构代码，涉及多文件修改且需完成测试验证时
调用示例
初始任务拆解
<update_todo_list>
<todos>
[-] 分析需求并编写技术规格书
[ ] 设计数据库表结构与API接口
[ ] 实现后端认证服务
[ ] 开发前端登录组件
[ ] 编写全量测试用例
[ ] 更新产品文档
</todos>
</update_todo_list>更新任务进度并追加新发现任务
<update_todo_list>
<todos>
[x] 分析需求并编写技术规格书
[x] 设计数据库表结构与API接口
[-] 实现后端认证服务
[ ] 开发前端登录组件
[ ] 编写全量测试用例
[ ] 更新产品文档
[ ] 新增密码重置功能
[ ] 实现登录请求频率限制
</todos>
</update_todo_list>完成多项任务并切换执行焦点
<update_todo_list>
<todos>
[x] 分析需求并编写技术规格书
[x] 设计数据库表结构与API接口
[x] 实现后端认证服务
[x] 开发前端登录组件
[-] 编写全量测试用例
[ ] 更新产品文档
[ ] 新增密码重置功能
[ ] 实现登录请求频率限制
</todos>
</update_todo_list>