适用工具：Claude Code · Codex · Cursor · Copilot · 验证于 2026-08
单个 agent 会话的吞吐上限由上下文窗口和串行执行决定。本章解决的问题是：哪些工作可以拆给多个 agent 并行、怎么拆才不会互相踩、以及拆完之后怎么安全地合回来。
场景：手上有一批任务想同时派给多个 agent，但不确定哪些能并行、哪些必须排队。
做法：
把下面三件事并行派给三个 subagent，互不等待，全部完成后按类别汇总：
1. 审查 src/auth/ 的安全风险
2. 找出 tests/ 里没有断言的测试
3. 统计 src/api/ 中未被引用的导出
每个 subagent 只读代码，返回带文件路径引用的清单。
依据：Codex 官方建议从读多的任务（探索、测试、triage、总结）起步用并行 agent，并对并行写代码保持警惕——多个 agent 同时编辑会产生冲突和协调开销（Codex: Subagents）。
边界：每个 subagent 独立消耗 token，官方明确并行工作流比同等的单 agent 运行更贵；两分钟能串行做完的小事不值得编排开销。
反模式：把一条流水线（生成代码 → 写测试 → 跑测试）拆成三个”并行”agent——后两个只会空转，或基于过期状态工作。
场景：多个 agent 要同时修改同一个仓库的代码。
做法：
你负责实现搜索功能。文件所有权：
- 你只修改 src/search/ 与 tests/search/
- src/routes.ts 由另一个 agent 统一修改；你需要新路由时，把路由声明写到 src/search/ROUTES.md
- 接口契约：searchItems(query: string, limit: number): Promise<Item[]>，不得更改签名
完成后不要合并，停在分支上等待集成指令。
依据：Codex 官方指出多个 agent 同时编辑代码会产生冲突并增加协调开销（Codex: Subagents）；Anthropic 对并行会话的对应建议是用隔离检出让”edits don’t collide”（Claude Code 官方指南）。
边界：所有权表本身有维护成本。两个 agent 各改一个互不相干的目录时，prompt 里一句”只改 X 目录”即可，不需要完整的表。
反模式：让两个 agent”改完自己解决冲突”——冲突解决发生在双方都看不到对方意图的时刻，产物是缝合怪。
场景：在同一台机器上跑多个 agent 会话，各做各的分支，要求文件系统层面互不干扰。
做法：
git worktree add ../myrepo-auth -b agent/auth
git worktree add ../myrepo-search -b agent/search
cd ../myrepo-auth && claude
cd ../myrepo-search && codex
cd ../myrepo
git merge agent/auth
git merge agent/search
git worktree remove ../myrepo-auth
git worktree remove ../myrepo-search
git branch -d agent/auth agent/search
git worktree list
git worktree list 最后应只剩主检出一行；若 remove 报错说明 worktree 内有未提交改动，先回去处理再清理。
isolation: worktree，由工具在会话内自动创建并守护隔离检出，不需要手工执行上述命令。依据：Anthropic 官方把 worktree 列为并行会话的第一种形态——”run separate CLI sessions in isolated git checkouts so edits don’t collide”（Claude Code 官方指南）；isolation: worktree 字段及其强制检查见 Claude Code: Subagents。
边界：worktree 共享同一个对象库但不共享未跟踪文件——node_modules、构建缓存要在每个 worktree 里单独安装。纯只读探索任务不需要 worktree，读操作本来就不冲突。
反模式：多个写代码的 agent 共用一个检出，靠”盯紧一点”避免互相覆盖。
场景：一个复杂任务既要大量搜索代码，又要动手修改，还需要独立把关；全部塞进主会话会撑爆上下文。
做法：
---
name: code-reviewer
description: Reviews diffs for correctness, security, and missing tests
tools: Read, Glob, Grep
model: sonnet
---
你是代码评审者。只报告影响正确性或既定需求的缺口，
附文件路径与行号，不提风格意见。
.claude/agents/*.md（用户级 ~/.claude/agents/），Codex 用 .codex/agents/*.toml（用户级 ~/.codex/agents/），Cursor 用 .cursor/agents/*.md 并兼容读取 .claude/agents/ 与 .codex/agents/；Copilot 官方文档（截至验证日期）没有 subagent 定义文件机制，其可核实的按需定制入口是 agent skills。依据：Claude Code 定义了只读的 Explore/Plan 内置 subagent 与 .claude/agents/ 自定义格式（Claude Code: Subagents）；Codex 内置 default/worker/explorer 并从 .codex/agents/ 读取 TOML 自定义 agent（Codex: Subagents）；Cursor 内置 Explore/Bash/Browser 并列出三个兼容目录（Cursor: Subagents）；对抗式评审 subagent 的用法见 Claude Code 官方指南；Copilot 的 skills 目录见 Copilot: About agent skills。
边界：评审型 agent 被要求找问题时总能找出一些。Anthropic 官方提醒：只处理影响正确性或既定需求的发现，其余当可选项——否则评审意见会把实现推向过度设计。
反模式：给评审型 agent 写权限——它会顺手”修掉”发现的问题，评审和实现又混回同一个上下文。
场景：同构的机械任务重复出现在几十个文件或多个仓库：升级依赖、替换废弃 API、统一 CI 配置。
做法：
repos.txt），不要边扫描边修改。# Claude Code：对清单里的每个仓库跑同一个修复
for repo in $(cat repos.txt); do
(cd "$repo" && claude -p "把 CI 配置里的 node 18 升级到 22，改完运行 npm test，最后只输出 OK 或 FAIL" \
--allowedTools "Edit,Read,Bash(npm test),Bash(git commit *)")
done
# Codex：读写沙箱内跑同一任务，JSONL 输出便于脚本收集结果
for repo in $(cat repos.txt); do
(cd "$repo" && codex exec --sandbox workspace-write --json \
"把 CI 配置里的 node 18 升级到 22，改完运行 npm test")
done
OK/FAIL 或 --json 事件流），失败项收集后单独重派，不混在成功批次里重跑。依据：Anthropic 官方的 fan-out 模式即”生成清单 → 循环调用 claude -p → 小样本试跑再放量”，并用 --allowedTools 限权（Claude Code 官方指南）；claude -p 与 codex exec 是两家官方的脚本化入口，后者默认只读沙箱、写操作需显式 --sandbox workspace-write（Claude Code: Headless、Codex: Non-interactive mode）。
边界：需要跨文件判断力的任务（架构调整、边界模糊的重构）不属于批量派发。--sandbox danger-full-access 只用在隔离的 CI runner 或容器里，Codex 官方对此有同样限定。
反模式：跳过小样本直接对 2000 个文件放量——prompt 的第一个缺陷会被原样复制 2000 遍。