关于 handoff
handoff 是用于生成会话交接文档的 Agent 技能，帮助新 Agent 接续工作。它规定了八部分结构和安全的临时存储方式，并要求保留恢复工作所需的上下文。
主要功能
- 01在安全临时目录创建 handoff.md
- 02采用固定的八部分文档结构
- 03根据提供的参数调整目标
- 04保留运行时、角色和模型配置
- 05记录路径及恢复工作所需信息
适用场景
- 01为新 Agent 准备会话续接信息
- 02在不同会话间传递上下文和后续步骤
- 03依据运行记录和结果路径恢复完整任务
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/handoff确认已加载。
详细介绍
编写一份交接文档，总结当前对话，以便新的 Agent 能继续工作。使用平台的安全临时目录辅助工具创建一个唯一的临时目录（对于 Node，使用 fs.mkdtempSync(path.join(os.tmpdir(), "handoff-"))），并在其中写入 handoff.md。报告绝对路径。
如果用户传入了参数，请将其视为下一次会话的工作重点描述，并据此调整文档。
在 Key context 下保留实际接收运行时以及已解析的角色／模型配置。不要将编排默认值注入无关的后续工作。编写交接文档不会启动工作线程，也不会更改当前活动模型。 继续完整运行时，请在 Pointers 下包含其台账和各切片结果路径，并保留恢复工作所需的授权、冻结的门禁、未解决的裁定和 Agent ID。接收任务的 Codex 必须验证 Agent 是否仍在运行；先前会话中的 ID 不能证明工作线程仍在运行。
文档结构
交接文档将由另一个 Agent 阅读，因此格式固定。必须严格按以下顺序包含这八个部分，并逐字使用这些标题。开头先写意图和后续步骤，而非历史叙述——新的 Agent 应能从上到下快速浏览并立即开始工作。
# Handoff: <简短标题>— 用一行说明工作内容。## Goal— 用 1–2 句话说明下一次会话要达成的目标。如果传入了参数，目标应体现这些参数。## Current state— 说明目前已完成且可正常工作的内容。使用过去时的项目符号。## Next steps— 按顺序列出要执行的具体操作，每项均使用祈使语气（例如“接入 X”“运行 Y”）。这是最重要的部分：即使从冷启动开始也应能按步骤执行。## Open questions / blockers— 尚未解决的决策、等待他人处理的事项和已知风险。## Key context— 列出不显而易见的信息：已做出的决策及其原因、注意事项、已排除的无效方案。新的 Agent 可直接从代码或链接的产物中读取的信息不必重复。## Pointers— 列出包含详细信息的产物路径和 URL：PRD、计划、ADR、问题、分支、关键文件（path:line）。引用这些内容；不要复制其内容。## Suggested skills— 列出下一次会话应使用的技能（如有）及其用途。
规则
- 不要重复其他产物（PRD、计划、ADR、问题、提交、差异）中已有的内容。改为在 Pointers 中引用其路径或 URL。
- 如果某个部分没有实际内容，请在其中写
None.，不要用空话填充或编造内容。Open questions 可以为空；不要虚构问题。 - 保持简洁。交接文档是启动工作的指引，不是对话记录。
评论
支持 Markdown