SuperAPI AI 工具集

util-manage-todo

智能体与模型

查看项目

更新于 10-15 20:34

技能介绍

用途:管理项目根目录的 ./todo.md,跟踪任务状态、与 TodoWrite 同步,并支持受 ADR 约束的重构。主要场景是 Claude 检测到多步骤工作时主动创建或更新待办,也支持用户要求创建待办、更新任务状态或跟踪任务。单一简单任务、少于三步的琐碎操作和纯信息查询不使用该技能。

主要能力:待办文件包含目标、任务列表、优先级、验收标准与进度汇总。任务状态用图标表示:🔴 待开始、🟡 进行中、🟢 完成、⚫ 阻塞。集成工作采用三阶段模式:创建、连接、验证,缺少任一阶段视为未完成。重构类任务需要 ADR,若无 ADR 则停止并提示用户创建。

使用方式:创建待办时先读取项目上下文,再创建 ./todo.md、分配状态并同步 TodoWrite;更新状态时按 🔴→🟡→🟢 更新,并保持 TodoWrite 一致;检查进度时读取文件、计算完成率、识别阻塞并建议下一步。todo.md 是唯一事实来源。

限制:仅适用于该技能定义的工作流;临时探索使用会话级待办,位置为 .claude/artifacts/YYYY-MM-DD/todos/todo-{name}.md。任务粒度建议 1-4 小时、有明确交付物。缺少运行时验证证据时不能标记完成。版本 2.0.0,更新于 2025-12-07。