# Handoff

> 编写或更新交接文档，让全新上下文的下一个 Agent 可以继续工作

- Skill: `gabrielmoreira/handoff-4` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/handoff-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/handoff-4/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gabrielmoreira/handoff-4

---


编写或更新交接文档，以便拥有全新上下文的下一个 Agent 可以继续此项工作。

步骤：
1. 检查项目中是否已存在 `HANDOFF.md`。如果已存在，在更新前先阅读它以了解先前的上下文。
2. 创建或更新包含以下内容的交接文档：
   - 目标：我们试图完成的工作，也包括当前正在使用的 TODO 文件。
   - 当前进展：目前已完成的工作和步骤。
   - 已生效方案：近期成功的方法/尝试。
   - 未生效方案：近期失败的方法/尝试（以避免重复）。
   - 推荐技能 (Suggested Agent Skills) ：建议下一个 Agent 启动后调用的 Agent Skill。
   - 后续步骤：继续工作的建议行动项。

注意事项：
- 不要重复记录已在其他文件（如 PRD、方案、决策记录、任务单、提交记录、Diff 等）中捕获的内容，你要直接通过路径或 URL 引用它们。
- 如果用户传入了参数，请将其视为对下一阶段任务焦点的描述，并据此定制交接文档。

保存与交付：
- 将文档保存为项目根目录下的 `HANDOFF.md`，并告知用户该文件路径，以便他们可以使用该路径开始全新的对话。
- 生成一段简短的文本，让用户可以通过 copy 指令直接复制，并在新的对话中粘贴，以便下一个 Agent 可以快速获取交接文档的路径并继续工作。例如：
  ```
  我们继续上一个 Agent Session 的操作。
  交接指令在 {path_to_handoff} ，请先读取它，并按该文件的指示进行操作。
  ```