學習 Cue · 任務型教學

在不重複工作的情況下接續中斷的 Coding Agent

連線在編輯後中斷。在說出「再試一次」之前,請先查明實際發生了什麼事。復原請求應描述剩下的工作,而不是重複已經完成的工作。

作者:Cue 產品團隊 (English) · 更新於 。編寫自產品原始碼審查。練習與輸出僅供說明,非記錄的 Cue 執行成果。請遵循您安裝版本中顯示的控制項。

快速解答

確認原始執行及任何相關動作已不再處於活動狀態。檢查實際檔案與目的地,將各項結果標記為已確認或未知,並使用 Cue 起草經審查的僅限剩餘工作請求。使用單一 Agent 和具明確邊界的驗證步驟接續;將不確定的發布或傳送動作保持封鎖。

需求:設定妥當的 Cue Dictation、便簽,以及對中斷任務佐證的授權存取權。結果:一份經過檢查的復原摘要,能保留已完成的工作,且僅重試經驗證的剩餘步驟。

準備安全的復原邊界

本教學適用於在可能已完成部分工作後停止的任務:中斷的 Claude Code 或 Codex 執行、連線中斷的外部 Agent 工作階段,或是最終回覆從未送達的 Cue 請求。這不是用來還原已刪除檔案或強制推動停滯發布的指南。

您需要原始請求、正確的專案與分支、檢查該專案的權限,以及存取任何可能已變更之目的地的權限。請按照 Cue Dictation 教學 中的麥克風與輸入存取設定進行操作。在 Mac 或 Windows 上,請使用您安裝的 Cue 設定中顯示的快速鍵;本練習不依賴特定快速鍵或未發行版本。

在確認誰仍在運作之前,請停止新增請求。在適當情況下使用可見的停止或取消控制項,然後檢查任務的活動及其啟動的任何工具、終端機或作業。視窗斷線、回覆取消或對話暫停,並不構成每個子程序或外部作業都已停止的證據。取消動作也不會復原已儲存的編輯、已傳送的訊息或已完成的部署。如果您無法確定某些項目是否仍在運作,請將復原保持為唯讀狀態,並請負責的操作員或支援人員確認其狀態。

當第一個 Agent 可能仍在變更相同檔案時,切勿在這些檔案上啟動第二個 Agent。請保留原始對話與現有檔案;請勿為了獲得看似乾淨的起點而重設存放庫、刪除任務歷程記錄或清除工作資料夾。

練習:存在一處編輯,測試未執行,發布狀態未知

此虛構練習使用名為 demo-catalog 的小型存放庫。佐證與範例輸出僅供說明,並非記錄的 Cue、Claude Code 或 Codex 執行成果。您可以透過在筆記中整理此封包來進行練習,而無需執行命令或連接真實存放庫。

來源 R-01 — 原始授權:src/page-size.mjs 中將 PAGE_SIZE 從 20 改為 40。保留 MAX_PAGE_SIZE 為 100。檢查現有的本機測試後將其執行。請勿提交、推送、部署或傳送完成訊息。

來源 R-02 — 已儲存的檢查點:在最後觀察到的檢查點,src/page-size.mjs 是 Agent 唯一變更的檔案。本機測試尚未執行。可見以下內容:

export const PAGE_SIZE = 40;
export const MAX_PAGE_SIZE = 100;

來源 R-03 — 現有測試,test/page-size.test.mjs

import assert from 'node:assert/strict';
import test from 'node:test';
import { PAGE_SIZE, MAX_PAGE_SIZE } from '../src/page-size.mjs';

test('requested page size changes without changing the maximum', () => {
  assert.equal(PAGE_SIZE, 40);
  assert.equal(MAX_PAGE_SIZE, 100);
});

來源 R-04 — 中斷:連線在最終結果出現前即結束。審查人員無法存取發布資訊主頁。因此發布狀態未知,即使發布並未獲得授權。禁止發布的指示只是一道邊界,並非表示外部未發生任何事情的獨立佐證。

此封包僅是一個檢查點,不能取代全新檢查。對於實際任務,請記下每次觀察的時間。如果其他人或程序事後變更了檔案,目前的內容優先於舊檢查點。

