子代理委派与 Agent 工具

主 Agent 可以通过 Agent 工具按需调度内置或自定义子代理，把专业子任务外包出去。本 skill 回答四个问题：何时委派、委派给谁、怎么调用、系统约束是什么。

工具清单

加载：Agent 为核心工具，始终可用，无需 ToolSearch 激活。

委派决策

用户消息 →
  ├─ 简单问答 / 闲聊 / 读取 / 查询 / 单步副作用（创建事件、发邮件、建项目）→ 主 Agent 直接做
  └─ 多步骤复杂任务 →
      ├─ 网页交互（点击/填表/登录/截图/翻页抓取）→ browser
      ├─ 富文本 / 长文档编辑（Markdown、DOCX、PDF）→ doc-editor
      ├─ 表格数据分析 / 图表生成 → data-analyst
      ├─ PDF / 图片 / 网页结构化提取 → extractor
      ├─ 画布节点操作 / 布局 → canvas-designer
      ├─ 代码编写 / 调试（仅全局模式；项目模式下 PM 自己做）→ coder
      └─ 混合任务 → 主 Agent 拆解后依次或并行委派多个子代理

别"什么都委派"：简单问答、单步操作、纯读任务用主 Agent 直接做。委派本身会引入上下文传递开销和额外步数，小任务得不偿失。

六个内置子代理

每个子代理都有独立的 system prompt 和工具集，步数按任务性质调整。

Agent 工具调用

Agent { description: "爬取 A 站产品表", prompt: "...", subagent_type: "browser" }

Agent 工具默认同步等待子代理完成并返回结果——调用后直接拿到输出继续下一步，不需要额外的等待工具。

SendMessage：追加指令

子代理已创建但需要追加指令或修正方向时：

SendMessage { toolCallId: "agent-xxx", message: "补充要求：结果用 JSON 格式输出" }

SendMessage 自动恢复已停止的 agent，不需要重新 Agent 创建，避免重新传递完整上下文的开销。

并行扇出-汇总

子任务互不依赖时，在同一轮内同时发出多个 Agent 调用，各自同步返回后主 Agent 汇总：

主 Agent 拆解任务 → 并行发出：
  Agent { description: "爬 A 站", subagent_type: "browser", prompt: "..." }
  Agent { description: "爬 B 站", subagent_type: "browser", prompt: "..." }
  Agent { description: "爬 C 站", subagent_type: "browser", prompt: "..." }
  ↓ 各自同步返回 A / B / C
主 Agent 汇总 → 最终回复

能并行：子任务独立、并行能显著缩短总耗时。 不能并行：后任务依赖前任务的输出（串行依赖）；总数超过并发上限 4 需要分批。

上下文继承

子代理自动继承主 Agent 的：

• projectId —— 同一项目沙箱，路径权限和文件访问一致
• pageContext 对应的 skill —— 子代理看得到相同的能力认知（主 Agent 在 email 页创建 extractor，后者也看得到 email-ops）
• 临时项目路径 —— 如果主 Agent 已创建临时项目，子代理共享该目录

这意味着你不需要在 prompt 里重复传递环境信息，子代理能从继承的上下文推导。

系统硬限制

子代理的流式输出通过 data-sub-agent-start / delta / chunk / end 事件推送前端，每个 toolCallId 对应一条独立流，支持多个并发子代理同时流式输出。状态流转：output-streaming → output-available | output-error。

常见误判

• 别层级嵌套：子代理不能再 spawn 子代理。需要更深层级时重新拆解，让主 Agent 按顺序调用多个子代理。
• 别用错类型：要页面交互选 browser，只需读静态页用 WebFetch（主 Agent 自己就能调）；要 OCR 选 extractor，要精确 DOM 操作选 browser。
• 别在已有子代理时重新 Agent：用 SendMessage 追加指令，复用已有上下文。
• 别把简单任务委派出去：一次读取、一次查询、一次创建——主 Agent 自己做比委派快得多。