name: 并行代理调度 description: 使用多个Claude代理并行调查和修复独立问题 when_to_use: 当面对3个以上独立故障时，这些故障可以在没有共享状态或依赖关系的情况下调查 version: 2.0.0 progressive_disclosure: entry_point: summary: “针对每个独立问题域调度一个代理，以并行解决多个无关故障” when_to_use: “当您在具有不同测试文件/子系统中拥有3个以上独立故障，且无共享状态或依赖关系时” quick_start: “1. 识别独立域 2. 创建聚焦代理任务 3. 并行调度 4. 审查摘要 5. 验证无冲突并集成” references: - coordination-patterns.md - agent-prompts.md - examples.md - troubleshooting.md

并行代理调度

概述

当您有多个无关故障（不同测试文件、不同子系统、不同错误）时，按顺序调查它们会浪费时间。每个调查都是独立的，可以并行进行。

核心原则： 针对每个独立问题域调度一个代理。让它们并发工作。

何时使用此技能

在以下情况激活此技能：

3个以上测试文件失败 且根源不同
多个子系统独立损坏
每个问题自包含 - 可以在没有其他上下文的情况下理解
调查之间无共享状态
清晰的域边界 - 修复一个不会影响其他

不要使用当：

故障相关（修复一个可能修复其他）
需要先理解完整系统状态
代理会相互干扰（编辑相同文件）
探索性调试（尚不知道哪里损坏）

铁律

一个代理，一个问题域，一个清晰结果。
切勿重叠范围。切勿共享状态。始终有意识集成。

核心原则

独立性是关键

问题必须真正独立 - 无共享文件、无关根源、修复之间无依赖。

聚焦优于广度

每个代理获得窄范围：一个测试文件、一个子系统、一个清晰目标。广泛任务导致混淆。

清晰输出必需

每个代理必须返回摘要：发现了什么、修复了什么、改变了什么。无静默修复。

有意识集成

不要盲目合并代理工作。审查摘要、检查冲突、运行完整套件、验证兼容性。

快速开始

1. 识别独立域

按损坏内容分组故障：

文件A测试：工具批准流程
文件B测试：批量完成行为
文件C测试：中止功能

每个域独立 - 修复工具批准不影响中止测试。

2. 创建聚焦代理任务

每个代理获得：

特定范围： 一个测试文件或子系统
清晰目标： 使这些测试通过
约束： 不要更改其他代码
预期输出： 发现和修复的摘要

→ agent-prompts.md 用于提示模板和示例

3. 并行调度

// 在Claude Code / AI环境中
Task("修复agent-tool-abort.test.ts故障")
Task("修复batch-completion-behavior.test.ts故障")
Task("修复tool-approval-race-conditions.test.ts故障")
// 所有三个同时运行

→ coordination-patterns.md 用于调度策略

4. 审查和集成

当代理返回时：

阅读每个摘要 - 理解改变了什么
验证修复不冲突 - 检查相同文件编辑
运行完整测试套件 - 确保兼容性
抽查更改 - 代理可能犯系统性错误

→ troubleshooting.md 用于冲突解决

决策树

多个故障？
  └→ 它们是独立的吗？
      ├→ 否（相关）→ 单个代理调查所有
      └→ 是 → 它们能并行工作吗？
          ├→ 否（共享状态）→ 顺序代理
          └→ 是 → 并行调度 ✓

关键优势

并行化 - 多个调查同时发生
聚焦 - 每个代理范围窄，跟踪上下文少
独立性 - 代理不相互干扰
速度 - N个问题在1个问题的时间内解决

关键提醒

独立性是强制性的 - 相关故障需要单代理调查
聚焦胜过广度 - 每个代理窄范围防止混淆
始终验证集成 - 不要盲目合并代理工作
清晰输出必需 - 每个代理返回更改摘要
并行化有开销 - 仅对3个以上独立问题值得

红旗 - 停止

立即停止如果：

代理正在编辑相同文件（范围重叠）
从一个代理的修复破坏了另一个的工作（隐藏依赖）
您无法清晰分离问题域（不独立）
代理未返回摘要（无法验证更改）
集成需要重大重构（冲突）

当有疑问时： 从一个代理开始，了解情况，然后如果真正独立再调度。

与其他技能集成

先决条件： 对问题域和测试结构的基本理解 互补： 项目管理流程用于协调多个代理 领域特定： 测试技能用于理解测试故障

真实世界影响

来自调试会话（2025-10-03）：

6个故障 跨越3个测试文件
3个代理 并行调度
所有调查 同时完成
零冲突 代理更改之间
节省时间： 3个问题并行解决 vs 顺序

→ examples.md 用于详细案例研究

并行代理调度Skill DispatchingParallelAgents