handoff：把当前上下文交给下一个 agent

handoff把当前上下文交给下一个 agent原始 GitHub 文件handoff/SKILL.md完整中文文件已经落在同目录SKILL.mdhandoff是一条很短的 productivity skill但它在整套工作流里很关键当当前会话要结束、上下文可能丢失或者下一轮要换一个新 agent 接手时它负责把“继续工作所需的信息”压缩成一份交接文档。它不是普通总结。普通总结倾向于回顾发生了什么handoff 的目标是让下一个 agent 能立刻继续做事。1. 完整可复制中文 SKILL.md--- name: handoff description: 将当前对话压缩成一份 handoff 文档让另一个 agent 可以接手继续。 argument-hint: 下一轮会话将用于什么 disable-model-invocation: true --- 写一份 handoff 文档总结当前对话让一个新的 agent 可以继续这项工作。把文档保存到用户操作系统的临时目录而不是当前 workspace。 在文档中包含一个 suggested skills section建议下一个 agent 应该调用哪些 skills。 不要重复已经记录在其他 artifacts 里的内容例如 PRD、plans、ADRs、issues、commits、diffs。用路径或 URL 引用它们。 隐去所有敏感信息例如 API keys、passwords 或 personally identifiable information。 如果用户传入了 arguments把它们视为下一轮会话的关注重点并据此调整文档。2. 后文只挑疑难点这条 skill 很短不需要逐句解释。真正值得注意的是四个设计点为什么保存到 OS temp 目录而不是 workspace为什么要有suggested skills为什么不要重复已有 artifacts为什么argument-hint是“下一轮会话将用于什么”3. handoff 不是 archive而是 continuationhandoff的关键不是“归档当前会话”而是“让下一轮继续”。所以它关心的不是把所有历史完整写下来而是下一个 agent 需要知道什么当前目标是什么已经完成了什么哪些文件或 artifacts 是权威来源哪些决策不能重新争论下一步应该从哪里开始该调用哪些 skills。这和普通项目总结不同。普通总结可以追求完整handoff 必须追求可接手。4. 保存到临时目录是为了不污染项目事实这里更硬的判断是handoff不写进 repo首先是为了守住“交接材料”和“项目事实”的边界检索更干净只是顺带收益。原文要求保存到用户 OS 的临时目录不保存到当前 workspace。这说明 handoff 文档默认是会话交接材料不是项目文档。它通常包含当前进度、下一步、上下文压缩、可能还包括一些临时判断。把它直接放进 repo容易制造噪音。如果某个结论已经稳定到应该长期保留就不应该只写在 handoff 里而应该进入 PRD、plan、ADR、issue、commit 或项目文档。5. suggested skills 是给下一个 agent 的路线图这条 skill 明确要求文档包含 “suggested skills” section。这在 Matt 的 skill 系统里很自然下一轮 agent 不一定知道当前任务应该接哪个 flow。如果 handoff 只写“继续分析”下一个 agent 仍然要重新判断如果它直接写明建议调用/codebase-design、/grilling、/implement或其他 skill接手成本会低很多。所以suggested skills不是附录而是交接文档里的执行路线。6. 不重复 artifacts是为了保护权威来源原文说不要重复已经记录在 PRDs、plans、ADRs、issues、commits、diffs 里的内容要用 path 或 URL 引用。这条很重要。handoff 如果复制太多内容会带来两个问题交接文档变臃肿下一个 agent 很难分辨重点内容会和权威 artifacts 分叉后续修改后 handoff 里的复制版本就过期了。更好的做法是handoff 写“应该看哪个文件、哪个 URL、哪个 commit、哪个 issue”并说明它们在当前任务中的作用。原始内容仍然留在权威位置。7. argument-hint 的作用argument-hint不是让用户补充当前会话标题而是在提示用户handoff 的参数应该写“下一轮会话将用于什么”。它在这里是What will the next session be used for?这不是让用户描述当前会话而是让用户给下一轮设定焦点。比如“下一轮继续实现 issue 3”“下一轮只做 code review”“下一轮把 README 格式整理完”“下一轮接着排查测试失败”有了这个焦点handoff 就不会平均总结所有信息而会围绕下一轮任务取舍上下文。8. 快速复习关键思想关键思想压缩handoff是 continuation 文档不是完整历史归档。保存到 OS temp 目录避免把会话交接材料误当项目事实。文档必须包含suggested skills给下一个 agent 明确路线。已有 PRD、plan、ADR、issue、commit、diff 不要复制引用路径或 URL。用户 arguments 是下一轮会话焦点不是当前会话标题。必须隐去敏感信息。快速回忆为什么 handoff 不应该保存到 repo为什么不复制已有 artifactssuggested skills解决什么问题argument-hint为什么问下一轮会话用途答案要点因为它是临时交接材料不是长期项目事实。因为复制会制造冗余和过期版本权威内容应该留在原 artifact。它让下一个 agent 直接进入正确 flow不必重新路由。因为 handoff 要服务下一轮任务需要按下一轮焦点裁剪上下文。