| name | handoff |
| description | 压缩当前对话为交接文档,供下一个会话继续 |
| argument-hint | [下次会话的重点] |
Handoff — 会话交接
将当前对话压缩为一份交接文档,让新的 agent 会话能无缝继续工作。
触发方式
/handoff [下次会话的重点描述]
输出位置
保存到系统临时目录(macOS: /tmp/,Linux: /tmp/),不保存到工作区。
文件名格式:handoff-YYYYMMDD-HHmm.md
文档结构
# 交接文档
**生成时间**:YYYY-MM-DD HH:mm
**下次会话重点**:[用户传入的参数,或自动生成]
## 背景
[1-2 段话,描述当前项目状态和正在做的事]
## 已完成
- [列出本次会话完成的关键动作]
- [引用 commit、文件路径、而非重复内容]
## 未完成
- [列出待办事项,标注优先级]
## 关键决策
| # | 决策 | 理由 |
|---|------|------|
| 1 | ... | ... |
## 建议技能
- `/grill` — 如果需要继续追问领域问题
- `/write-code` — 如果方案已定,准备实现
- `/check-work` — 如果代码写完,需要审查
[根据上下文动态生成]
## 参考资料
- [链接到相关文件、commit、issue]
规则
- 引用而非重复 — 已有产物(plan.md、ADR、CONTEXT.md、commit、diff)只引用路径/URL,不复制内容
- 脱敏 — 移除 API key、密码、token、个人信息
- 聚焦 — 如果用户传入了参数(下次会话重点),围绕该重点组织文档
- 可执行 — 下一个 agent 读完文档后能直接继续工作,无需重新理解上下文
与 /grill-me 的区别
| 技能 | 场景 | 输出 |
|---|
/grill-me | 当前会话内,追问澄清 | 对话内回答,不写文件 |
/handoff | 跨会话,交接工作 | 写入文件,供新会话读取 |
停止条件