用途:当出现多个互不相关的失败(不同测试文件、不同子系统、不同 bug)时,串行排查效率低,此技能主张按独立问题域各派一个 agent 并行处理。
适用条件:3 个以上测试文件失败且 root cause 不同;多个子系统独立损坏;每个问题无需依赖其他问题的上下文即可理解;排查之间无共享状态。
不适用:失败高度关联(修一个可能顺带修其他);必须理解全局系统状态才能判断;探索性排障(尚不确定坏在哪);agent 会互相干扰(同一文件、资源或状态)。
使用方式:一是划分独立问题域,按「坏在哪」分组,例如文件 A 的 tool approval 流程、文件 B 的 batch completion 行为、文件 C 的 abort 功能;二是给每个 agent 一份聚焦任务,包含明确 scope(一个测试文件或子系统)、清晰目标(让这些测试通过)、约束(不要改其他无关代码)、期望输出(总结发现与修复);三是并行派发,文中给出的示例形式为在 Claude Code / AI 环境中并发调用多个 Task,如 Task("修复 agent-tool-abort.test.ts 的失败") 等;四是 agent 返回后逐个阅读总结、确认修复互不冲突、运行完整测试套件并集成。
Agent prompt 要求:聚焦单一问题域、自包含所需上下文、明确要求返回内容(如 root cause 与改动摘要)。文中强调不要简单加大 timeout,要找到真正原因。
常见错误:任务过宽(如「把所有测试都修好」)、缺少上下文、缺少约束(agent 可能大改重构)、输出要求模糊。
验证与收益:返回后 review 每份总结、检查是否改了同一处代码、跑全套测试、抽查系统性错误。收益为并行化、scope 更聚焦、互不干扰、速度提升。文中给出的排障记录显示 3 个文件共 6 个失败,并行派发 3 个 agent 后调查并行完成、修复成功集成且 agent 之间零冲突。
限制:该技能依赖支持并行派发 agent 的环境;具体命令与环境差异、收费情况暂未提供。