yy-handoff
用于创建或更新面向后续会话续接的 handoff.md 交接文档。
When to use
- 用户要求“生成 handoff.md”
- 用户要求“给新会话一个接力说明”
- 用户要求“让另一个 AI 继续当前任务”
- 用户要求“整理当前任务上下文，方便后续继续”
- 项目已经有规格、计划、任务清单、检查清单，需要沉淀为统一交接入口
Don't use when
- 用户只是口头询问当前进度，不要求落文档
- 用户要创建规格文档、任务拆解或检查清单
- 用户要初始化项目规则文档
AGENTS.md - 用户要直接开始开发，而不是先做交接文档
Steps
- 先读取项目根目录
AGENTS.md；若不存在，明确指出并询问是否继续。 - 识别当前任务的权威文档来源。优先读取规格目录中的
spec.md、tasks.md、checklist.md；若有现成handoff.md，先读取后再决定更新还是重写。 - 提取以下信息：
- 项目路径 - 当前任务目标 - 已确认约束 - 当前状态 - 尚未开始与已完成的边界 - 后续会话必须先读的文件 - 可直接复制给新会话的提示词
- 若用户已明确关键约束，直接写入；若仍缺少会影响后续会话续接的关键约束，只补问最少问题。
- 在统一位置创建或更新
handoff.md。若项目已有规格目录，优先放在该规格目录中；否则放在用户指定目录；仍无指定时放在项目内最接近当前任务文档的位置。 - 文档内容保持简练、结构固定、可直接复制使用，不写冗余背景。
- 交付时给出：
- 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. 可直接发给新会话的提示词[可复制提示词]
## 质量要求
- 使用正斜杠作为路径分隔符，路径包含空格时使用引号包裹，以确保跨平台兼容性和正确解析
- 语言简练，不写空泛说明
- 路径必须写绝对路径
- 提示词必须可直接复制
- 不得遗漏"当前不要开始开发"这类关键状态约束
- 若 `tasks.md` 和现实状态不一致，先提示用户再写 handoff