Relay 让带上下文的任务跨设备交接成为可能

用交接备注说明下一步

在 Relay 中，每个 Bundle 都需要填写交接备注。它为接收端提供一个明确的起点。例如，工作站上的 Agent 交付了以下文件：

evaluation/
├── report.csv
├── failures.jsonl
└── HANDOFF.md

随这批文件附上的备注可以是：

本轮评估已完成，失败样本见 failures.jsonl。请先阅读 HANDOFF.md，再分析失败原因并整理报告。本次交接只做结果分析，无需重新运行评估。

接收端在使用文件前，就能知道这批产物的用途、详细说明的位置，以及下一步的工作范围。

交接备注适合保持简短。任务越复杂，越需要把详细信息整理成一份随文件交付的文档。

用交接文档保留详细上下文

一份实用的交接文档，应当让接收端能够理解当前状态，并找到继续工作的依据。上面的 HANDOFF.md 可以这样写：

# 评估结果交接

## 任务目标
分析本轮评估中的失败原因，并提出后续改进建议。

## 当前进度
评估已完成，结果已导出。
尚未逐条分析失败样本，也未验证改进方案。

## 文件说明
- report.csv：各项指标的汇总结果。
- failures.jsonl：需要进一步分析的失败样本。

## 下一步
1. 阅读失败样本，按原因分组。
2. 为各组选择有代表性的案例。
3. 整理分析报告，并区分已确认结论与待验证推测。

## 工作范围
本次只分析已有结果。
不重新运行评估，不修改模型或评估配置。

## 完成标准
生成分析报告，包含失败分类、代表案例和待验证问题。

多步骤任务推荐随文件附上 HANDOFF.md，并在备注中指出它的位置。已有任务说明或实验记录能提供足够上下文时，也可以继续使用。文件名是约定，简单任务仍可以只用一条备注完成交接。

对于代码任务，文档还可以记录代码版本、运行方式和已经执行的检查。对于研究或数据任务，则可以补充来源、处理步骤和仍未解决的问题。内容应围绕接收端继续工作所需的信息展开。

接收流程从完整阅读开始

上下文写好了，还需要进入接收端的工作流程。

Relay Skill 将完整阅读交接备注设为固定的接收步骤。Agent 在收件箱或列表中选择 Bundle 后，需要读取完整备注；如果手中只有 Bundle ID、表格预览或不完整内容，则查询 Bundle 详情补齐。

下载文件后，如果备注指向某份交接文档，Skill 要求 Agent 完整阅读该文档，再结合当前任务要求继续工作。

需要在本地保留备注时，先检查 relay bundle pull --help 是否列出 --save-note。支持时，运行 relay bundle pull <bundle-id> --output ./incoming --save-note，将完整备注保存为 RELAY_NOTE.md。它与发送者提供的 HANDOFF.md 分开。此选项按需使用，不覆盖已有文件；旧 CLI 可以保留从 inbox 或 show 读取的备注。

以刚才的评估任务为例，接收端的第一项工作是阅读交接说明，确认评估已经完成，再开始分析失败样本。这样，发送端记录的进度和工作范围才能实际影响后续操作。

两台设备可以按各自的时间工作

发送端需要保持联网，直到上传与发布成功。此后，接收端可以稍后上线，进入有访问权限的同一工作区，再取回 Bundle。

这适合许多分阶段进行的任务：工作站生成结果，笔记本负责复核；一台设备整理研究材料，另一台设备继续写作；一个 Agent 完成产物，另一个 Agent 根据交接说明处理下一步。

Relay 传递文件和书面上下文。接收端据此理解任务进度，并准备继续工作所需的代码、工具或环境。交接的质量也取决于发送端是否准确记录了完成情况、未决问题和下一步。

当你准备结束一段工作时，可以留下产物，再写清楚接下来的任务。下一台设备上线后，就有一个明确的起点。