交接並重啟

給你的代理一個全新的上下文,
又不丟掉來龍去脈

一項任務做了三個小時,上下文裡塞滿了舊日誌和放棄的嘗試,代理開始忘記自己做過的決定。你想讓它乾乾淨淨地重新開始,但不是從零開始。

交接並重啟替你完成交接:代理把進展寫進專案中的一個檔案,然後它的主控台在同一個分頁裡開始一段新對話,第一條訊息讓它讀這個檔案並接著幹。一次點選,一次確認,適用於 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 驅動開發
提示詞庫
技能庫
檢視所有功能