交接并重启

给你的代理一个全新的上下文,
又不丢掉来龙去脉

一项任务做了三个小时,上下文里塞满了旧日志和放弃的尝试,代理开始忘记自己做过的决定。你想让它干干净净地重新开始,但不是从零开始。

交接并重启替你完成交接:代理把进展写进项目中的一个文件,然后它的控制台在同一个标签页里开始一段新对话,第一条消息让它读这个文件并接着干。一次点击,一次确认,适用于 Claude Code、Codex 以及所有带 AgentsRoom 工具的代理 CLI。

AgentsRoom 中在一个运行中的代理上打开的右键菜单,Fork 下方是 Hand over and restart 及其说明:代理先写好交接说明,然后在新的对话中重新开始
右键点击一个运行中的代理:交接并重启就在它的菜单里,电脑上和手机上都有。

长会话会被用旧。代理读过的每个文件、打印过的每段测试日志、试过又放弃的每种方案,都留在它的上下文窗口里。到了某个时候,有用的部分,也就是决定和计划,被埋在其余内容下面,回答质量随之下降。

常见的办法是手动交接:让代理把总结写进一个文件,输入 /clear,再粘贴一条消息作为新对话的开头,让它去读这份总结。这样可行,也有人专门写交接用的技能和提示词来加快速度,但它照样把你从手头的工作里拉出来:每个代理三步,每次都要。

在 AgentsRoom 里,这只是一个菜单项。代理自己写交接说明,因为它知道自己的上下文里什么最重要,并在它的轮次结束后自行重启。你只需把握一件事:新对话开头的第一条消息。

在真实应用中录制:一个 Claude Code 代理完成了三步重构中的第 1 步和第 2 步,然后右键点击它,选择交接并重启,只需确认一次。代理把进展到哪里、做了哪些决定、还剩什么写进项目中的一个文件,然后它的控制台在同一个标签页里以一段新对话重启。它读取这个文件,接着做第 3 步,5 个测试全部通过。

在 YouTube 上观看

交接并重启能做什么

一个干净的上下文,从代理已经知道的东西出发,而不是从零开始。

一次点击代替三个步骤

右键点击一个运行中的代理,选择交接并重启,确认。不用输入 /clear,不用索要总结,不用粘贴提示词。控制台在同一个标签页里重新开始,角色、CLI 和模型都不变。

由代理亲自写的交接说明

代理把进展、做过的决定和剩下的工作写进项目中的一个文件:如果它的工作流程里有自己的交接文件,就写进那个文件,否则写进 .handoff/latest.md。文件留在磁盘上,你也可以读。

你的第一条消息,按代理保存

新对话以“Read your handover and continue”加上文件路径开头。在对话框里修改它,它就会为这个代理保存下来,在你账户的所有电脑和手机上都生效。

消息会等待新对话

从代理开始写交接说明的那一刻起,你或其他代理发给它的消息都会被暂存,并投递到它的下一段对话,不会在最后一秒落进旧对话里。

协调者可以提出,但不能决定

项目的协调者代理可以为某个队友申请交接,比如在它的上下文已满时。同一个对话框会打开,附上协调者的名字和理由,在你点击交接并重启之前什么都不会发生。

所有带 AgentsRoom 工具的 CLI

重启通过 AgentsRoom 工具完成,而不是依赖某个 CLI 的命令,所以在 Claude Code、Codex 以及其他加载了这些工具的代理 CLI 上效果都一样。没有这些工具的 CLI 会直接告诉你,这时你在它的控制台里输入 /clear 即可。

工作原理

四个步骤,你只需要做前两步。

  1. 1

    打开代理菜单

    右键点击一个在这台电脑上运行的代理,选择交接并重启。在手机上,长按该代理并选择同一项。

  2. 2

    检查第一条消息

    对话框会显示“下一段对话的第一条消息”,默认是“Read your handover and continue”。如果这个代理需要别的内容就改一下,它会保存下来供下次使用,然后点击交接并重启。

  3. 3

    代理写交接说明

    AgentsRoom 让代理把交接说明写进项目中的一个文件,并结束它的轮次。从这时起,发给它的消息会等待它的下一段对话。

  4. 4

    控制台重新开始

    轮次结束后,控制台在同一个标签页里以一段新对话重启。第一条消息加上交接文件的路径会替你发出,代理从上次停下的地方继续工作。

AgentsRoom 的 Hand over and restart 对话框:说明代理会把交接说明写进项目中的一个文件,然后在同一个标签页里重新开始,一个填好 Read your handover and continue 的 First message of the next conversation 字段,以及 Cancel 和 Hand over and restart 按钮
只需确认一次。下一段对话的第一条消息会为这个代理保存下来,代理会在后面附上交接文件的路径。

交接、/compact 还是 /clear?

/clear 会丢掉整段对话。任务已经完成、下一个任务与之无关时,它是合适的工具;在任务进行到一半时,它就是错误的工具,因为代理知道的一切都会随之消失。

