AI 程式助理可以持續處理失敗檢查,但檢查本身與最終程式碼仍須由你審查。本指南適合負責程式庫、已有一項測試、建置或程式碼風格命令失敗的開發者。使用 Claude Code 中範圍明確的 Goal,或另選互動式 Codex CLI,擇一即可。完成標準是原始命令在審查過的修改上通過,且保留事先指定的行為。不能證明時,應保留失敗與確切阻礙。本程序根據文件;BIG CHANGE 未為本文執行 Goal 或修復程式庫。

關鍵變化

  • 改變了什麼: 文件中的 /goal 命令讓目標跨回合持續,助理可調查失敗、做限定範圍修改並再次檢查,不必每回合重新給指示。
  • 為何重要: 開始前可定義原始失敗命令、允許檔案與受保護行為,讓接續嘗試具有相同驗收目標。
  • 應注意什麼: Goal 狀態或模型判定不能證明修復。閱讀真正輸出與最終差異,由你決定是否接受。

開始前:記錄失敗與界線

使用你有權修改的程式庫。閱讀本機指示,包括存在的 AGENTS.md 或 CLAUDE.md ,並檢查分支、既有修改與未追蹤檔案。在 Git 程式庫,以下命令可建立初始清單:

Terminal
git status --short
git diff --stat
git diff

保留清單以區分助理改動與原有工作。執行一次 真正失敗的檢查 ,或保存近期可信執行的確切命令、完整錯誤和結束狀態。不要換成本文範例命令。若依賴無法存取的服務、機密或平台,先記錄。已知的單一修改或許更適合普通請求;每次檢查結果決定下一診斷步驟時,Goal 才有用。

在 Goal 之外寫簡短驗收備註:確切原始命令、目前輸出、助理可用路徑及工具、必須保留的行為或其他檢查,以及須停下審查的決定。明確保護既有無關修改。不要讓助理刪除或放寬檢查來製造通過。授權工具前親自審查備註。要求若干回合後停止可引導模型,卻不保證支出上限。

1. 選擇一種 Goal 介面

對於 Claude Code,開啟指定程式庫工作階段,確認 /goal 可用。其 Goal 手冊於 2026 年 10 月 20 日查核,說明命令取決於工作區信任及勾點設定。每個工作階段只能有一個作用中 Goal。新條件會取代舊條件並立即開始。Goal 不改變權限模式:手動模式仍可在工具呼叫前詢問,自動模式是另一設定。保留本工作對檔案、命令和網路存取的原有控制。

若選擇 互動式 Codex CLI 替代方案,檢查安裝版本與斜線命令清單。OpenAI 的 Goals 實用指南 指出功能始於 Codex 0.128.0。其 使用情境指南 記載 features.goals 開關,供命令缺少時檢查。這些是在你安裝環境進行的檢查;本文並未執行:

Terminal
codex --version
codex features enable goals

僅在安裝需要且組織允許時啟用。這裡的 Codex 指示適用互動式 CLI,不要假設 codex exec 或每個桌面版本都有相同支援。命令仍缺少時先停下,檢查版本、功能設定及帳戶或工作區存取,再選其他方法。

2. 設定限定範圍的條件

使用 /goal ,接上審查後的條件。填入真實檢查命令和允許路徑,不要貼虛構測試名稱。例如:「只使用驗收備註允許的路徑和工具,讓我的檢查通過(它目前已失敗)。每次嘗試後顯示命令、完整結果及修改檔案。保留受保護行為和無關修改。若檢查無法執行或已無安全的範圍內修改,請停止並提供確切錯誤、嘗試修改及需要我補充的資訊。」開始前將「我的檢查」換成確切命令,附上或指向審查後備註。

兩種文件中的 /goal 命令都接受最多 4,000 字元的非空條件。詳細限制留在備註,不要硬塞進上限。在 Claude Code, /goal <condition> 立即開始回合;互動式 Codex CLI 的 /goal <objective> 將持續目標附加至目前聊天。兩者都不授予新檔案、命令或帳戶權限。修復若需更大路徑、外部服務、機密、合併或部署,應暫停等待擁有者決定。

3. 工作時查看證據

每次有意義的嘗試後,要求確切命令輸出與修改檔案清單。不帶參數執行 /goal 可看狀態。Claude Code 在評估後顯示經過時間、評估回合、權杖用量及評估器最新理由。評估器讀取 Claude 在對話中呈現的內容;它 不會 獨立執行檢查或查看檔案。因此「met」判定代表要驗證,不是程式庫修好的證據。Codex 的 Goal 狀態同樣要以命令輸出與差異確認結果。

維持原始範圍。核准前讀取擬執行命令,尤其涉及刪檔、改寫歷史、向外傳送資料或改權限時。原始檢查被弱化、無關檔案無解釋地變動,或將洩漏私密資料時應停下。無法安全授權下一步時,記錄 Goal 狀態並要求更小範圍的計畫。

4. 親自驗證完成結果

助理報告成功時,對照初始清單審查完整最終差異。逐一確認改動或新增檔案符合允許路徑。可行時重跑 同一個原始檢查命令 ,保存完整輸出和結束狀態。執行驗收備註中相關且未改的測試,並檢查修補應保留的行為。替代檢查通過不能滿足約定。

只有證據符合審查條件、且你同意差異,才接受修改。提交、合併和部署各自需授權。驗證失敗時,保留原始命令及輸出、修改檔案、Goal 狀態和缺少的特定權限、依賴或決定。暫停、中斷、不可能、受阻或預算受限的 Goal 不是完成的修復。

Goal 停止或卡住時

在 Claude Code中, /goal 顯示目前條件及最新理由; /goal clear 移除作用中 Goal。其 手冊 指出恢復工作階段可還原作用中條件,但時間、回合和權杖基準會重設。工作階段選取器還原問題於 v2.1.239 修正。Claude Code 管理憑證的驗證失敗、額度耗盡、不可復原的上下文溢位和模型不可用,可能清除 Goal。主機管理的驗證可能使它保持作用。其他錯誤可能保留目標並重試或暫停;v2.1.269 及以後版本記載互動重試和暫停提示。設定或恢復前,閱讀警告、狀態、保存輸出與工作差異。新條件取代舊條件。

在 互動式 Codex CLI中, /goal 顯示目標,而 /goal edit、 /goal pause、 /goal resume 和 /goal clear 是 CLI 命令參考記載的控制項。其 實用指南 區分完成、暫停、中斷、預算限制及阻礙。恢復或更改目標前,檢查狀態與實際程式庫證據。預算或存取限制使工作停止時,精確阻礙可能比再次嘗試更有用。

模型回合消耗帳戶額度或點數,Claude Code 的獨立評估器也用權杖。檢查自己帳戶目前的控制及限制。文字中的時間或回合要求不能保證美元支出上限。僅用獲准程式庫資料,排除機密和無關私密檔案;程式庫內指示應先審查,再讓助理遵循。

若需要另一設定工作的背景,可讀我們的 Codex Cloud 環境指南 ,了解連接和準備遠端程式庫。 共用 Team Tasks 指南 說明 ChatGPT 定期工作。上述本機失敗檢查流程不需要這兩種設定。

來源與延伸閱讀