【开源推广】一次模型响应断连从websocket降级到http等了 97 秒后，我做了个长会话交接 Agent Handoff Skill

- 我的帖子已经打上 开源推广 标签： 是

- 我的开源项目完整开源，无未开源部分： 是

- 我的开源项目已链接认可 LINUX DO 社区： 是

- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

分享一个从自己实际踩坑然后做的Skill：Agent Handoff

为什么做这个？

之前用 Codex优化我的前端UI，反复生成图片进行打磨优化。会话越来越长，后来开始出现：```

正在重新连接 5/5
stream disconnected before completion
```断流、重试，最后从 WebSocket 降级到 HTTP/SSE。即使后续没有断连，响应还是很慢。

排查时发现，一次请求已经达到约 20.9 MB，包含 14 张历史图片，还有大量消息和工具记录，每轮对话都重新携带。

在一个没有重连的对话里定位到：

- 第一次模型响应等了 97 秒。

- 工具实际执行约 0.831 秒。

- 第二次模型响应又等了 81 秒。

这时最想做的就是开一个干净的新会话，但又有个问题：

目标、已经确定的方案、踩过的坑、还没验证的地方，全在旧对话里。

重新聊很麻烦，把整段聊天fork过去，又把历史上下文全带进去了。

所以我想要的是：留下能够接手的信息，让新会话接着干，而不是从头开始。

Agent Handoff 有什么用？

核心功能就是生成一份人和 Agent 都能读懂的交接文档，重点保存四件事：

- 背景：在做什么，为什么做。

- 当前状态：完成了什么，哪些尚未验证。

- 下一步：先做哪个具体动作。

- 接手资料：优先读哪些文件，以及为什么读。

和已有的 handoff 有什么区别？

参考了 Matt Pocock 的 handoff Skill。他的方案很简洁：围绕下一会话写交接，保存到系统临时目录

我增加了几个自己需要的部分：

- 按项目、日期整理，避免交接文件散落不好找不好删除。

- 提供校验、查找和恢复脚本，检查必要章节、引用格式和常见敏感信息。

- 默认放在业务仓库之外，不污染项目的上下文。

github.com

GitHub - chrichuang218/agent-handoff: Readable handoffs, evidence-backed retrospectives,...

Readable handoffs, evidence-backed retrospectives, and approved memory for Codex and Claude Code.