用途:为编写 Agent 工具调用提供指导。Task 工具在 v2.1.63 更名为 Agent,Task(...) 仍可作为别名使用。子代理本质是上下文隔离工具,它在自己的窗口消耗 token,只返回精简摘要,从而保持主窗口干净;但隔离也是失败面——委派提示是唯一入口,返回摘要��唯一出口,两者都需精确。
主要能力:提供委派门控决策表,区分内联、/btw、Fork、单子代理、并行扇出与独立验证者等路由;给出四部分委派契约(目标、输出、工具、边界),并可补充上下文块与目标锚点;说明模型与投入度两档调节,先降投入度再降模型档;提供并行扇出规模建议与上限;说明后台与前台模式、fork、worktree、remote 隔离等机制。参考文件为技能目录下的 references/mechanics.md、references/patterns.md、references/verifier-dispatch.md。
使用方式:主机提供子代理或委派工具时使用之,否则内联工作并说明主机无子代理面。撰写派发时,目标写成结果而非动作,输出给出确切交付形状与大小上限,默认约为 1,000–2,000 token 的精简摘要;显式加载技能,如 Skill(oberskills:write)、Read(/abs/path/to/reference.md);可复用代理定义优先使用 agents/ 中的 skills: frontmatter 字段。并行代理须相互独立,不重叠写入范围,按限流资源分组。
适用场景:自包含且产生大量冗长输出的任务、相互独立的同类处理项、需要独立校验的输出,以及广度优先研究等可分解任务。
限制:委派成本约为内联的 4 倍,多代理扇出约为 15 倍;需要反复交互、共享大量上下文、中途用户输入或快速小改时不宜委派。子代理看不到当前对话,不继承技能;无用户通道,harness 会剥离 AskUserQuestion。后台与前台由 harness 决定而非调用参数。fork 忽略模型覆盖,始终使用你的模型。具体平台、定价与模型阵容信息暂未提供完整实时数据,应以官方实时信息为准。