路线阶段：AI Vibe Coding 第 4 章。
本章目标：让 AI 从“单线程助手”升级为“并行协作团队”。
学习目标
完成本章后，你应该能做到：
- 为不同代理定义清晰职责与交接协议。
- 将任务拆成可并行执行的子任务并避免写冲突。
- 建立代理间质量关口（结构审查、风险审查、验证审查）。
- 在保持一致性的前提下提升交付吞吐。
为什么需要多代理
单代理常见瓶颈：
- 上下文过大，推理质量波动。
- 复杂任务串行执行耗时高。
- “写代码”和“审代码”同角色，容易漏检。
多代理本质是把不同认知任务拆开。
角色划分
1. Planner Agent（规划）
负责：
- 任务分解
- 范围分配
- 依赖排序
输出：
- 子任务列表
- 每个子任务的输入/输出契约
2. Worker Agent（执行）
负责：
- 按子任务实现改动
- 自检与本地验证
- 输出变更说明
3. Reviewer Agent（审查）
负责：
- 风险扫描
- 回归点识别
- 测试缺口提示
子任务切分原则
- 写集（write set）互斥。
- 接口改动优先落地，再并行实现调用方。
- 高风险模块独立审查，不并行混改。
协作契约模板
[子任务ID] W-03
[目标] 新增结算页升级路径时间线UI
[可改文件] src/ui/result/*
[不可改文件] src/domain/combat/*
[依赖前置] P-02 已产出升级路径聚合接口
[验收] 3个快照用例通过 + 构建通过
[输出] 修改文件清单 + 风险说明 + 验证结果并行执行调度
推荐流程：
- Planner 先产出 DAG（任务有向依赖图）。
- 可并行节点同时执行。
- 汇总后交给 Reviewer 统一审查。
- 审查通过再合并。
合并冲突控制
文件层防冲突
- 为每个 Worker 分配独占目录或文件。
- 共享文件采用串行补丁策略。
接口层防冲突
- 接口改动由一个 Worker 持有。
- 其他 Worker 基于接口版本开发。
质量门
每个 Worker 交付必须带：
- 构建结果
- 核心测试结果
- 风险点列表
Reviewer 必须检查：
- 与任务契约是否一致
- 是否越界改动
- 是否遗漏边界条件
多代理协作示例
任务：新增“活动领奖记录导出”功能。
- Planner：拆成 API 层、UI 层、导出层 3 子任务。
- Worker A：实现 API 查询与数据模型。
- Worker B：实现 UI 页面和筛选交互。
- Worker C：实现 CSV 导出与下载。
- Reviewer：审查数据脱敏、导出性能、异常处理。
指标观测
比较单代理与多代理：
- 交付时长
- 合并冲突率
- 审查驳回率
- 回归缺陷率
目标不是“代理越多越好”，而是“吞吐和质量同时提升”。
常见坑
坑 1：角色边界不清
Planner 下场改代码会扰乱流程。职责必须固定。
坑 2：并行任务写同一文件
冲突成本高于并行收益。先做写集规划。
坑 3：Reviewer 只看格式不看风险
审查价值在于发现行为回归和测试缺口。
本月作业
跑一次真实多代理冲刺：
- 选一个中等复杂功能，拆成 3 个子任务并行。
- 记录每个子任务耗时、冲突和返工次数。
- 输出改进清单：哪些任务适合并行，哪些必须串行。
下一章：AI Vibe Coding 05《代码审查自动化：让AI先审一轮，再进人工评审》。