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 或每个桌面版本都支持。