handoff - 把当前会话压缩成交接文档的技能

技能概述

handoff 技能把当前对话压缩成一份简洁的交接文档，保存到操作系统的临时目录，让下一个智能体能够直接接手继续工作。

适用场景

1. 上下文即将耗尽需要续接：长对话快要触达上下文窗口上限时，先用 handoff 把关键进展、待办事项和当前状态固化下来，新会话读取这份文档即可无缝继续，不必从头复述。
2. 长任务拆分成多次会话：一个需求无法在一次会话里完成，需要分阶段推进时，每次收尾都生成一份交接文档，让下一轮会话明确知道做到哪了、下一步做什么。
3. 多智能体接力协作：团队里不同的智能体或不同的开发者轮流处理同一个需求，通过统一的交接文档传递上下文，避免重复解释背景。

核心功能

1. 对话压缩与要点提取：自动梳理当前会话，提取出工作目标、已完成的部分、未解决的问题和下一步动作，形成一份结构化的交接说明，而不是简单罗列聊天记录。
2. 保存到系统临时目录：文档写入操作系统的临时目录，不会污染当前工作区，也不会误把交接草稿提交进代码仓库。这一点是技能的明确约束。
3. 内容去重与敏感信息脱敏：已经被 spec、plan、ADR、issue、commit、diff 等工件记录过的内容不再重复抄写，改为按路径或链接引用；同时自动隐去 API 密钥、密码、个人身份信息等敏感内容。

此外，技能支持传入参数来描述下一个会话的用途，交接文档会围绕这个重点重新组织内容，而不是平均用力。

常见问题

handoff 技能是做什么的？

它把当前对话整理成一份交接文档，让一个全新的智能体能够快速了解此前的工作并继续推进。生成的内容面向"接手者"而不是"回顾者"，所以重点放在当前状态、待办和参考链接上。

交接文档保存在哪里？会污染我的项目吗？

保存在操作系统的临时目录中，不在当前工作区。这是技能的明确设计——交接文档属于过程性材料，不应该出现在你的代码仓库里。如果你需要长期留存，需要自己手动移动或复制到合适的位置。

交接文档里会包含我的 API 密钥或个人信息吗？

不会。技能在写作时会主动隐去敏感信息，包括 API 密钥、密码和可识别个人身份的内容。不过它依赖模型判断，涉及高度敏感的项目时，建议在分享交接文档前再人工检查一遍。

交接文档和已有的 spec、plan 文档会重复吗？

不会。技能被明确要求不重复其他工件已经记录的内容，而是用路径或 URL 引用它们。这样交接文档保持精简，也避免了多处内容不一致的问题。

怎么让交接文档聚焦下一个会话要做的事？

在调用技能时传入参数，描述下一个会话的用途。技能会把这个参数当作重点，围绕它来组织文档，而不是平均覆盖所有历史细节。

什么时候不该用 handoff？

如果任务已经结束、不需要任何人接手，就没必要生成交接文档。另外，如果下一个会话依然在同一个上下文里继续进行，直接接着聊即可，中间插入一份交接文档反而增加噪音。