/compact 在同一个会话中,把对话替换成 CLI 写的摘要。保留什么由不得你选,摘要只存在于上下文中,而一个被压缩过好几次的长会话,留下的是摘要的摘要。

交接并重启介于两者之间。代理亲自写交接说明,写在一个你可以阅读和修改的文件里,新对话开始时上下文里只有这份内容。这是给那些还没做完、但上下文已经用旧的任务准备的一招。代理没写下来的东西会随旧对话一起消失,所以事关重大时,值得看一眼这个文件。

限制

  • 代理需要 AgentsRoom 工具(MCP)才能自行重启。不加载这些工具的 CLI 做不到,这个操作会提示你改为输入 /clear。
  • 重启会等到代理的轮次结束。如果代理正在忙,操作提示它现在无法重启,等它回答完再试。
  • 以下情况会被拒绝,并附上说明原因的消息:正在运行的 Agent Team 中的某个步骤、QA 测试期间,以及项目的终端显示在另一个窗口中时,此时请先把它们移回主窗口。
  • 每个代理每 2 分钟最多重启一次,每小时最多 6 次,这样陷入循环的例行流程就无法反复重启一个代理。
  • 这个菜单项只会出现在这台电脑上运行的代理上:在你账户的另一台机器上运行的代理不会有,项目助手也不会有。
  • 代理没有写进交接说明的内容,会随旧对话一起丢失。
怎样在不丢失进度的情况下,给 Claude Code 代理一个全新的上下文?
在 AgentsRoom 里右键点击该代理,选择交接并重启。代理把交接说明写进项目中的一个文件,然后它的控制台以一段新对话重启,新对话第一件事就是读这个文件。你不用输入 /clear,也不用粘贴提示词,同样的操作也适用于 Codex 以及其他加载了 AgentsRoom 工具的代理 CLI。
它和 /compact 有什么区别?
/compact 让 CLI 在同一个会话中用它自己的摘要替换对话,保留什么由不得你选。交接并重启让代理把交接说明写进一个你可以阅读的文件,然后开始一段干净的新对话去读它。想快速继续就用 /compact,上下文已经用旧、你想掌控哪些内容带过去时就用交接。
交接文件放在哪里?
在项目里。如果代理的工作流程里有自己的交接文件,就用那个文件,否则用 .handoff/latest.md,文件路径会加到新对话的第一条消息里。重启后它仍留在磁盘上,你可以打开它、修改它,或者把它指给另一个代理。
可以修改新对话的第一条消息吗?
可以。对话框里有一个“下一段对话的第一条消息”字段,默认是“Read your handover and continue”。你在这里输入的内容会为这个代理保存下来,在你账户的所有电脑和手机上都跟着你。留空即可恢复默认消息。
代理能自己交接并重启吗?
代理可以用 AgentsRoom 工具中的 agents_restart 工具重启自己的控制台,比如在上下文太满时写下检查点的例行流程里调用它。项目的协调者代理也可以为某个队友申请交接,但只有你能批准:对话框会显示是谁申请、为什么申请,而协调者不会得知你的选择。
它适用于 Codex 和其他 CLI 吗?
适用,所有加载了 AgentsRoom 工具的代理 CLI 都可以,因为重启是通过这些工具完成的,而不是某个 CLI 专有的命令。如果某个 CLI 没有加载这些工具,操作会提示这一点,你可以自己在它的控制台里输入 /clear。
为什么提示代理现在无法重启?
消息里会写明原因。代理可能正处在一个轮次中间:等它回答完。它可能是正在运行的 Agent Team 中的一个步骤,或者正处于 QA 测试中,这些情况都会被拒绝。它的终端可能显示在另一个窗口中:把它们移回主窗口。也可能是达到了每 2 分钟一次、每小时 6 次的重启上限。

延伸阅读

你可能还喜欢

DevOps 工程师撰稿人前端开发者销售代表后端开发者教练与培训师软件架构师法律顾问QA 工程师财务与行政全栈开发者创意设计师移动开发者研究员安全工程师人事与招聘
项目经理翻译Git 专家数据分析师SEO 专家会计本地化专员公关与传播头脑风暴者运营与物流营销专员客户服务项目助理采购专员社群运营私人助理

给你的代理一个记得住的新开始

交接并重启已在 macOS、Windows 和 Linux 版 AgentsRoom 中提供,免费下载。

下载 AgentsRoom免费

配套应用:随时随地监控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

获取扩展程序
Chrome Web Store

把 Bug 和需求直接发送到您的公开待办清单。

像读聊天记录一样读代理

每个代理都有角色、头像和一条对话线程,读起来就像聊天应用。

对话视图

AgentsRoom 对话视图:AI 编程代理的工作以聊天线程呈现
多项目管理
多供应商
多代理运行
实时状态
文件差异与提交
移动应用
实时预览
代理团队
浏览器自动化
Backlog 驱动开发
提示词库
技能库
查看所有功能