用途
todo-resolve 用于批量解决已批准的待办事项(todos),特别适用于代码审查或分类整理(triage)会话之后。它只处理已就绪(ready)的待办,跳过尚未分类的 pending 待办,忽略已完成的 complete 待办。如果存在 pending 待办,会在最后列出,让用户知道哪些被遗留。
主要能力
- 扫描 .context/compound-engineering/todos/.md 以及旧版 todos/.md,按状态分区:ready(status 字段或文件名中含 -ready-)会被解决;pending 会被跳过并在最后报告;complete 会被忽略。
- 如果传入了特定的 todo ID 或模式作为参数,则只筛选匹配的待办(仍必须是 ready 状态)。
- 跳过任何建议删除、移除或将 docs/brainstorms/、docs/plans/、docs/solutions/ 中的文件加入 gitignore 的待办——这些是有意保留的流水线产物。
- 创建按类型分组的任务列表,分析依赖关系(被其他项依赖的项先运行),并输出展示执行顺序与并行情况的 mermaid 图。
- 为每个条目启动 compound-engineering:workflow:pr-comment-resolver 智能体,优先并行执行,回退到按依赖顺序串行执行。
- 批量策略:1-4 个条目直接并行返回;5 个及以上按每批 4 个处理,每批只返回简短状态摘要(待办已处理、变更文件、运行/跳过的测试、阻塞项)。
- 对于大批量,使用 .context/compound-engineering/todo-resolve/<run-id>/ 作为临时目录存放每个解析器的产物,只向父级返回完成摘要。
- 提交变更、标记待办已解决、推送到远程。
- 加载 ce:compound 技能记录经验教训,待办解决过程常会浮现值得记录的模式和架构洞见。
- 从两个路径删除已完成/已解决的待办文件,并删除临时目录(除非用户要求检查)。
使用方式
该技能按以下工作流执行:
- 分析:扫描待办文件并按状态分区。
- 规划:创建任务列表,分析依赖,输出 mermaid 执行顺序图。
- 实现(并行):为每个条目启动 pr-comment-resolver 智能体,优先并行。
- 提交与解决:提交变更、标记待办已解决、推送到远程。此步骤设有 GATE:停止,验证待办已解决且变更已提交后再继续。
- 沉淀经验教训:加载 ce:compound 技能记录所学内容。此步骤设有 GATE:停止,验证 compound 技能在 docs/solutions/ 中产出了解决方案文档;如果没有(用户拒绝或无经验教训),则继续。
- 清理:删除两个路径中已完成/已解决的待办文件,删除临时目录(除非用户要求检查)。
最终输出摘要格式:
Todos resolved: [count] Pending (skipped): [count, or "none"] Lessons documented: [path to solution doc, or "skipped"] Todos cleaned up: [count deleted]
如果跳过了 pending 待办,会列出它们:
Skipped pending todos (run /todo-triage to approve):
- 003-pending-p2-missing-index.md
- 005-pending-p3-rename-variable.md
适用场景
- 代码审查后批量处理已批准的待办事项。
- 分类整理(triage)会话后解决已就绪的待办。
- ce:review mode:autofix 在 safe_auto 阶段之后产生的剩余可操作工作(这些会自动变为 ready 状态)。
限制
- 只处理 ready 状态的待办,pending 待办会被跳过,需要先运行 /todo-triage 批准。
- 会跳过建议删除、移除或将 docs/brainstorms/、docs/plans/、docs/solutions/ 中文件加入 gitignore 的待办。
- 依赖 compound-engineering:workflow:pr-comment-resolver 智能体和 ce:compound 技能。
- 关于收费、价格、平台支持等具体信息暂未提供。