# Handoff

> 跨会话交接、上下文保存或长任务中断续接时使用。结构化保存→新会话恢复。

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

---


# 跨会话交接

## 当前状态

!`git branch --show-current 2>/dev/null && git log --oneline -5 2>/dev/null`
!`git status --short 2>/dev/null | head -20`

## 触发时机
- 用户明确要求保存进度或交接
- 长任务接近上下文窗口上限
- 完成一个逻辑阶段，准备进入下一阶段
- 当日结束，次日需继续

## 保存流程
1. 写入 HANDOFF 文件：优先 `.claude/HANDOFF.md`，不存在则 `HANDOFF.md`
2. 有未提交代码变更时委派 `git-committer` 提交；无变更则跳过
3. 告知用户文件位置与恢复方式

## HANDOFF 格式

```markdown
## HANDOFF — [任务名]

### 已完成
- [x] 步骤描述：结果摘要

### 进行中
- 当前分支：`<branch>` @ `<commit-sha>`
- 当前状态：描述

### 下一步（可验证目标）
1. 目标描述 → 期望结果
2. 目标描述 → 期望结果

### 注意事项
- 已知风险 / 设计决策 / 依赖 / 阻塞点
```

## 恢复流程
1. 读取 HANDOFF，跳过“已完成”
2. 验证“进行中”中的分支与代码状态
3. 从“下一步”的第一个目标继续执行

## 退出标准
- HANDOFF 文件已写入，且包含全部必需章节
- 若存在代码变更：已提交到对应分支；若无代码变更：结果中已明确说明