世界は立ち止まらない。RSS
BIG CHANGE.

Markdown版

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 や全デスクトップ版の対応は主張しません。