Handoff（对话移交）
编写一份移交文档，使新启动的 Agent 能够在无需重读整段对话的情况下继续当前工作。文档应捕获当前状态和意图，而非逐字记录对话内容。
保存位置
将移交文档保存到当前项目仓库内 —— 切勿保存在操作系统临时目录或对话内联中。
- 确定仓库根目录：执行
git rev-parse --show-toplevel。如果命令失败（非 Git 仓库），则回退到当前工作目录。 - 确保该根目录下存在
handoffs/文件夹；如缺失则创建。 - 写入到
handoffs/<slug>-handoff-<UTC-timestamp>.md，其中：<slug>是从任务（或传入的参数）中提取的短 kebab-case 主题词，例如notebook-proxy-review。<UTC-timestamp>格式为YYYYMMDDTHHMMSSZ，例如20260527T144059Z。 时间戳确保每个移交文档唯一 —— 切勿覆盖已有的移交文档。
- 写入完成后，打印所创建文件的绝对路径。
文档内容
如果该技能接收了参数，则将参数内容作为下一会话的关注重点，并使每个部分都倾向于该重点。
使用以下各部分。每个部分应控制在指定长度内；移交文档是一份指针文档，而非所有内容的记录。如果某部分确实无内容，则直接省略，而非填充空白。
- 标题 —— 标题、日期（UTC）以及一行说明下一会话的目的。（≤5 行）
- 目标 —— 目标及其成功标准。（≤3 句）
- 当前状态 —— 已完成的工作、可运行的部分、已验证与假设的内容。（≤10 条）
- 下一步行动 —— 为下一 Agent 提供的具体、有序的行动步骤。（≤8 条）
- 关键决策及理由 —— 已锁定的选择及其原因，避免下一 Agent 重新争论。（≤8 条）
- 陷阱 / 地雷 —— 已遇到的陷阱、意外情况、看似完成实则未完成的内容。（≤8 条）
- 相关文件与参考 —— 代码路径、URL、PRD（产品需求文档）、计划、差异对比、问题。仅引用它们，不要内联其内容。（≤12 项）
- 待定问题 —— 需要用户参与或进一步工作才能解决的未决策问题。（≤6 条）
- 建议的技能 —— 下一 Agent 应调用的技能，每条附上一行理由。（≤6 项）
规则
- 不要重复已存在于其他工件（PRD、计划、ADRs（架构决策记录）、问题、提交、差异对比）中的内容。应通过路径或 URL 引用它们。
- 不要在移交文档中粘贴大型文件内容或完整的命令输出。应指向来源。
- 对密钥和PII（个人身份信息）进行脱敏处理 —— 任何匹配
API_KEY/SECRET/TOKEN/PASSWORD/PRIVATE_KEY或个人信息的内容。本地文件路径可以保留。