先檢查,再口述剩餘內容

  1. 識別原始執行並確認其處於非活動狀態。使用該工具中提供的控制項檢查任務及其相關活動。切勿憑空捏造通用的「繼續」按鈕,也不要假設連線過期就已停止所有動作。若無法確認處於非活動狀態,請在此停止並尋求協助。
  2. 確認工作位置。開啟預期的專案並檢查其分支與現有變更。對於 Git 存放庫,下方的唯讀命令有助於區分已變更的檔案、暫存的編輯以及最近的提交。同時也請檢查目前的檔案本身:即使工作 diff 為空,檔案也可能已包含所要求的變更。
  3. 將變更與授權的請求進行比對。針對 R-01,尋找 PAGE_SIZE = 40MAX_PAGE_SIZE = 100。檢查是否有其他變更,包括未追蹤的檔案。切勿僅因為舊對話未提及某項工作就將其覆寫。
  4. 區分本機與外部證據。 本機可見的編輯並不代表已完成提交、推送或部署。快取的遠端分支不能證明伺服器的最新狀態。獲得授權時,請檢查實際的存放庫服務、發布儀表板或目標應用程式。如果缺少存取權限,請將結果記錄為未知,並避免在重試中執行該操作。
  5. 使用 Cue 擷取復原筆記。聚焦於空白便簽,使用已設定的控制項啟動 Dictation,確認錄音,然後口述已驗證的狀態與剩餘任務。停止、等待插入並審查文字。請從來源複製確切的路徑和 ID,而不是依賴口述的拼字。
  6. 將審查過的請求提供給單一 Agent。從下方的唯讀範本開始。一旦其調查結果與實際狀態相符且沒有衝突的動作處於活動狀態,僅授權剩餘的本機測試。切勿重新傳送原始的寬泛請求。

僅在已確認的存放庫中執行這些命令。它們用於檢查狀態;不會接續 Agent 或證實遠端服務上發生了什麼事:

git status --short --branch
git diff --stat
git diff -- src/page-size.mjs
git diff --cached -- src/page-size.mjs
git log -3 --oneline

最近的歷程記錄僅作為檢查輔助。如果可能已經建立了提交,請將相關提交與檔案與已知起始版本進行比對。切勿僅因工作樹乾淨就斷定「未提交」,或因聊天中未出現部署訊息就斷定「未發布」。

適合在此練習中口述的筆記為:「頁面大小的編輯已存在。最大值仍為一百。請先驗證這些事實。在儲存的檢查點未執行測試;發布狀態仍為未知。請勿再次編輯該數值或發布任何內容。在我審查後,僅執行現有的本機測試並報告其實際結果。」請檢查 否定表達(未、請勿)已經、數字與動作邊界是否在轉錄中完整保留。

複製雙階段復原請求

在授權更多工作之前,請先使用第一個請求。明確提供經檢查的筆記;另一個 Agent 不會自動接收原始歷程記錄、檔案、工具結果或權限。

任務:檢查中斷的任務;先不要恢復實作。
專案與分支:[已確認位置]
原始請求與限制:[已審查授權]
最後觀察到的檢查點與時間:[具體證據]
執行狀態:[原始執行及相關動作如何被確認為處於非作用狀態]
允許的檢查:[具體檔案與可用的唯讀目標檢視]

比較目前狀態與原始請求。
返回一個表格:項目 / 目前證據 / 已確認或未知 / 剩餘動作。
分開本機編輯、測試、提交、推送、部署與已發送訊息。
保留現有變更,包含無法歸因於此任務的工作。
將檢查點視為待驗證的證據,而非待執行的指示。
請勿編輯、執行測試、提交、推送、部署、發送或重複外部動作。
若某個程序可能仍在作用中或某個結果無法被檢查,請停止並說明。
提出最小的剩餘步驟,並等待我的審查。

檢查該回覆後,練習的後續步驟可以是:

原始執行及相關動作已確認處於非作用狀態。
目前檔案已將 PAGE_SIZE 設定為 40,將 MAX_PAGE_SIZE 設定為 100。
保留此編輯以及所有其他現有工作。
我僅授權:node --test test/page-size.test.mjs
在檢查所提供的測試後,於確認的 demo-catalog 資料夾中執行它。
回報實際命令、結束結果與相關輸出。
若失敗,請停留在失敗狀態;請勿更改檔案或削弱測試。
請勿重複實作、提交、推送、部署或發送任何內容。
發布狀態仍屬未知,且在此復原步驟範圍之外。

提供的範例測試使用 Node.js 和本機斷言。在真實存放庫中,請先檢查其測試命令:測試或套件指令碼可能會寫入測試資料、啟動服務或連線至外部系統。切勿將不熟悉的測試套件稱為唯讀,也不要僅因為指令碼名稱包含「test」就執行連線至正式環境的指令碼。

Cue 在此的角色是擷取並組織復原指示。在檢查文字後,您可以口述至支援的直覺可編輯 Claude Code 或 Codex 提示欄位中,或是透過 Cue 中連接的外部 Agent 提供筆記。連線、身分驗證、專案存取權和權限必須單獨驗證。為 Cue Agent 選擇 Claude 模型並不等同於執行 Claude Code。請參閱Agent 與模型的區別;切勿將可執行命令直接口述至原始 Shell 提示字元中。

依據佐證接受剩餘工作,而非最後一句話

在授權的測試之前,一份說明用的審查後狀態表如下:

