SuperAPI AI 工具集

resolve_todo_parallel

编程与开发

查看项目

更新于 10-16 07:29

技能介绍

用途

resolve_todo_parallel 用于批量解决所有待处理的 CLI TODO 注释,采用并行处理方式提高效率。它适用于需要集中清理代码库中遗留 TODO 项的场景。

主要能力

该技能的核心能力是并行处理多个 TODO 项。它会从 /todos/*.md 目录中获取所有未解决的 TODO,并针对每个未解决项并行启动 pr-comment-resolver 代理进行处理。

使用方式

工作流程分为四个阶段:

  1. 分析:获取 /todos/*.md 目录中所有未解决的 TODO。如果某个 TODO 建议删除、移除或将 docs/plans/ 或 docs/solutions/ 中的文件加入 gitignore,则跳过该 TODO 并标记为 wont_fix,因为这些是复合工程流水线的产物,是有意且永久保留的。

  2. 规划:创建所有未解决项的 TodoWrite 列表,按类型分组。需要查看可能出现的依赖关系,并优先处理被其他项依赖的任务。例如,如果需要更改名称,则必须等待其他相关操作完成。输出一个 mermaid 流程图,展示如何执行这些任务——是否可以全部并行,还是需要先完成某一项再并行处理其他项。将待办事项按流程顺序放入 mermaid 图中,以便代理知道如何按顺序推进。

  3. 实现(并行):为每个未解决项并行启动一个 pr-comment-resolver 代理。例如,如果有 3 条评论,就会并行启动 3 个 pr-comment-resolver 代理,形式如下:

    Task pr-comment-resolver(comment1)

    Task pr-comment-resolver(comment2)

    Task pr-comment-resolver(comment3)

    始终为每个 TODO 项并行运行所有子代理/任务。

  4. 提交与解决:提交更改;从文件中移除 TODO 并标记为已解决;推送到远程。

适用场景

适用于需要批量清理代码库中遗留 TODO 注释的开发工作流,尤其是当 TODO 项较多、可以并行处理以提高效率时。

限制

对于建议删除、移除或将 docs/plans/ 或 docs/solutions/ 下文件加入 gitignore 的 TODO,该技能会跳过并标记为 wont_fix,不会执行这些操作。其他限制暂未提供。