用途:把繁重或批量工作交给子代理,避免主上下文被文件、搜索结果和命令输出占满。主线程充当协调者,持有计划、决策与紧凑报告。
激活方式:分为两种。Scoped(限定)模式下,如“用子代理检查 X 和 Y”只分派 X 和 Y,其余任务主线程照常处理。Standing(常驻)模式下,“orchestrator mode”或“delegate everything”覆盖之后的所有请求,直到用户以任何措辞结束;期间若直接要求主线程做某件事,视为一次性例外,之后恢复模式。若请求太小、不值得付出新开子代理的开销,应说明并提供直接回答。
协调者自己可做:在常驻模式及限定模式指定任务中,只调用 worker 的 spawn、message、resume、wait、stop 工具;计划或待办工具;技能加载(读取 SKILL.md 或其引用文件);向用户提问或汇报的工具。其他动作都算分派,包括快速查看单个文件。返回的产物路径交给下一个需要的 worker;协调者依据摘要行动,摘要不足时用具体缺口 resume 该 worker。若环境提示偏向 shell 或文件工具,这些提示描述的是 worker 行为,应在交接中传递。如果没有 spawn 工具,应报告并按用户已授权的直接工作回退方式处理。
选择 worker:定位文件或代码、回答“X 在哪里”、浏览大量文件用只读搜索代理;修改或运行任何内容(编辑、命令、测试、查询、网络研究)用通用 worker 或名册中该领域的专门 worker(如 SQL、CI);验证他人输出用与写入者不同的 worker,条件允许时用只读。仅当任务需要本对话历史时才使用 fork。除非用户或消费技能设定,模型与推理强度保持未设置。
规模:一次查找为一次分派;比较或跨两个区域的修改为 2 至 4 个并行分派;功能级工作按依赖层级分波运行。同一区域的相关任务交给一个 worker,不同区域并行。除非环境另有更高上限,最多同时运行 4 个 worker(含嵌套)。超过上限的 spawn 会失败而非排队,需等一个完成后再次分派。保持分派扁平。
工作流:规划(按区域拆分,任务、拥有路径、完成条件、运行目录);分派(独立分派在同一消息中一起启动);收集(等待完成,用具体缺口 resume,同一分派三次失败后报告为阻塞);整合(小修改一个写入者,共享检出或外部资源的写入者串行,并行代码写入者各用 worktree 与分支,由一个整合 worker 合并);验证(写入者自查 diff 并运行覆盖其改动的检查,合并的并行工作、模式或数据变更、架构变更、多文件变更分派独立验证者,验证者报告问题、写入者修复、再验证);报告(先给结果,再给产物路径或 ID、验证结果与已知限制)。运行目录随会话消亡,值得复用的研究应让 worker 保存到仓库 docs/research/ 并报告路径。
交接:worker 只能看到其分派提示和环境加载的项目指令,看不到本对话、先前报告或其他 worker 读过的文件,也不能向用户提问。每次交接需写明任务与完成条件、拥有路径或资源、已授权限、目标、已有决策与原因、需标注的开放问题、先前发现的逐字引用、运行目录路径、要加载的技能路径,以及返回契约字段(如 status、files_changed、tests_run、verification_evidence、decisions_made、open_questions、artifact_path)。大发现与命令输出写入运行目录产物,只返回简短摘要与索引行。
限制:具体工具、模型名册、worktree 与并行写入细节依赖运行环境;资料未提供价格、平台与安装命令等信息。