Subagent 协作与限制

Subagent 将一部分工作放进独立上下文。主智能体可以直接处理任务，也可以委派；拆分是否有益取决于子任务是否边界清楚、能独立返回结果。

内置角色

角色	适合任务
explore	快速查找文件、阅读代码，返回聚焦答案
task	测试、构建和 lint，成功简述、失败保留完整输出
general-purpose	需要完整能力的复杂多步任务
code-review	查找缺陷、安全和逻辑问题，不修改代码
research	检索、验证并生成带引用的研究结果
rubber-duck	用互补模型提出建设性批评
security-review	聚焦高置信度、可利用的安全问题，不修改代码

内置角色默认模型可能随服务更新。需要指定工作方式时，使用角色配置和模型覆盖规则，不要仅根据主会话的模型名称推断全部子任务模型。

Review agents 不会把整份评审再次递归委派给另一个 review agent；code-review 可把安全部分交给 security-review，两者也可委派范围窄的事实查找。只有根智能体可用 store_memory 或 vote_memory 写入、投票记忆，subagents 保留 read_memories 读取能力。

范围明确的通信

list_agents 和 write_agent 是智能体工具，不是终端命令。启用 sibling communication 的父会话中，关系标签有 self、sibling 和 child。

工具范围	作用
list_agents 的 siblings	同一父智能体启动的同级角色
list_agents 的 children	当前智能体直接委派的角色
list_agents 的 all	所有可见角色，用于检查全局状态
write_agent 的 siblings / children	向对应范围发送同一消息

带 scope 的广播限于开启共享同级通信的 subagent；顶层会话应提供明确 agent_id。广播命中太多目标时会报错，需先列出再指定 ID。默认列表展示附近相关角色，不一定是完整会话树。

深度和并发

深度是嵌套层数，默认 6、最大 256；达到上限的最内层不能继续派发。并发是整个会话树中同时运行的 subagent 数量，达到上限后新请求被拒绝，直到已有任务结束。

截至本页核实日期，默认并发按套餐区分：

套餐或计费方式	默认并发
Free / Education	2
Pro / Pro+	4
Max	8
Business	16
Enterprise	32
Usage-based billing	32

按使用量计费的用户可通过 subagents.maxConcurrency 和 subagents.maxDepth 覆盖，上限分别 32 与 256，越界值会限制在有效范围；非按使用量计费的套餐忽略这些设置。不要把提高配置数字当成突破套餐限制。

多个独立任务的组织方式见Fleet，运行角色的指令继承见Agent 配置。

限额来源差异

同一命令参考的环境变量表另列并发默认 32 / 范围 1–256、深度默认 4 / 范围 1–128，与上述专门限制章节不同。不要把两组数字合并使用，也不要据此承诺环境变量可以绕过套餐；最终应核对当前版本的有效配置和实际限制提示。