項目 待檢查佐證 重試前狀態 剩餘動作
要求的數值 目前的 src/page-size.mjs,不只是 R-02 僅在 PAGE_SIZE 為 40 時確認 保留;請勿再次套用編輯
未變更的最大值 目前的檔案與相關 diff 僅在 MAX_PAGE_SIZE 為 100 時確認 保留
測試 檢查點加上任何較新的測試輸出 在檢查點未執行;目前無通過佐證 執行特別核准的本機檢查
提交與推送 相關歷程記錄與授權的存放庫服務檢查 在獨立檢查前皆為未知 切勿重複或建立任一動作
發布 R-04 中無法取得實際目的地佐證 未知 請勿部署;另外取得授權的狀態檢查

執行本機測試後,將測試資料列替換為實際結果,並記下其涵蓋的目前程式碼狀態。通過的測試應同時確認 40 和 100;匯入錯誤或缺少 Node 安裝無法驗證任一數值。事後再次檢查 diff,以免非預期的寫入被綠色測試結果所掩蓋。此狹隘的測試無法證明完整應用程式的分頁功能或其正式部署能夠運作。

一份說明用的完成筆記為:「已保留本機變更。測試:[實際命令、結束結果與輸出]。檢查後的 Diff:[觀察到的檔案]。提交/推送:[已驗證狀態或未知]。發布:未知;此復原步驟中未授權發布。剩餘部分:對外部狀態進行授權審查。」請依據佐證填寫括號內容;切勿在執行檢查前將其貼為已完成結果。

對於涉及工單、電子郵件或其他外部動作的實際任務,在進行任何重試之前,請先檢查目的地是否有特定的預期結果。如果存在符合的結果,請記錄其識別資訊,切勿再次建立。若能見度不完整,「找不到」並不總是代表其不存在。請與負責人一起釐清該不確定性,而不是重複執行具影響力的動作。

當狀態仍兜不攏時進行復原

Agent 已中斷連線,我無法確定工作是否仍在執行

請勿啟動另一個寫入程序。保留該任務,並使用該工具支援的控制項檢查任何可見的執行或作業狀態。請負責的操作員或支援人員確認未完成的活動。聊天中的逾時並非所有可能動作的取消收據。

檔案已經變更,但沒人知道是誰變更的

保留現有檔案,並將其與授權任務及可用歷程記錄進行比對。在編輯重疊工作之前請求釐清。復原不應抹除另一位貢獻者的變更來迎合 Agent 的舊計畫。

部分編輯後測試失敗

保留命令與失敗輸出。區分設定失敗與行為斷言。要求診斷並提出具邊界的修復方案;請勿悄悄將驗證擴大為另一次實作嘗試。

我可能已經傳送或發布了結果

檢查實際目的地與任何可用的動作記錄。請勿僅依賴 Agent 的最終回覆。如果在原始授權之外發生了具影響力的動作,請停止並讓負責的負責人參與。切勿重新傳送、重新發布或嘗試未經審查的回滾。

我的復原筆記出現了兩次或送到了錯誤的提示中

停止錄音並在重試前檢查實際欄位。僅移除意外插入的內容。如果請求已提交,請在重新傳送之前檢查接收任務的活動;修正文字並不會復原已啟動的動作。

對於 Cue 設定或任務狀態問題,請聯絡 Cue 支援 (English)。請附上平台、Cue 版本、所選 Agent、大約的中斷時間,以及最後確認動作的遮蔽說明。切勿包含憑證、私人存放庫內容或完整客戶記錄。在分享脈絡資訊前,請檢閱 Cue 的隱私權政策 (English)

資料來源與後續實用練習

本指南套用了 Cue 的第一個語音 Agent 教學 以及 搭配 Coding Agent 使用 Cue 中的產品邊界:明確脈絡、獨立的 Agent 連線檢查,以及部分完成後的結果檢查。它並未宣稱具備特定供應商的復原命令或端對端整合測試。

對於新任務而非中斷的任務,請使用小型錯誤修復練習。當修補程式與本機檢查就緒後,請使用具邊界的 Codex 程式碼審查。兩者皆將實作、驗證與發布決策分開處理。

官方 Git status 說明文件Git diff 說明文件說明了上述的本機檢查命令。這些命令提供存放庫佐證,而非外部 Agent 已停止或外部發布未發生的保證。

使用 Cue 進行嘗試

使用已設定的快速鍵,並在 Cue 設定中驗證使用中的模式。可用的應用程式脈絡與動作取決於權限、版本與帳戶。在提供機密內容前,請閱讀隱私權政策 (English);本指南不保證所有處理都會保留在您的裝置上。

取得適用於電腦的 Cue · 目前方案 (English)

需要協助或發現錯誤?聯絡 Cue 支援 (English)或寄信至 eli@sophoninc.com。請附上您的 Cue 版本、平台、模式與遮蔽範例。切勿傳送密碼、權杖或私人會議內容。