# Handoff

> 压缩当前对话为交接文档，供下一个会话继续

- Skill: `cnife/handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cnife/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cnife/handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: cnife (https://skillmd.com/u/cnife)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cnife/handoff

---


# Handoff — 会话交接

将当前对话压缩为一份交接文档，让新的 agent 会话能无缝继续工作。

## 触发方式

`/handoff [下次会话的重点描述]`

## 输出位置

保存到系统临时目录（macOS: `/tmp/`，Linux: `/tmp/`），不保存到工作区。

文件名格式：`handoff-YYYYMMDD-HHmm.md`

## 文档结构

```markdown
# 交接文档

**生成时间**：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` | 跨会话，交接工作 | 写入文件，供新会话读取 |

## 停止条件

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