Handoff

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

cnife e66fe23 1.8 KB Updated

File contents

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 跨会话,交接工作 写入文件,供新会话读取

停止条件

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

cnife/pi-extensions/tree/main/archive/change-based-workflow/skills/handoff commit e66fe23f3e

Frequently asked questions

npx skillmds@latest add cnife/handoff