用途:当用户希望为新会话建立临时上下文桥梁时使用。它生成一份短生命周期的指针文档,用于继续非工单类工作,而不是恢复已有运行、序列化工单状态或创建持久项目文档。
主要能力与边界:只收集持久指针,如路径、URL、issue 或 PR 编号、提交、摘要,并说明其重要性;不复制这些工件已持有的持久内容。写入前必须脱敏,将凭据、令牌、Cookie、个人数据等敏感值替换为精确标记 <REDACTED>,不复制对话记录,不保留不必要的命令输出。
使用方式:用 mktemp -d 在操作系统临时目录下创建私有目录,目录权限要求 0700,HANDOFF.md 文件权限 0600。文档按固定章节顺序写入:Purpose、Durable pointers、Remaining work、Limitations、Redacted context、Suggested skills、Expiry and deletion。Remaining work 以一条具体下一步行动开头;设置明确的 UTC 过期时间,须在 24 小时内;包含删除该私有临时目录的精确命令。空指针条目可省略,但章节不可省略,无安全内容时写 None。
限制:绝不写入项目工作区、仓库或其他同步文件夹,不暂存、提交或上传。不得用于恢复已有运行、序列化工单状态或创建持久项目文档,这些应使用 ticket-autopilot 或所属工作流。不得用于向 leaf、worker 或子代理传递上下文,该通道由 ticket-autopilot resume --events 的 schema-3 leaf-result 契约承载,并绑定到精确的 CandidateRef;handoff 无此绑定且会过期。完成后仅在聊天中确认路径和过期时间,不回显交接内容。
适用场景示例:为新会话继续某项设计调查而创建临时交接,指向关联的规格和提交。不适用示例:恢复已有运行并继续 U-06,或为某决策编写 ADR。
其他信息:官方文本暂未提供;具体安装命令、收费与平台支持暂未提供。