dispatching-parallel-agents 技能——每个问题域一个代理
dispatching-parallel-agents 技能如何通过向每个问题域同时派遣相互隔离的代理并整合其结果,消除对独立故障的串行调查。
在一次大规模重构之后,如果三个文件中有六个测试失败,人的本能反应是一个一个地修复。如果这些失败是相互独立的——不同的子系统、不同的根本原因——那么这种串行方式浪费的时间与问题数量成正比。dispatching-parallel-agents 技能将替代方案正式化:每个独立的问题域一个隔离的代理,全部同时派遣。
独立性检验
在派遣任何代理之前,该技能要求进行独立性检查。问题是:修复一个失败是否可能影响另一个?如果这些失败共享根本原因或触及相同的代码路径,它们就属于同一个代理。如果它们真正独立——例如工具审批流程、批处理完成行为和中止功能——那么每个都获得自己的代理,拥有自己隔离的上下文窗口。
该技能还要求检查共享状态。会编辑相同文件或使用相同资源的代理会相互干扰,必须串行运行。并行派遣适用于代理无需协调即可工作的领域。
每个代理需要什么
该技能规定了良好的代理提示必须包含的四项内容。聚焦的范围:一个测试文件或一个子系统,而不是“所有失败”。理解问题所需的全部上下文:错误消息、测试名称以及每个测试验证的内容。明确的约束:“不要更改生产代码”或“只修复测试”。特定的输出格式:根本原因和所做更改的摘要,而不仅仅是“完成”。
该技能列举了常见错误并给出具体纠正。“修复所有测试”太宽泛——代理会迷失方向。“修复 agent-tool-abort.test.ts”才是正确的范围。在提示中传入错误消息和测试名称,是找到真正问题的代理与仅仅增加超时时间的代理之间的区别。
该技能中的一个真实示例
该技能记录了一个具体会话:一次大规模重构后,三个测试文件中有六个失败。三个代理被并行派遣。代理 1 通过用基于事件的等待替换任意超时,修复了中止测试文件中的时序问题。代理 2 在批处理完成文件中发现了一个事件结构错误——一个 threadId 字段被放在了错误的位置。代理 3 在竞态条件文件中添加了对异步工具执行的等待。三个修复都是独立的,集成时没有出现冲突,完整测试套件全部通过。
集成与验证
当代理返回时,编排器读取每个摘要,检查冲突,运行完整测试套件,并对更改进行抽查。该技能指出,代理可能犯系统性错误——如果三个代理都应用了相同的错误修复,抽查会在会话结束前发现它。
该技能明确说明了何时不应使用此模式。共享根本原因的相关失败应一起调查。探索性调试——即尚不清楚哪里出了问题——需要一个拥有完整上下文的单一代理。任何代理会编辑相同文件的情况都是串行的,而非并行的。
阅读什么是 Datarim了解完整流水线概览,或阅读/dr-do 命令文章了解并行代理派遣在实现阶段的位置。