handoff 的用途是写出可由另一个上下文直接读取的事实性会话产物,重点在于让读者能凭精确路径与事实行动,而不必信任作者记忆。
主要能力与内容要求:记录调用方提供的目标与摘要;已完成产物及其精确证据路径(如 cli/internal/gates/regen.go);未决验收、发现、因果不确定性与风险;有界目标下还须记录观察到的原生停止/继续状态、剩余额度或明确测量缺口、当前 HOLD 事件所需 helper 是否已用;可选地附调用方提供的继续文本;必要时给出只读的仓库标识;以及允许的启动关联引用、源存储/项目/工作身份、运行时/会话/上下文 ID 或明确标注未知。
使用方式:由调用方在派发或启动时记录工作关联,并将产物写到调用方指定且获授权的交接位置,例如 .agents/ao/handoff/。新 CDLC 记忆/证据要求使用调用方选定的受保护外部非 Git 位置;缺少路由应作为缺口报告,不在消费者检出目录回退建文件。技能返回产物路径后停止。
限制:不得推断下一步、挑选工作、分配所有权、消费产物、改动 tracker 或 Git 状态、判定结论、管理重试或重启运行时;读取交接不得使其变更。报告中的 HOLD 或 NEEDS_OPERATOR 不代表原生目标已暂停,须记录实际观察状态。压缩或交接不会重置额度、修复边界或 helper 事件。缺失交接、缺失来源、未知长度、未观察 ID 或未证实关系必须显式保留,不得编造 ID 或把多工作会话归给单一 bead。读取或复制关联元数据前须检查源所有者与接收方/模型/目的地授权;BD/Dolt 有版本控制但不是密钥库;定位符不授予访问权。失败模式为乐观收尾,即把证据路径不存在的写成交付,使后续上下文建立在幻影之上;反模式是按时间线叙述过程,应改记终态事实。