AI-translated from English; not yet reviewed by a fluent editor.

# 用 AI Goal 修復並驗證一個失敗的程式庫檢查

> 為現有失敗檢查設定範圍明確的 Claude Code 或 Codex CLI Goal，接受修復前驗證原始命令與最終差異。

By BIG CHANGE Editorial

Published: 2026-10-20T05:48:37.854Z
Updated: 2026-10-20T05:48:37.854Z
Canonical: https://bigchange.ai/blog/ai-goal-failing-repository-check-guide

![Conceptual charcoal illustration of a developer reviewing a code diff beside a laptop showing an unresolved check.](https://bigchange.ai/api/media/file/ai-goal-failing-check-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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

## 關鍵變化

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

## 開始前：記錄失敗與界線

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

```sh
git status --short
git diff --stat
git diff
```

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

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

## 1. 選擇一種 Goal 介面

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

若選擇 **互動式 Codex CLI 替代方案**，檢查安裝版本與斜線命令清單。OpenAI 的 [Goals 實用指南](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) 指出功能始於 Codex 0.128.0。其 [使用情境指南](https://learn.chatgpt.com/use-cases/follow-goals) 記載 `features.goals` 開關，供命令缺少時檢查。這些是在你安裝環境進行的檢查；本文並未執行：

```sh
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。其 [手冊](https://code.claude.com/docs/en/goal) 指出恢復工作階段可還原作用中條件，但時間、回合和權杖基準會重設。工作階段選取器還原問題於 v2.1.239 修正。Claude Code 管理憑證的驗證失敗、額度耗盡、不可復原的上下文溢位和模型不可用，可能清除 Goal。主機管理的驗證可能使它保持作用。其他錯誤可能保留目標並重試或暫停；v2.1.269 及以後版本記載互動重試和暫停提示。設定或恢復前，閱讀警告、狀態、保存輸出與工作差異。新條件取代舊條件。

在 **互動式 Codex CLI**中， `/goal` 顯示目標，而 `/goal edit`、 `/goal pause`、 `/goal resume` 和 `/goal clear` 是 [CLI 命令參考](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal)記載的控制項。其 [實用指南](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) 區分完成、暫停、中斷、預算限制及阻礙。恢復或更改目標前，檢查狀態與實際程式庫證據。預算或存取限制使工作停止時，精確阻礙可能比再次嘗試更有用。

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

若需要另一設定工作的背景，可讀我們的 [Codex Cloud 環境指南](https://bigchange.ai/blog/codex-cloud-environment-setup-guide) ，了解連接和準備遠端程式庫。 [共用 Team Tasks 指南](https://bigchange.ai/blog/chatgpt-team-tasks-shared-recurring-work-guide) 說明 ChatGPT 定期工作。上述本機失敗檢查流程不需要這兩種設定。

## 來源與延伸閱讀

- [Claude Code：讓 Claude 持續朝目標工作](https://code.claude.com/docs/en/goal) 說明 `/goal`、評估器可見性、權限、恢復、錯誤及用量。不驗證你的程式庫修復。
- [OpenAI：在 Codex 使用 Goals](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) 說明 CLI 最低版本、目標約定、生命週期和證據檢查。範例不是本文結果。
- [OpenAI：跟進目標](https://learn.chatgpt.com/use-cases/follow-goals) 說明功能開關與持續目標。能否存取取決於讀者安裝和帳戶。
- [OpenAI：Codex CLI 開發者命令](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal) 記載互動式 `/goal` 控制項。應在本機確認 CLI 支援。

## Sources

- [Claude Code，讓 Claude 持續朝目標工作](https://code.claude.com/docs/en/goal) — 記載工作階段 Goal、評估器限制、權限、用量及版本限定恢復。不獨立證明測試成功或程式庫已修復。
- [OpenAI，在 Codex 使用 Goals](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) — 記載 CLI 最低版本、有限目標、生命週期及證據檢查。本文未執行頁面範例。
- [OpenAI，跟進目標](https://learn.chatgpt.com/use-cases/follow-goals) — 記載互動式 Goal 與功能開關。不證明讀者安裝或帳戶已能使用。
- [OpenAI，Codex CLI 開發者命令](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal) — 記載確切互動式 /goal 狀態查看與 edit、pause、resume、clear 控制，以及 4,000 字元條件上限；未聲稱 codex exec 或所有桌面版本均支援。