dispatching-parallel-agents

技能简介

当遇到 2 个及以上相互独立、无共享状态或顺序依赖的任务时，本技能会将它们并行分发给多个专用 Agent 处理。通过为每个 Agent 精确构造指令和上下文，让各任务同时推进，避免逐个排查浪费时间，同时保留主会话上下文用于协调工作。

使用场景

• 3 个以上测试文件因不同根因同时失败
• 多个子系统各自独立出现故障
• 各问题无需参考其他问题的上下文即可独立理解
• 多个无关联的 bug 需要分别调查修复

使用方法

1. 识别独立任务域：按文件、模块或子系统对失败进行分组，确认彼此无依赖。

2. 创建聚焦的 Agent 任务：为每个 Agent 明确指定范围（如某个测试文件）、目标、约束（如"不要改动其他代码"）和预期输出。

3. 并行分发：在同一个响应中同时发起多个 Subagent 调度，它们即并行执行；若分散在不同响应中则按顺序执行。示例：

   Subagent (general-purpose): "Fix agent-tool-abort.test.ts failures"
   Subagent (general-purpose): "Fix batch-completion-behavior.test.ts failures"
   Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
   

4. 审查与整合：收集各 Agent 返回的摘要，检查改动是否冲突，运行完整测试套件验证。

注意事项

• 若失败彼此相关（修复一个可能连带修复其他），应先一起调查，不要并行分发。
• Agent 之间不得共享状态或资源；若它们会编辑同一文件、互相干扰，应避免并行。
• 提示词务必具体：包含测试文件名、错误信息、约束条件和明确的返回格式，避免"修复所有问题"这类过泛指令。
• 不要给 Agent 继承当前会话的上下文，应为每个任务精确构造所需的全部信息。