子 Agent 的四个隔离维度
上下文来源、身份连续性、工作目录和文件改动空间分别控制不同边界。把它们混成一个「隔离等级」,容易误读恢复和 worktree 的真实行为。
能准确解释 ContextSource::New / Resumed、ResumeSourceData、SubagentIsolationMode,并根据任务选择新会话、恢复与 worktree。
隔离是一组正交维度
同一个 Resumed 子 Agent 可以复用 worktree,也可以继承普通 cwd。上下文连续与文件空间隔离要分别判断。
ContextSource::New
新会话不继承历史。spawn 流程建立新的 system prompt 和 prompt context,再接收当前任务输入。它不代表独立文件空间,文件空间仍取决于 isolation 与 cwd。
ContextSource::Resumed
从已完成的 peer subagent 继续。源码复制原始 transcript 与 tool state,模型沿用 source model;system prompt 和 prompt context 根据当前 AgentDefinition 重新渲染。
身份校验
- subagent_type 必须与 source 一致。
- 显式 Persona 必须与 source 一致;未显式给出则沿用 source。
- model 不参与身份 gate。请求中的 model override 会被软忽略,并 pin 到 source model。
恢复限制
- 复制 transcript 或读取失败时,显式 resume 会失败关闭。
- source transcript 超过目标模型上下文窗口 80% 时拒绝恢复。
- 恢复复制 tool state,不复制 plan state、plan mode state 与 signals。
None
子 Agent 使用解析后的 cwd,通常与父工作区相同。上下文窗口依然是独立子会话。None 描述文件工作空间隔离,不等于共享对话历史。
Worktree
子 Agent 使用独立 worktree 路径。恢复时优先复用 source worktree;路径已移除且存在 snapshot_ref 时,可从持久 git ref 重新水化。该枚举没有「sandbox」成员。
pub enum SubagentIsolationMode {
#[default]
#[serde(alias = "None")]
None,
#[serde(alias = "Worktree", alias = "work_tree", alias = "work-tree")]
Worktree,
}
快照说明:枚举完整保留,展示 wire alias。上方同心圆是课程视觉,用于强调维度正交,并非源码中的对象层级。
课堂练习:给两个任务选边界
任务 A 要继续昨天完成一半的重构,并保留原 worktree 未提交改动。任务 B 只需独立分析当前仓库。分别选择 New 或 Resumed、None 或 Worktree,并说明 transcript、model、cwd 与文件改动空间如何处理。