handoff

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]

规则

1. 引用而非重复 — 已有产物（plan.md、ADR、CONTEXT.md、commit、diff）只引用路径/URL，不复制内容
2. 脱敏 — 移除 API key、密码、token、个人信息
3. 聚焦 — 如果用户传入了参数（下次会话重点），围绕该重点组织文档
4. 可执行 — 下一个 agent 读完文档后能直接继续工作，无需重新理解上下文

与 /grill-me 的区别

技能	场景	输出
/grill-me	当前会话内，追问澄清	对话内回答，不写文件
/handoff	跨会话，交接工作	写入文件，供新会话读取

停止条件

• 交接文档生成完毕 → 停止