yy-handoff

name	yy-handoff
description	创建或更新项目交接文档 handoff.md，用于跨会话续接当前任务。 当用户提到 handoff、交接、续接、接力、给下一个 AI 的说明时使用。 不用于生成面向管理人员的工作报告、面向开发者的变更日志，也不用于继续执行未完成的代码任务本身。

yy-handoff

描述

创建或更新面向后续会话续接的 handoff.md 交接文档，确保新会话能快速理解任务上下文、约束和进度。

使用场景

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

不应触发：

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

指令

步骤 1. 读取 AGENTS.md

读取项目根目录 AGENTS.md；若不存在，明确指出并询问是否继续。

步骤 2. 识别权威文档来源

识别当前任务的权威文档来源，优先读取 spec.md、tasks.md、checklist.md；若有现成 handoff.md，先读取后判断处理方式：

• 更新：现有内容结构完整，仅需刷新当前状态或补充新增约束
• 重写：现有内容与当前任务无关（如任务已切换），或结构严重缺失（缺少 3 个以上固定章节）

步骤 3. 提取核心信息

提取核心信息：项目位置、任务目标、已确认约束、当前状态、接力要求、可复制的提示词。

步骤 4. 补问关键约束

缺少关键约束时补问最少问题，否则直接写入。

步骤 5. 创建或更新 handoff.md

创建或更新 handoff.md：用户指定了目录时使用指定目录，否则放在项目根目录。

步骤 6. 输出结果

输出结果：handoff.md 路径、已写入的核心信息、是否存在未确认项。

输出格式

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

handoff.md 固定结构

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

• 任务位置：项目目录、当前规格或任务目录
• 开工前必读：AGENTS.md、spec.md、tasks.md、checklist.md、handoff.md
• 任务目标：当前任务要做什么
• 已确认约束：已确定的实现边界和规则
• 当前状态：已完成什么、尚未开始什么
• 接力要求：新会话继续时必须遵守什么
• 建议起步顺序：先读什么、从哪一步开始
• 可直接发给新会话的提示词：可复制文本块

质量要求

• 使用正斜杠作为路径分隔符，路径包含空格时使用引号包裹
• 语言简练，不写空泛说明
• 路径必须写绝对路径
• 提示词必须可直接复制
• 不得遗漏"当前不要开始开发"这类关键状态约束
• 若 tasks.md 和现实状态不一致，先提示用户再写 handoff
• "已确认约束"只写入用户明确告知或从权威文档中提取的约束，不要基于项目类型自行推断或编造（例如用户说 Vue2 项目，不要自行添加"不使用 Vuex"或"用事件总线"等未提及的约束）
• 每条约束应可追溯到用户原文或已读文档，无法追溯的约束归入"待确认"而非"已确认"

相关资源

本技能包含以下辅助资源：

• examples/input.md：输入示例，展示用户如何请求创建交接文档
• examples/output.md：输出示例，展示创建交接文档后的预期结果