name: 待办事项 description: 为复杂的多步骤工作创建和跟踪任务列表。在规划项目、分解工作、跟踪进度或任务有3个以上步骤时使用。触发词包括“计划”、“待办事项”、“任务列表”、“分解”、“逐步”或需要多个操作的复杂请求。
待办事项管理
使用 manage_todos 和 list_todos 来规划、跟踪和完成多步骤工作。
何时使用
创建待办事项时:
- 任务有3个以上不同的步骤
- 工作跨越多个文件或系统
- 用户请求计划或分解
- 复杂的调试或调查
- 多阶段项目(研究 -> 实施 -> 测试)
跳过待办事项用于: 单步任务、简单命令、快速查找。
工作原理
编写待办事项
使用 完整列表 调用 manage_todos。每次调用都会替换之前的列表。
每个项目有:
content:需要做什么(具体且可验证)status:pending|in_progress|completed|cancelledpriority:high|medium|low
读取待办事项
调用 list_todos(无参数)以检索当前列表及状态计数。
进度跟踪
- 一次只标记 一个 项目为
in_progress。 - 完成项目后立即标记为
completed— 不要批量处理。 - 开始新项目时,通过
manage_todos发送完整的更新列表。
工作流程
任务开始时
- 分析请求。
- 调用
manage_todos并所有计划步骤(状态:pending)。 - 简要告诉用户计划。
- 将第一个项目标记为
in_progress并开始。
执行期间
- 按依赖顺序处理项目。
- 完成一个项目后,调用
manage_todos将该项目标记为completed并将下一个标记为in_progress。 - 如果发现新步骤,在同一调用中添加它们到列表中。
- 如果一个项目被阻塞,将其设置为
cancelled,并在content中解释原因。
任务结束时
- 调用
list_todos验证所有项目是否为completed或cancelled。 - 总结完成的内容并注意任何跳过的项目。
模式
调查 / 调试
重现 -> 调查 -> 修复 -> 验证
项目:获取重现步骤、本地重现、检查日志、识别根本原因、实施修复、添加测试、验证修复。
功能实现
设计 -> 实施 -> 测试 -> 发布
项目:审查需求、设计API、创建模型、实施逻辑、编写测试、手动QA、部署。
研究
收集 -> 分析 -> 推荐
项目:搜索现有解决方案、审查文档、比较方法、列出优缺点、撰写总结。
反模式
- 模糊项目(“修复bug”) — 要具体(“在
parseConfig中添加缺失host字段的空检查”) - 超过50个项目的庞大列表 — 分成阶段,完成一个阶段后再规划下一个
- 从不更新状态 — 在每个有意义步骤后调用
manage_todos - 为复杂任务跳过待办事项 — 如有疑问,创建列表