handoff — 会话交接
- 触发方式:
/handoff或关键词「交接」「handoff」「continue this」 - 适用场景: 长任务分段执行、多 Agent 协作、上下文窗口清理
- 不适用场景: 简单一次性任务、无需跨会话的工作
功能概述
handoff 将当前会话压缩为一份交接文档，供另一个 Agent（或新会话）无缝接管。它保留任务进度、关键决策、已探索的路径和待完成的工作。
触发条件
以下情况会自动触发 handoff：
- 提到「交接」「继续这个任务」
- 会话上下文接近极限时
- 需要将任务移交给另一个 Agent
- 使用
/handoff命令
使用示例
示例 1：长任务续接
/handoff 当前正在实现用户认证系统，已完成登录注册，还需实现密码重置生成的交接文档会包含：
- 已完成：登录、注册接口 + 测试
- 进行中：JWT 中间件（进度 80%）
- 待完成：密码重置、OAuth
- 关键决策：使用 bcrypt 而非 argon2（为什么）
- 文件变更清单
示例 2：跨 Agent 协作
/handoff Agent A 已完成了数据库迁移和模型定义，Agent B 负责实现 API 层示例 3：问题诊断交接
/handoff Bug 已复现并定位到缓存层，尚未确定具体修复方案，交给下一个 Agent 继续交接文档结构
markdown
# Handoff: [任务名称]
## 当前状态
- 已完成 / 进行中 / 待完成
## 关键决策
- 决策 + 原因
## 已探索但放弃的路径
- 路径 + 放弃原因
## 文件变更
- 新增 / 修改 / 删除
## 下一步
- 具体可执行的任务注意事项
- 交接文档应简洁但完整 — 让接手的 Agent 能快速理解上下文
- 关键决策的原因比决策本身更重要 — 避免后来者推翻已验证的结论
- 标注已探索但放弃的路径可以避免重复尝试
- 交接不是「甩锅」— 确保任务在可交接的状态