---
name: Handoff
description: 生成交接文档 HANDOFF.md，供下一次会话快速恢复上下文
---

## Usage

/Handoff

## Description

在当前会话结束时执行，生成一份 **HANDOFF.md** 交接文档，内容包括：

- **项目概览**：项目是什么、技术栈、目录结构
- **当前任务**：本次会话在做什么
- **已完成事项**：已完成的里程碑和关键成果
- **卡点和问题**：当前卡在什么地方、未解决的问题
- **下一步计划**：优先级最高的待办任务
- **踩坑记录**：绝对不要重复踩的坑（含 Windows 平台特有坑）
- **启动指南**：如何快速启动项目
- **关键人员/文档索引**：重要文档和 PRD 位置

## 执行步骤

1. 读取项目关键状态：
   - `git log --oneline -5`（最近提交）
   - `git status --short`（未提交变更）
   - `git branch --show-current`（当前分支）
   - `ls Docs/PRD/自动化测试平台/`（检查文档目录）
2. 读取已有进度文档：`Docs/PRD/自动化测试平台/当前进度记录.md`
3. 根据上述信息合成 HANDOFF.md，写入项目根目录 `HANDOFF.md`
4. 告知用户 HANDOFF.md 已生成

## 生成规则

- **⚠️ 必须包含「开始工作前必读」章节**：在 HANDOFF.md 顶部（项目概览之前）插入多窗口并行开发冲突规避提示，指向 `Docs/多窗口并行开发指南.md`，确保每次新会话开始时首先看到此提示
- 写入项目根目录 `HANDOFF.md`
- 使用 Markdown 格式，中文字符
- 每个章节用 `---` 分隔，便于快速扫读