handoff

---

name: handoff description: 仅当用户显式调用 $handoff，或明确要求生成会话交接文档时使用。将当前对话压缩为脱敏、可执行的交接文档，供下一个 agent 接续工作；不要自动触发。

撰写一份交接文档，总结当前对话内容，使全新的 agent 能够无缝继续工作。

输出位置

先解析当前平台的系统临时目录，再保存为 handoff-YYYY-MM-DD-HHMM.md（用实际时间戳替换）。优先使用平台 API，例如 Python 的 tempfile.gettempdir()；在 Unix 环境可使用 $TMPDIR，未设置时回退到 /tmp。生成后告知用户完整绝对路径。

文档结构

按以下结构组织交接文档：

1. 背景与目标 — 一句话概述当前任务
2. 已完成工作 — 带路径/URL 引用
3. 当前状态 — 进展到哪一步、卡在哪里
4. 待办事项 — 下一个 agent 需要做什么
5. 推荐技能 — 建议调用的 skill 列表
6. 关键上下文 — 环境、分支、配置等必要信息

规则

• 不要重复已存在于其他产物（规格文档、计划、ADR、issue、commit、diff）中的内容，改为通过路径或 URL 引用。
• 脱敏处理：删除 API key、密码、个人身份信息等敏感内容。
• 如果用户传入了参数，将其视为下一次会话的重点方向，据此调整文档内容。
• 如果对话里没有值得交接的实质进展，如实说明并交出已有的少量内容，不要为了凑满结构而编造。