Codex 多任务并行工作指南：拆分、协调与结果验收

多代理并行可以缩短调查和实现时间，但只有任务真正独立时才有效。把同一个模糊需求复制给多个代理，往往只会产生重复结果；让多个代理同时修改相同文件，则会增加冲突和遗漏。

## 哪些任务适合并行

- 后端接口调查与前端调用调查可以分别进行。 - 不同模块的只读审计可以同时进行。 - 实现与独立测试设计可以并行，但验收标准必须一致。 - 文档、数据迁移和部署检查可在边界清楚时分开。

具有严格先后依赖的任务不适合强行并行。例如数据库结构尚未确定时，不应让前后端分别猜测字段并同时实现。

## 拆分时写清五件事

每个子任务要有目标、输入、允许范围、禁止项和输出格式。说明它是否可以修改文件、拥有哪组文件，以及需要向主任务报告哪些证据。只写“帮我看看后端”无法判断何时完成。

## 避免文件冲突

为写入任务分配明确文件所有权，或者使用不同分支与工作树。公共类型、锁文件和迁移文件最好由一个负责人统一修改。只读代理可以共享仓库，但不能假设另一个代理尚未改变的状态会一直不变。

## 共享已确认事实

主任务应维护一份简短事实列表，例如真实接口、枚举值、测试命令和用户禁止项。子任务发现新约束时及时回报。不要让每个代理独立猜测相同业务规则，否则最后很难合并。

## 统一验收入口

并行任务完成后，必须由一个协调者检查整体 diff、跨模块接口、测试结果和冲突。各子任务局部通过，不代表组合后仍正确。最后至少执行一次集成验证和完整构建。

## 何时停止并行

- 两个任务开始频繁修改同一文件。 - 子任务依赖尚未确认的业务选择。 - 结果之间出现接口或数据结构冲突。 - 权限、部署或生产数据需要统一决策。

此时应暂停写入，先合并事实和方案，再继续。

## 结果交付

每个子任务应报告结论、证据、修改文件、测试与剩余风险。协调者只采用已验证且与整体约束一致的部分。多代理的价值来自清晰分工和并行证据，而不是代理数量本身。