Day 08 见过 Agent 工具（别名 Task）。当主 Agent 遇到一个"值得独立探索"的子任务时——比如"在整个代码库里搜集所有跟认证相关的代码"——它可以派一个子代理去干。好处：

• 上下文隔离：子代理搜集过程产生的一大堆中间信息（读了 50 个文件）不污染主对话，主 Agent 只拿到最终结论。
• 并行：可以同时派多个子代理（Day 08 讲 Agent 工具 isConcurrencySafe=true）。
• 专注：子代理有自己的 system prompt，可专门为某类任务优化。

核心洞察极简：子代理就是再跑一遍 Day 06 讲的那个 query() 循环，只是换一套输入。真实代码（packages/builtin-tools/src/tools/AgentTool/runAgent.ts:776）：

for await (const message of query({
  messages: initialMessages,          // 子代理自己的初始消息
  systemPrompt: agentSystemPrompt,    // 子代理专属 system prompt
  userContext: resolvedUserContext,
  canUseTool,
  toolUseContext: agentToolUseContext, // ★ 带独立 agentId
  querySource,
  maxTurns: maxTurns ?? agentDefinition.maxTurns,
})) {
  onQueryProgress?.()
  // ... 消费子代理吐出的消息
}

每个子代理有自己独立的一套：messages、systemPrompt、agentId、abortController（就是 L02 代码里传的那些参数）。它跑它的循环，主 Agent 看不到它的中间过程。

因为 toolUseContext.agentId 存在，query.ts 里很多"面向主 UI"的分支会跳过——子代理不生成工具调用摘要、不发 profiler、不跑 Stop hook 的后台任务，因为它不直接面对你的界面。

子代理跑完，怎么把结论给主 Agent？finalizeAgentTool（agentToolUtils.ts:277）取子代理最后一条 assistant 消息的文本作为结果。

子代理可用的工具会被裁剪——有个禁用清单 ALL_AGENT_DISALLOWED_TOOLS（src/constants/tools.ts），如 ExitPlanMode、AskUserQuestion、TaskStop、LocalMemoryRecall 等。

子代理调用它被允许的工具（如 Read/Grep/Bash）时，权限检查照常生效（Day 09）——回扣 Day 08："派子代理不弹权限，子代理干的活逐个受权限管"（权限下放）。

src/Task.ts 是比"同步子代理"更上层的后台任务抽象。它定义了几种 TaskType：local_bash（后台跑命令）、local_agent（后台跑子代理）、remote_agent、in_process_teammate（coordinator 用）、local_workflow（Day 19）。

coordinator 模式（feature('COORDINATOR_MODE')）是更成体系的多代理编排——回扣 gov-agents 教程 Day 04 的 supervisor 模式：

• coordinatorMode.ts：getCoordinatorSystemPrompt() 给协调者一段"你是协调者，用 Agent 工具派 worker"的 prompt。
• workerAgent.ts：定义 WORKER_AGENT，worker 的工具是"异步代理允许工具集"减去编排工具。
• 机制：协调者是主 query 循环里的模型，通过调 Agent 工具（subagent_type: "worker"）派发；worker 结果以 <task-notification> 消息回到协调者。

✋ 动手：对着真实代码读一遍

# 1. 子代理 = 递归 query（L02，本页精华）
sed -n '773,795p' packages/builtin-tools/src/tools/AgentTool/runAgent.ts

# 2. 结果汇回（L04）
sed -n '277,320p' packages/builtin-tools/src/tools/AgentTool/agentToolUtils.ts

# 3. 子代理工具裁剪清单（L05）
grep -n "ALL_AGENT_DISALLOWED_TOOLS" src/constants/tools.ts

# 4. Task 类型 + coordinator（L06/L07）
sed -n '6,20p' src/Task.ts
grep -n "getCoordinatorSystemPrompt\|WORKER_AGENT" src/coordinator/*.ts

# 5. 实操：让主 Agent 派子代理
bun run dev   # 输入：用 3 个子代理分别调研 A/B/C，汇总给我