/handoff

会话上下文恢复。新会话开始时使用，从 HANDOFF.md 恢复之前的工作上下文。

Handoff — 会话上下文恢复

从 HANDOFF.md 交接文档恢复上一次会话的工作上下文，确保无缝继续。

触发时机

• 新会话开始，需要恢复之前的工作上下文
• 用户主动输入 /handoff

步骤

Step 1: 读取交接文档

读取项目根目录的 HANDOFF.md。如果不存在，告知用户并建议使用 /checkpoint 创建。

Step 2: 提取核心字段

从 HANDOFF.md 提取以下内容：

1. Active Plan — 活跃方案名称、路径和进度（如果有）
2. Session Tasks — 上次的任务清单，区分已完成和待完成
3. 关键文件 — 当前任务涉及的文件路径列表
4. 待决策 — 需要人判断的悬而未决项（没有则跳过）

如果有 Active Plan，读取对应的 docs/plans/{slug}.md 获取整体进度。

Step 3: 输出恢复报告

## 上下文已恢复

**项目**: {项目名称}
**活跃方案**: {方案名}（n/m, xx%）→ `docs/plans/{slug}.md`
**上次完成**: {从 Session Tasks 已完成项概括}

### 待完成
1. {未完成的任务 + 文件路径}
2. ...

### 待决策
- {决策项}（如果没有则省略此节）

无 Active Plan 时，省略活跃方案行，直接展示 Session Tasks 待完成项。

Step 4: 就绪确认

询问用户想从哪个动作开始，或者是否有新的任务。

IMPORTANT

• 只读 HANDOFF.md — 不要主动探索代码库、不要预读文件、不要运行验证命令。恢复上下文的目标是 30 秒，不是全面体检
• 验证是工作的一部分，不是恢复的一部分 — 开始工作后再验证状态，不要在恢复阶段验证
• 不要重复读已有上下文 — 如果 CLAUDE.md 已加载到上下文中，不需要再读
• 交接文档太长说明写重了 — 如果 HANDOFF.md 超过 50 行，提醒用户下次精简