用途:批量解决项目中的待办 TODO 注释,借助并行处理提高效率,并把解决过程中的经验记录下来,最后清理已完成的 TODO。
主要能力与流程:
- 分析:从 /todos/*.md 目录读取所有未解决的 TODO。若某 TODO 建议删除、移除或将 docs/brainstorms/、docs/plans/、docs/solutions/ 下的文件加入 gitignore,则跳过并标记为 wont_fix,因为这些是 compound-engineering 流水线的永久产物。
- 规划:按类型把未解决项分组成任务列表(如 Claude Code 的 TaskCreate、Codex 的 update_plan),分析依赖并按依赖优先级排序,输出 mermaid 流程图说明哪些可并行、哪些必须先执行。
- 实现(并行):为每个未解决项启动一个 compound-engineering:workflow:pr-comment-resolver 智能体。有 3 项就启动 3 个,优先并行;平台不支持并行时按依赖顺序串行。控制父上下文压力:1-4 项可直接并行返回;5 项及以上每次最多 4 个分批启动;要求智能体只返回简短状态摘要(处理的 TODO、变更文件、运行或跳过的测试、仍需跟进的阻塞)。若 TODO 集较大,可用每次运行的临时目录(如 .context/compound-engineering/resolve-todo-parallel/<run-id>/),让每个解析智能体写入紧凑产物,父级只返回完成摘要,并按需读取产物。
- 提交与标记:提交变更,从文件中移除该 TODO 并标记为已解决,推送到远端。门禁:停止,确认 TODO 已解决且变更已提交;若无 TODO 被解决,不得进入第 5 步。
- 沉淀经验:加载 ce:compound 技能,记录解决 TODO 过程中的经验。门禁:停止,确认在 docs/solutions/ 下生成了解决方案文档;若无(用户拒绝或无重要经验),继续第 6 步。
- 清理:列出所有 TODO,找出 done 或 resolved 状态的项并删除;若使用了临时目录且用户未要求检查,在清理成功后一并清理。最后输出摘要:已解决数量、经验文档路径或 skipped、已清理数量。
限制:依赖 /todos/*.md 目录结构;并行能力受平台支持情况影响;需要 pr-comment-resolver、ce:compound 等技能可用;官方未提供具体安装命令与收费信息。