子代理编排(Explore / Plan / Task)
模式来源结构:langgraph-claude-code subagent + Task。
类型与用途
| subagent_type | 用途 | 约束 |
|---|---|---|
| Explore | 快找文件、关键词、回答「代码在哪/怎么走」 | 只读;thoroughness: quick/medium/very thorough |
| Plan | 基于探索结果做实现设计 | 只读;输出计划与关键文件 |
| general-purpose | 复杂多步调研或执行(按产品授权) | prompt 写明是否允许写代码 |
何时用 / 不用 Task
用: 范围不清、需多处搜索、要并行多视角、显著代码块后的专项审查。
不用: 已知精确路径;单文件内搜;class Foo 一类可用 Glob 一次命中。
调用契约
每次调用提供:
description:3–5 词标题prompt:自包含任务(背景、范围、禁止事项、返回字段清单)subagent_type
子代理 无状态、单次回报;主代理必须把结果摘要给用户(子结果默认对用户不可见)。
并行
用户要求并行或明显独立时:同一轮消息发出多个 Task。
计划模式 Phase1:最多 3 个 Explore,能少则少。
Explore 行为要点
- Glob 扩匹配 → Grep 内容 → Read 精读
- 最终报告用绝对路径 + 必要片段
- 不改系统状态
Plan 行为要点
- 吃透需求与指定视角
- 只读摸清现有模式与类似功能
- 步骤化方案 + Critical Files
- 禁止任何写操作
Prompt 模板(主代理 → 子代理)
目标: ...
上下文: [关键绝对路径与已读结论]
约束: 只读 / 或允许编辑
thoroughness: quick|medium|very thorough
请返回:
1) 结论摘要
2) 绝对路径列表与原因
3) 风险/未知项
4) 建议的下一步(供主代理,勿直接改用户仓库除非授权)
禁止
- 把含糊一句「看看认证」丢给子代理
- 子代理结果不摘要直接消失
- 已知文件仍开 Explore 浪费延迟