用途
resolve_todo_parallel 用于批量解决所有待处理的 CLI TODO 注释,采用并行处理方式提高效率。它适用于需要集中清理代码库中遗留 TODO 项的场景。
主要能力
该技能的核心能力是并行处理多个 TODO 项。它会从 /todos/*.md 目录中获取所有未解决的 TODO,并针对每个未解决项并行启动 pr-comment-resolver 代理进行处理。
使用方式
工作流程分为四个阶段:
-
分析:获取 /todos/*.md 目录中所有未解决的 TODO。如果某个 TODO 建议删除、移除或将 docs/plans/ 或 docs/solutions/ 中的文件加入 gitignore,则跳过该 TODO 并标记为 wont_fix,因为这些是复合工程流水线的产物,是有意且永久保留的。
-
规划:创建所有未解决项的 TodoWrite 列表,按类型分组。需要查看可能出现的依赖关系,并优先处理被其他项依赖的任务。例如,如果需要更改名称,则必须等待其他相关操作完成。输出一个 mermaid 流程图,展示如何执行这些任务——是否可以全部并行,还是需要先完成某一项再并行处理其他项。将待办事项按流程顺序放入 mermaid 图中,以便代理知道如何按顺序推进。
-
实现(并行):为每个未解决项并行启动一个 pr-comment-resolver 代理。例如,如果有 3 条评论,就会并行启动 3 个 pr-comment-resolver 代理,形式如下:
Task pr-comment-resolver(comment1)
Task pr-comment-resolver(comment2)
Task pr-comment-resolver(comment3)
始终为每个 TODO 项并行运行所有子代理/任务。
-
提交与解决:提交更改;从文件中移除 TODO 并标记为已解决;推送到远程。
适用场景
适用于需要批量清理代码库中遗留 TODO 注释的开发工作流,尤其是当 TODO 项较多、可以并行处理以提高效率时。
限制
对于建议删除、移除或将 docs/plans/ 或 docs/solutions/ 下文件加入 gitignore 的 TODO,该技能会跳过并标记为 wont_fix,不会执行这些操作。其他限制暂未提供。