团队协作
使用 Relay 实现高效团队协作
团队交接一次任务，通常需要交出文件，也需要交代文件背后的工作状态：已经完成了什么，哪些结果需要检查，下一位成员应该从哪里继续。
当成员使用不同设备、按照不同时间工作时，这些信息尤其重要。发送者可能已经关机，接收者也可能由自己的 Agent 继续处理任务。
Relay 通过共享工作区，将文件、交接备注和持续更新的项目上下文放在一起。成员可以在方便时接手工作，并将下一次交付留在同一个工作区中。
Owner 负责这个工作区的管理
每个工作区都有一个 owner，即创建该工作区的账号。你可以将其理解为这个工作区的主用户。
Owner 负责创建邀请、分配成员角色、移除成员，以及管理工作区设置。成员仍然使用各自的账号登录，团队无需共用 owner 的登录信息。
工作区中的上传使用 owner 的账户存储额度。
无论 Bundle 由 owner、其他成员，还是成员使用的 Agent 上传，存储都计入该工作区 owner 的额度。一个 owner 创建的多个工作区，共用其账户存储额度。
因此，owner 可以统一管理项目访问和存储，而成员可以直接参与交付。
通过邀请加入，并选择合适的角色
Owner 创建邀请时，需要选择成员角色。组员打开邀请链接，登录同一个 Relay 服务，查看工作区、owner 和角色，再确认加入。
每条邀请仅供一人使用，默认在 24 小时后过期。Owner 可以撤销尚未使用的邀请。
成员权限分为 PUSH 和 FULL。Owner 拥有完整的工作区管理权限。
| 操作 | PUSH | FULL | Owner |
|---|---|---|---|
| 读取、下载和上传 Bundle | 可以 | 可以 | 可以 |
| 编辑 Bundle 备注和共享 Notes | 可以 | 可以 | 可以 |
| 创建和移动文件夹 | 可以 | 可以 | 可以 |
| 将 Bundle 移入回收站、恢复 Bundle | 不可 | 可以 | 可以 |
| 创建邀请、调整角色、移除成员 | 不可 | 不可 | 可以 |
| 管理工作区设置、导出、删除文件夹及永久删除 | 不可 | 不可 | 可以 |
PUSH 成员可以读取和下载工作区中的内容。这个角色适合需要接收任务、提交产物和更新上下文的日常参与者。
FULL 在此基础上增加 Bundle 回收站和恢复操作，适合需要参与内容整理的成员。
Owner 可以在协作过程中调整角色。成员也可以主动退出工作区。
让每次交付带上足够的上下文
Relay 提供三种相互配合的上下文载体：Bundle 备注、HANDOFF.md 和共享 Notes。
Bundle 备注：说明这一次交付
每个 Bundle 都需要填写交接备注，用简短文字说明文件的用途、当前进度和下一步。
评估已完成。report.csv 是汇总结果，failures.jsonl 是失败样本。请按 HANDOFF.md 中的分类规则分析失败原因。
接收者在下载之前，就能知道这份交付包含什么，以及接下来需要做什么。
在支持 --save-note 的 CLI 中，接收者还可以选择将完整备注保存为本地的 RELAY_NOTE.md，让这段说明与下载的文件一起保留。使用前可通过 relay bundle pull --help 检查支持情况。
HANDOFF.md：承载较长的任务说明
多步骤任务通常需要更多背景。发送者可以将 HANDOFF.md 放进上传目录，并在 Bundle 备注中指出它的位置。这份文档可以说明：
- 任务目标与当前进度。
- 输入文件和产物的位置。
- 所需环境与运行命令。
- 下一步操作和完成标准。
- 尚待确认的问题。
已有的任务文档也可以直接使用。关键是让接收者知道应该阅读哪份文档。
共享 Notes：维护项目的共同背景
工作区共享 Notes 适合保存持续有效的信息，例如环境说明、命名约定、评估标准和已经确认的决定。
Bundle 备注说明某一次交付。HANDOFF.md 展开某一项任务。共享 Notes 则帮助成员了解整个项目的工作背景。
团队可以据此建立一个简单的习惯：接手任务时，先阅读完整的交接备注，再阅读其中引用的任务文档，并结合工作区 Notes 继续工作。
一个团队与 Agent 共同参与的例子
假设 Alice 和 Bob 正在分析一批模型评估结果。
第一步，Alice 建立项目工作区
Alice 作为 owner，邀请 Bob 以 PUSH 角色加入。Bob 使用自己的账号访问工作区。
第二步，Alice 发布待分析的 Bundle
Bundle 包含评估报告、失败样本和 HANDOFF.md。备注说明评估已经完成，并指出需要继续分析的部分。
第三步，Bob 稍后接手
Alice 完成上传和发布后即可离线。Bob 可以在第二天打开工作区，也可以让自己已配置的 Agent 通过 CLI 接收文件。
第四步，Agent 阅读上下文并处理任务
使用 Relay Skill 时，Agent 先完整阅读 Bundle 备注，再阅读备注引用的 HANDOFF.md，随后在 Bob 授权的任务范围内开展分析。
第五步，Bob 将结果推回同一个工作区
新的 Bundle 包含分析报告、分类结果和运行日志。备注说明已完成的工作，并请 Alice 审阅仍有争议的样本。
Agent 使用其登录账号的工作区权限。Bob 的 Agent 以 Bob 的 PUSH 角色参与这次协作。
Alice 再次上线后，可以直接接收这次交付。历史记录帮助团队追溯发送者、来源设备和时间；任务完成情况则通过回传的产物与备注表达。
让团队按各自的时间继续工作
共享工作区让成员找到共同的文件和项目背景。角色权限明确谁负责日常交付，谁参与内容整理，谁管理访问和存储。
在这个基础上，团队中的人和 Agent 可以沿用同一套交接方式：发布文件，写清进度与下一步，完整阅读上下文，再将结果交回工作区。
发送者需要保持联网，直到上传和发布成功。接收者可以稍后上线，从已经交付的工作继续。
已在协作测试环境可用，公开开放安排会另行公布。