handoff

生成一份独立完整的上下文载荷，让新的 Agent 无需重新推导或重新学习本次会话已经确定的内容，就能继续推进工作。参数说明了下一次会话的目的——据此决定要记录什么、舍弃什么。

记录来之不易的成果——任何新会话原本都必须重新完成的事项。每条随交接内容一并传递的信息都要附上依据，让接收者继承的是当前可用的工作状态，而不只是结论。示例（仅供参考，并非必需）： 已敲定的决策应附上考虑过的备选方案及最终选择该方案的原因；已验证的事实应附上验证方式（文件：行号、命令输出、文档 URL）；尚未解决的问题应说明如何才能解决。

说明下一次会话获指派的活动和范围、委派选择的来源和限制、保留的决策，以及任何已接受的产物或版本。保留当前撤回事项和等待条件，并说明恢复工作的途径。交接不会授予超出交接发起者权限的权限；后续工作的提议仍然只是提议。

说明当前的验收主张、硬性要求和可调整的工作版本范围，以及重要审查意见、其证据和重新审议的条件。纳入尚未完成的强制性工作，以及需要刷新的证据，而不只是先前的结论。

如果接收者可以访问正确的产物或版本，优先引用它们。如果无法访问，则在载荷中说明必要的约定和后续状态，并指出无法访问的来源及证据的局限。仅提供本地路径无法支持跨主机交接；避免复制无关历史，或重复接收者已经可以读取的内容。

当后续工作适用相应技能时，指出下一位 Agent 应调用哪些技能——接收者可能不知道它继承了哪些工具。

删除凭据、令牌和个人数据。载荷可能长期留存，也可能被原样用作另一位 Agent 的提示词。应指出机密信息所在位置（环境变量名称、保管库路径），而不是写出其值。

格式由 Agent 自行决定。章节名称、标题、采用散文还是列表、内容顺序——均应由交接目的决定。

将文件写入 ~/.manifest-dev/handoffs/handoff-{timestamp}-{id}.md（创建目录；~ = $HOME / %USERPROFILE%），其中 {timestamp} 为 UTC 时间，格式为 YYYYMMDD-HHMMSS，{id} 为四位随机十六进制字符。仅在目标路径尚不存在时创建文件；若路径已被占用，则重新生成 {id}，以免同一秒内生成的两个交接文件相互覆盖——将文件保存在可靠的位置，确保操作系统清理临时文件时交接内容不会丢失。仅当主目录不可写时，才退而写入可写的临时路径。如果参数是先前交接文件的路径，先阅读该文件，再根据当前状态写入一份新的文档——纯粹重写，不追加内容。