yy-handoff

用于创建或更新面向后续会话续接的 handoff.md 交接文档。

When to use

• 用户要求“生成 handoff.md”
• 用户要求“给新会话一个接力说明”
• 用户要求“让另一个 AI 继续当前任务”
• 用户要求“整理当前任务上下文，方便后续继续”
• 项目已经有规格、计划、任务清单、检查清单，需要沉淀为统一交接入口

Don't use when

• 用户只是口头询问当前进度，不要求落文档
• 用户要创建规格文档、任务拆解或检查清单
• 用户要初始化项目规则文档 AGENTS.md
• 用户要直接开始开发，而不是先做交接文档

Steps

1. 先读取项目根目录 AGENTS.md；若不存在，明确指出并询问是否继续。
2. 识别当前任务的权威文档来源。优先读取规格目录中的 spec.md、tasks.md、checklist.md；若有现成 handoff.md，先读取后再决定更新还是重写。
3. 提取以下信息：
   • 项目路径
   • 当前任务目标
   • 已确认约束
   • 当前状态
   • 尚未开始与已完成的边界
   • 后续会话必须先读的文件
   • 可直接复制给新会话的提示词
4. 若用户已明确关键约束，直接写入；若仍缺少会影响后续会话续接的关键约束，只补问最少问题。
5. 在统一位置创建或更新 handoff.md。若项目已有规格目录，优先放在该规格目录中；否则放在用户指定目录；仍无指定时放在项目内最接近当前任务文档的位置。
6. 文档内容保持简练、结构固定、可直接复制使用，不写冗余背景。
7. 交付时给出：
   • handoff.md 路径
   • 已纳入的关键信息
   • 是否还存在阻塞续接的未确认项

Output contract

• 必须输出 handoff.md 的绝对路径
• 必须说明是“新建”还是“更新”
• 必须列出已写入的核心约束
• 必须说明是否还有未确认项
• 若无未确认项，必须明确“新会话可直接接力”

handoff.md 固定结构

handoff.md 至少包含以下章节：

# [任务名] 交接说明

## 1. 任务位置
- 项目目录
- 当前规格或任务目录

## 2. 开工前必读
1. AGENTS.md
2. spec.md
3. tasks.md
4. checklist.md
5. handoff.md

## 3. 任务目标
- 当前任务要做什么

## 4. 已确认约束
- 已确定的实现边界和规则

## 5. 当前状态
- 已完成什么
- 尚未开始什么

## 6. 接力要求
- 新会话继续时必须遵守什么

## 7. 建议起步顺序
1. 先读什么
2. 从哪一步开始

## 8. 可直接发给新会话的提示词
```text
[可复制提示词]

质量要求

• 使用正斜杠作为路径分隔符，路径包含空格时使用引号包裹，以确保跨平台兼容性和正确解析
• 语言简练，不写空泛说明
• 路径必须写绝对路径
• 提示词必须可直接复制
• 不得遗漏"当前不要开始开发"这类关键状态约束
• 若 tasks.md 和现实状态不一致，先提示用户再写 handoff