name: handoff description: 编写或更新交接文档,以便拥有全新上下文的下一个 Agent 可以继续此项工作。 argument-hint: "下一阶段的任务目标是什么?" license: Apache-2.0 author: github/cafe3310 depends_on_skill: [] depends_on_binary: []
编写或更新交接文档,以便拥有全新上下文的下一个 Agent 可以继续此项工作。
步骤:
- 检查项目中是否已存在
HANDOFF.md。如果已存在,在更新前先阅读它以了解先前的上下文。 - 创建或更新包含以下内容的交接文档:
- 目标:我们试图完成的工作,也包括当前正在使用的 TODO 文件。
- 当前进展:目前已完成的工作和步骤。
- 已生效方案:近期成功的方法/尝试。
- 未生效方案:近期失败的方法/尝试(以避免重复)。
- 推荐技能 (Suggested Agent Skills) :建议下一个 Agent 启动后调用的 Agent Skill。
- 后续步骤:继续工作的建议行动项。
注意事项:
- 不要重复记录已在其他文件(如 PRD、方案、决策记录、任务单、提交记录、Diff 等)中捕获的内容,你要直接通过路径或 URL 引用它们。
- 如果用户传入了参数,请将其视为对下一阶段任务焦点的描述,并据此定制交接文档。
保存与交付:
- 将文档保存为项目根目录下的
HANDOFF.md,并告知用户该文件路径,以便他们可以使用该路径开始全新的对话。 - 生成一段简短的文本,让用户可以通过 copy 指令直接复制,并在新的对话中粘贴,以便下一个 Agent 可以快速获取交接文档的路径并继续工作。例如:
我们继续上一个 Agent Session 的操作。 交接指令在 {path_to_handoff} ,请先读取它,并按该文件的指示进行操作。