---
source: ../../../core/agent-dispatch.md
source_version: 1.0.0
translation_version: 1.0.0
last_synced: 2026-03-24
status: current
---

> **语言**: [English](../../../core/agent-dispatch.md) | 简体中文

# 代理派遣与并行协调

**版本**: 1.0.0
**最后更新**: 2026-03-20
**适用范围**: 使用多代理编排的 AI 辅助开发
**范围**: universal
**灵感来源**: [Superpowers](https://github.com/obra/superpowers) — dispatching-parallel-agents, subagent-driven-development (MIT)

---

## 目的

定义 AI 子代理的并行派遣、工作协调与状态回报标准。确保高效并行化的同时，防止文件冲突与集成失败。

---

## 术语表

| 术语 | 定义 |
|------|------|
| 子代理 | 由编排器生成的用于处理特定任务的 AI 代理 |
| 独立域 | 与其他任务没有共享可变状态的任务范围 |
| 状态协议 | 子代理必须回报的标准化返回状态 |
| 文件冲突 | 多个代理同时修改同一文件 |

---

## 核心原则 — 并行前先确认独立性

> **派遣代理并行执行前，必须验证其任务域是独立的（无共享可变状态）。**

---

## Prompt 设计原则

每个子代理的 prompt 必须遵循三个原则：

### 1. 聚焦（Focused）

每个代理只处理单一问题域，不混合无关任务。

### 2. 自足（Self-contained）

Prompt 包含执行所需的完整上下文，代理不需要额外提问或搜索。

### 3. 明确输出（Specific Output）

明确定义期望的返回格式。

---

## 独立性验证

在并行派遣前，必须检查以下条件：

| 检查项 | 条件 | 失败时处理 |
|--------|------|-----------|
| 文件集合不相交 | 两个任务不修改相同文件 | 串行执行 |
| 无共享可变状态 | 任务间不依赖共享变量 | 合并为单一任务 |
| 无执行顺序依赖 | 任务 B 不需要任务 A 的输出 | 串行执行 |

## 状态协议

每个子代理必须返回标准化状态：

| 状态 | 含义 | 后续动作 |
|------|------|---------|
| `SUCCESS` | 任务完成，所有验证通过 | 整合结果 |
| `FAILED` | 任务失败，附带错误详情 | 分析失败原因 |
| `BLOCKED` | 任务被外部依赖阻塞 | 解除阻塞后重试 |
| `PARTIAL` | 部分完成，附带进度说明 | 评估是否继续 |

## 冲突预防

### 文件级隔离

```
代理 A: src/auth/**        ← 独立域
代理 B: src/payments/**    ← 独立域
代理 C: src/shared/**      ← ⚠️ 不可并行（共享域）
```

### 合并策略

| 情况 | 策略 |
|------|------|
| 无冲突 | 自动合并 |
| 格式冲突（仅空白/排序） | 自动解决 |
| 语义冲突 | 人工审查 |

---

## 相关标准

- [Git Worktree 隔离](git-worktree.md)
- [分支完成工作流程](branch-completion.md)
- [AI 模型选择策略](model-selection.md)

---

## 许可证

本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
