| name | handoff |
| description | 跨会话交接、上下文保存或长任务中断续接时使用。结构化保存→新会话恢复。 |
| argument-hint | [任务描述] |
跨会话交接
当前状态
!git branch --show-current 2>/dev/null && git log --oneline -5 2>/dev/null
!git status --short 2>/dev/null | head -20
触发时机
- 用户明确要求保存进度或交接
- 长任务接近上下文窗口上限
- 完成一个逻辑阶段,准备进入下一阶段
- 当日结束,次日需继续
保存流程
- 写入 HANDOFF 文件:优先
.claude/HANDOFF.md,不存在则 HANDOFF.md
- 有未提交代码变更时委派
git-committer 提交;无变更则跳过
- 告知用户文件位置与恢复方式
HANDOFF 格式
## HANDOFF — [任务名]
### 已完成
- [x] 步骤描述:结果摘要
### 进行中
- 当前分支:`<branch>` @ `<commit-sha>`
- 当前状态:描述
### 下一步(可验证目标)
1. 目标描述 → 期望结果
2. 目标描述 → 期望结果
### 注意事项
- 已知风险 / 设计决策 / 依赖 / 阻塞点
恢复流程
- 读取 HANDOFF,跳过“已完成”
- 验证“进行中”中的分支与代码状态
- 从“下一步”的第一个目标继续执行
退出标准
- HANDOFF 文件已写入,且包含全部必需章节
- 若存在代码变更:已提交到对应分支;若无代码变更:结果中已明确说明