handoff

交接

交接之所以有效，是因为下一个上下文可以依据准确的路径和事实采取行动， 而不必相信作者的记忆；读者无法从产物本身核实的任何一行，都只是修饰， 而非交接内容。

提示词

Write a handoff for this session in agentops-wt/train2-c: goal was
migrating regen to Go, I finished cli/internal/gates/regen.go and left
scripts/regen-all.sh untouched, tests are green, and the next context
still needs to update docs/CI-CD.md. Write it to .agents/ao/handoff/.

满足以下条件即表示有效

无需阅读说明文字，即可从跟踪记录中观察到：

• 每个已完成的事项都列出准确的证据路径，例如 cli/internal/gates/regen.go，而不是按时间顺序叙述。
• 产物写入调用方指定的授权路径；新的 CDLC 证据使用明确选定的外部非 Git 位置。
• 读取该确切产物路径后，可以看到已写入的内容。
• 只有调用方提供的 continuation 文本会作为后续操作出现；不会臆造负责人、跟踪状态或结论。

合约

撰写一份事实性会话产物，供其他上下文读取。包括：

• 调用方提供的目标和摘要；
• 已完成的产物及确切证据路径；
• 尚未解决的验收事项、发现、因果不确定性和风险；
• 对于有界目标，记录观察到的原生停止／继续状态、测得的剩余额度或明确的测量缺口，以及当前 HOLD 事件的唯一助手是否已使用，并附上现有证据引用；
• 可选的调用方提供的继续文本；
• 有用时，尽力以只读方式确定仓库身份；
• 获准的启动关联引用、源存储／项目／工作身份，以及观察到的运行时／会话／上下文 ID，或明确标注未知；
• 分别提供有证据支持的父级和恢复链接、观察来源及截止点，以及任何有证据支持的工作区间及可用的冻结源边界和摘要，遵循 会话关联。

调用方在派发／启动时记录工作关联，并在启动时通过原生注释／元数据或运行时事实记录观察到的原生身份。交接补充结束状态证据；不得成为首次或唯一的工作／会话关联。对于中断的会话，只能依据获准的启动记录和原生观察重建。缺失的交接、缺失的来源、未知的长度、未观察到的 ID 或未经证实的关系都必须明确标注；绝不捏造 ID，也不把整个多工作会话归属到单个 bead。即使后续证据解决了关联问题，也要保留较早的未知／失败观察记录。

读取或复制关联元数据前，先核实来源所有者和接收方／模型／目标位置的授权。BD/Dolt 是有版本管理的，不是秘密存储。必要时使用获准的不透明定位符；未经授权，不得向目标位置提供受限摘录和敏感路径。定位符不授予访问权限。

不得推断下一步行动、选择工作、分配所有权、使用该产物、改变跟踪器或 Git 状态、判定结论、控制重试或重启运行时。读取交接内容不得使其发生变更。报告中写明 HOLD 或 NEEDS_OPERATOR，不代表原生目标已暂停；应记录实际观察到的状态以及仍需执行的操作员操作。压缩或交接绝不会重置额度、修复上限或助手事件。保留有信息价值的否定和撤回声明及其来源，不要把知识描述成单调递增且始终正确。

命名失败模式——乐观结案：为证据路径并不存在的工作写下“已完成”，导致下一个上下文建立在虚构事实之上。

反模式：按时间顺序叙述会话（“首先我尝试了……然后……”）。 纠正方式：记录最终状态事实——产物、路径、未解决的风险——省略过程。

将产物写入调用方拥有且已获授权的交接位置。对于新的 CDLC 记忆／情节证据，必须使用调用方选择的受保护外部非 Git 位置；缺少路由属于需要报告的缺口，不得在消费者检出目录中使用备用文件。保留现有的指定证据。独立的非 CDLC 交接保留下方明确要求提供证明时的默认行为。不存在永久通用的交接存储——无人使用的产物只是临时文件。

如果 Markdown 更适合人类阅读，该技能可以写入 Markdown。下方现有的 ao session handoff 和 ao session rehydrate JSON 兼容行为本身并不能建立启动关联或外部 CDLC 路由；只能使用实际目标位置支持与本次调用相符的命令。

早期默认兼容性

已存储在 .agents/handoff/ 下的 JSON 构件仍为只读证据。ao session handoff 会将新的 JSON 写入 .agents/ao/handoff/，而 ao session rehydrate 会搜索这两个目录，并选择字典序最新的交接 ID；如果两个目录中存在同名文件，则以规范路径 .agents/ao/handoff/ 下的副本为准。没有任何命令会移动或删除旧文件。面向人工编写的 Markdown 消费者会收到确切路径，因此无需扫描这两个默认目录。本技能自身的契约是兼容性的权威依据；无需单独的迁移构件。

返回构件路径并停止。