update_todo_list
update_todo_list 工具用反映当前状态的更新清单替换整个 TODO 列表。它提供分步任务跟踪，允许在更新和在复杂任务期间发现新待办事项时动态添加新待办事项之前确认完成。
参数
该工具接受以下参数：
todos（必需）：带有任务描述和状态指示器的 markdown 清单
作用
此工具管理一个全面的 TODO 列表，该列表通过不同的状态跟踪任务进度。它在每次更新时替换整个列表，确保当前状态准确反映所有待处理、进行中和已完成的任务。系统将 TODO 列表显示为后续消息中的提醒。
何时使用？
- 当任务涉及需要系统跟踪的多个步骤时
- 当在任务执行过程中发现新的可操作项时
- 当更新多个待办事项的状态时
- 当复杂项目受益于清晰、分步的进度跟踪时
- 当组织具有依赖关系的多阶段工作流时
主要功能
- 维护具有三种状态的单级 markdown 清单
- 在单个操作中更新多个任务状态
- 在执行过程中发现新待办事项时动态添加
- 通过状态指示器提供视觉进度跟踪
- 与提醒系统集成以实现持久的任务可见性
- 支持根据执行优先级重新排序任务
- 除非明确删除，否则保留所有未完成的任务
- 支持高效的批量状态更新
限制
- 仅限于单级清单（无嵌套或子任务）
- 除非任务已完成或不再相关，否则无法删除任务
- 需要完全替换列表而不是增量更新
- 状态更改必须通过工具调用显式管理
- 没有内置的任务依赖跟踪
- 无法安排任务在将来执行
- 仅限于三种状态（待处理、进行中、已完成）
状态指示器
该工具使用三种不同的状态指示器：
[ ]待处理：任务尚未开始[-]进行中：任务当前正在进行中[x]已完成：任务已完全完成，没有未解决的问题
工作原理
当调用 update_todo_list 工具时，它遵循以下过程：
-
状态验证：
- 解析 markdown 清单格式
- 验证状态指示器格式是否正确
- 确保任务描述清晰且可操作
-
列表替换：
- 完全替换现有 TODO 列表
- 保留更新中指定的任务顺序
- 维护任务描述和状态
-
提醒集成：
- 将更新的列表与提醒系统集成
- 在后续消息标题中显示当前任务
- 提供任务进度的持久可见性
-
进度跟踪：
- 跟踪多个更新的完成状态
- 维护任务历史记录以供参考
- 支持跨会话的工作流延续
最佳实践
任务管理指南
- 在所有工作完成后立即将任务标记为已完成
- 通过将下一个任务标记为进行中来开始下一个任务
- 在执行过程中一旦识别出新任务就立即添加
- 使用清晰、描述性的任务名称来指示具体操作
- 按逻辑执行顺序或优先级对任务进行排序
状态更新模式
- 在任务转换时同时更新多个状态
- 在标记为已完成之前确认任务完成
- 保持进行中的任务专注于当前工作
- 在发现依赖关系时添加阻塞任务
何时使用
在以下情况下使用此工具：
- 任务涉及多个步骤或需要持续跟踪
- 在任务执行过程中发现新的可操作项
- 多个待办事项需要同时更新状态
- 复杂任务受益于清晰的进度可视化
避免在以下情况下使用：
- 只有一个简单任务
- 任务可以在一两个简单步骤中完成
- 请求纯粹是对话或信息性的
使用示例
- 在实现需要前端、后端和数据库更改的多组件功能时
- 在调试揭示需要修复的多个相关问题时
- 在设置具有多个配置步骤的开发环境时
- 在记录需要研究、编写和审查阶段的系统时
- 在重构影响多个文件并需要测试的代码时
用法示例
初始任务分解：
<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>