Subagent

问题

主 Agent 处理一个大型重构，上下文里已经堆了 50 轮对话。现在它想"先让另一个实例独立调研一下这个 API 的用法"。

如果把调研过程塞进主对话：20 轮调研消息会污染主上下文，且主 Agent 的 todo、工具、系统提示词全部对调研可见——子任务不需要也不应该看到父任务的完整历史。每个子任务需要一份干净的上下文：自己的消息数组、自己的系统提示词、自己的工具集。

解决方案

一个 subagent 工具：传入子任务的 prompt，harness 启动一个新的 agent 循环（s01 的 agentLoop 本身就是可复用的！），配一份空消息历史，跑完后只把最终结果返回给父循环。

define("subagent", {
  type: "object",
  properties: { prompt: { type: "string" }, system: { type: "string" } },
  required: ["prompt"],
}, async ({ prompt, system }) => {
  // 子代理 = 同一个循环 + 全新的 messages 数组
  const result = await agentLoop(prompt, { system, tools: CHILD_TOOLS, maxSteps: 20 });
  return `[subagent 结果] ${result}`; // 只回传最终输出
});

工作原理

第 1 步：让 agentLoop 接受配置，成为可复用的引擎（不再是单一入口）。

export async function agentLoop(query, opts = {}) {
  const messages = [{ role: "user", content: query }];
  const system = opts.system ?? DEFAULT_SYSTEM;
  const tools = opts.tools ?? DEFAULT_TOOLS;
  let steps = 0;
  while (true) {
    if (++steps > (opts.maxSteps ?? 50)) return "(达到最大步数)";
    // ... 与 s01 相同的请求/执行逻辑，用 system/tools 变量
  }
}

第 2 步：子代理的工具集通常更小——调研子代理只需要 read_file + web_search，不该有 bash。工具隔离是上下文隔离的一部分。

const CHILD_TOOLS = [read_file_def, web_search_def]; // 不含 bash

第 3 步：父循环等待子代理完成。此时父循环是阻塞的——s13 会引入后台子代理，让父循环继续推理。

子代理的价值公式：隔离的上下文 + 受限的工具 + 简洁的接口（prompt 进、文本出）。父代理不必知道子代理内部发生了什么，只需消费它的结论。

试一下

运行 s06，试试：

• "调研这个目录的测试结构，然后告诉我应该在哪里加新测试"（子代理只读文件）
• "同时调研 A 和 B 两个问题"（观察父循环串行等待两个子代理）

观察重点：子代理结果进入父上下文后，父代理能否直接使用？子代理内部出错（比如找不到文件）时，返回给父代理的是什么——错误文本还是异常？