todo-management 是一个用于技能开发全过程的系统化任务跟踪方法。它的目的是系统化地跟踪进度、保持对工作状态的可见性、尽早发现问题并确保任务最终完成。其价值在于防止工作被遗忘、提供清晰的进度可见性、支持及时调整方向，并保持从开始到结束的推进动力。
适用场景：在使用 task-development 完成工作拆解之后；在技能实现的全过程（持续跟踪）；在协调多个并行任务时；在向相关方汇报进度时；在确保所有工作最终完成时。
前提条件：使用 todo-management 之前需要具备：来自 task-development 的完整任务拆解清单；对每个任务“完成”含义的清晰理解；在工作过程中持续更新任务状态的承诺。
主要能力（基于任务的八项操作）：
-
初始化待办清单：在技能开发开始时、任务拆解完成后使用。导入任务清单，将所有任务初始状态设为 pending，添加技能名称、开始日期、估算等元数据，并验证完整性。
-
开始任务：开始特定任务时使用。检查依赖是否完成，将状态从 pending 更新为 in_progress，记录开始时间。关键规则：同一时间最多只有一个任务处于 in_progress，以防止上下文切换。
-
完成任务：任务完成后立即使用。验证完成情况（产出存在、质量已检查），将状态从 in_progress 更新为 completed，记录实际用时并与估算对比，检查下一步可推进的工作。最佳实践是立即完成状态更新，不要批量更新。
-
报告进度：每日、里程碑节点或被要求时使用。计算已完成、进行中、剩余任务等指标，生成包含状态、当前工作和阻塞情况的报告。
-
识别阻塞：当任务无法推进或耗时超出 20% 以上时使用。记录被阻塞的内容、阻塞原因、谁能解除阻塞，并采取请求帮助、切换任务或上报等行动。阻塞类型分为硬阻塞、软阻塞和等待型阻塞。
-
更新估算：当实际用时与估算差异显著（超过 20%）时使用。对比实际与估算，识别偏差模式，调整剩余任务估算并沟通新的完成时间线。
-
处理任务变更：范围变化、发现新任务或任务作废时使用。记录变更内容、原因和影响，更新任务清单，并重新计算估算和关键路径。
-
保持推进节奏：持续进行，尤其是在感到停滞时使用。定期每日回顾进度，识别拖慢进度的因素（长任务、阻塞、任务切换、完美主义），采取快速取胜、时间盒、跳过并稍后返回等策略，并标记完成情况、认可里程碑。
任务状态模型：
- pending（⬜）：尚未开始，所有任务的初始状态。
- in_progress（🔄）：当前正在处理，关键规则是同一时间只能有一个。
- completed（✅）：已完成并验证，产出存在且质量已检查，属于终态。 状态转换：pending → in_progress（开始工作）；in_progress → completed（完成并验证）；in_progress → pending（发现阻塞）。 可选特殊状态：blocked（🚫）因障碍无法推进；obsolete（⊗）任务不再需要；deferred（⏸）推迟到后续版本。
进度跟踪格式：文档提供了四种格式：简单清单格式（简单、便于携带，但没有进行中状态）；带 emoji 的增强格式（状态清晰、直观，需要 emoji 支持）；表格格式（结构化、可跟踪实际用时，但较冗长）；按阶段分组格式（逻辑分组、有里程碑，结构更复杂）。
使用方式（自动化脚本）：文档提供脚本命令示例，包括：使用 python scripts/update-todos.py --init task-list.md 从任务清单初始化；使用 --start 5 开始任务；使用 --complete 5 完成任务；使用 --report 生成进度报告；使用 --blocker 7 "Waiting for docs" 标记阻塞；使用 --update-estimate 3 "2h" 更新估算；使用 --add "Validate new feature" "1h" "Phase 4" 添加新任务。
进度指标：完成率 = 已完成 / 总数 × 100%；速度 = 已完成任务 / 已用时间；预计剩余 = 剩余任务估算之和；消耗率 = 已用时间 / 总估算时间 × 100%；是否按计划 = 消耗率约等于完成率（±10%）。
最佳实践：立即更新（不批量更新）；一次只进行一个任务（避免上下文切换）；标记阻塞（让问题可见）；先完成再开始新任务（先完成当前任务）；更新估算（学习和改进）；定期报告；处理变更（适应新需求）；保持推进节奏（每次会话至少完成 1 个任务）。
常见错误：批量更新；多个任务同时处于进行中；未真正完成就推进下一个（应在当前任务完成后才进入下一个）；忽视阻塞（应在一个工作日内处理）；不记录实际用时（无法改进估算）。
与其他技能的集成：task-development → todo-management（task-development 创建任务清单，todo-management 跟踪进度）；planning-architect → task-development → todo-management（计划估算 → 带估算的任务 → 跟踪至完成）；momentum-keeper 监测 todo-management 中停滞的任务和下降的速度。
成功标准：定期更新（任务立即更新）；清晰可见（进度一目了然）；保持推进（每次会话至少完成 1 个任务）；现实跟踪（基于实际用时更新估算）；最终完成（所有任务最终完成）。
详细信息可参考：状态管理指南 references/state-management-guide.md；进度报告指南 references/progress-reporting-guide.md；自动化脚本 python scripts/update-todos.py --help。