智能体协调

智能体用于计划、委派和寻求帮助的工具。

除了执行工作之外，代理还有用于 组织 工作的工具——规划多步骤任务、委派给专家、创建子代理，以及在确实存在歧义时暂停并询问用户。

该家族中的工具

工具	功能
todo_write	在长任务中维护结构化的待办列表。随着工作推进逐项标记为完成。
spawn_subagent	默认委派给可复用的异步专家；只有在不兼容或被要求时才创建新的工作进程。
spawn_async_subagent	具有相同持久会话标识的更底层、可复用异步委派接口。
steer_subagent / wait_subagent	通过持久的运行中的工作进程发送消息或收集结果 subagent_session_id 或临时 task_id.
list_subagents / close_subagent	检查父线程的可复用工作进程，或显式将其退役。
spawn_worker_thread	显式后台工作，作为单独的工作线程进行跟踪。
delegate	将任务交给专家（例如具有不同提示/工具/权限的原型）。
archetype_delegation	路由到指定原型——编码员、研究员、规划员等。
skill_delegation	交给一个 技能 安装在工作区中的。
ask_clarification	暂停并向用户提出一个明确的问题，而不是猜测。
plan_exit	退出规划阶段并开始执行。
check_onboarding_status / complete_onboarding	根据用户是否已完成入门来限制行为。

spawn_subagent 而原型委派调用接受一个可选的 模型 字段，用于一次性的精确模型固定值。若省略，测试框架会在存在时使用配置级别的按代理固定值，否则回退到常规的模型路由提示。模型、工具集、沙箱模式、父线程、操作根目录和任务键都属于可复用子代理兼容性的一部分，因此实质不同的工作会获得单独的工作进程。

可复用委派会同时返回一个临时的 task_id 和一个持久的 subagent_session_id。跨轮次后续跟进时优先使用持久 ID。仅在 fresh: true 用户或任务需要一个干净的工作进程时传入；传入 blocking: true 仅在父级必须同步等待子级结果时。

为什么这些是工具，而不是隐式行为

当代理试图把所有内容都放在一个脑子里时，长任务就会崩溃。通过 TODO 和子代理拆分工作意味着：

• 每个子代理都会为同一个逻辑任务保留有用的本地上下文，而不是每轮都重新生成。

• 主线程保持对进度的高层视图。

• 一个分支中的失败不会污染其他部分。

请求澄清也是一种工具，且是有意为之：它让“我应该询问用户”成为一个 可见的 代理可以被引导做出的决策，而不是一种涌现行为。

另请参阅

• Coder - 编码员原型子代理通常使用的内容。

• 潜意识循环 - 始终在线的后台代理线程。