技能
Utility
会话交接写入器
/dr-save 的生产者契约——写入自包含的会话产物,采用仅追加语义、按层限额,并强制声明来源。
概述
session-handoff-writer 技能是跨运行时会话交接系统的生产者侧。它由 /dr-save 加载,并指示 agent:本次会话将被销毁——因此现在必须捕获恢复所需的一切。
关键概念
- 生产者感知条款 — 会话将被销毁;捕获 git 状态、任务状态、相关文件、未决问题以及失败的尝试。
- 5 层正文 — 第 1 层(git 状态,以及对于已分类的敏感来源,紧凑的脱敏来源绑定;不可截断),第 2 层(活动任务),第 3 层(相关文件),第 4 层(未决问题),第 5 层(失败的尝试,不可截断)。
- 仅追加语义 — 同一会话中的第二次
/dr-save会追加一个新块;先前的块永远不会被截断。 - 32 KB 上限 — 第 1 层和第 5 层受保护,不会被截断;如果正文超出预算,则优先截断第 3/4 层。如果受保护层无法容纳,或现有会话没有容量容纳新块,写入器将以非零状态失败并且不发布任何内容;现有会话字节保持不变。
- 声明来源 — 每一行包含
pushed/merged/deployed/green/passing的内容都必须带有verified:或assumed:。写入器会拒绝未标记的声明(退出码 1)。
规范来源
完整契约见 Datarim 仓库:skills/session-handoff-writer/SKILL.md。