code-review-graph は GitHub アクションに接続します。増分グラフの構築、PR レビュー、キャッシュのデバッグ

code-review-graph によるこのチュートリアルでは、タイトルにある特定のタスクのみを扱います。このプロジェクトは Tree-sitter を使用してローカル構造マップを構築し、MCP を通じてコード レビュー コンテキストを絞り込みます。 CI の鍵となるのは、増分マッピング、キャッシュ境界、および最小限のアクセス許可です。

以下のすべての操作は、最初に、ループバックアドレスのみでリッスンするテストリポジトリ、テスト アカウント、またはサービスに配置されます。コマンド内のドメイン名、ユーザー名、パス、およびキーはプレースホルダーであるため、実行前に置き換える必要があります。

PR レビューに永続的なコード マップが必要な理由

このセクションでは、「PR レビューでコード マップを永続化する必要がある理由」について説明します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

コード レビュー グラフの場合、判断基準は次のとおりです。プロジェクトは Tree-sitter を使用してローカル構造グラフを構築し、MCP を通じてコード レビュー コンテキストを絞り込みます。 CI の鍵となるのは、増分マッピング、キャッシュ境界、および最小限のアクセス許可です。この段階で誤ってさらに許可を開かないでください。

1
2

python --version
pipx --version

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

Python 3.10とpipx環境の準備

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

pipx install code-review-graph

ここでの完了基準は、インターフェイスが表示されることではなく、「Python 3.10 と pipx 環境の準備」で再現可能な結果が得られることです。

最初のビルドではどのディレクトリを実行する必要がありますか?

1

code-review-graph build

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

Codex のみの MCP 構成をインストールします

「Codex のみの MCP 構成をインストールする」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

code-review-graph install --platform codex

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

生成されたグラフがターゲット言語をカバーしているかどうかを確認する

このセクションでは、「生成されたグラフがターゲット言語をカバーしているかどうかの確認」について説明します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

コード レビュー グラフの場合、判断基準は次のとおりです。プロジェクトは Tree-sitter を使用してローカル構造グラフを構築し、MCP を通じてコード レビュー コンテキストを絞り込みます。 CI の鍵となるのは、増分マッピング、キャッシュ境界、および最小限のアクセス許可です。この段階で誤ってさらに許可を開かないでください。

1

code-review-graph build

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

GitHub Actions のトリガー条件を設計する

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

git diff --name-only origin/main...HEAD

ここでの完了基準は、インターフェイスが表示されることではなく、「GitHub Actions のトリガー条件の設計」に再現可能な結果が得られることです。

キャッシュ キーをバインドするファイルはどれですか?

1

git rev-parse HEAD

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

Fork から PR の権限を減らす方法

「Fork からの PR がどのように権限を削減するか」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

git status --short

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

マップが無効な場合は通常の git diff に戻ります

このセクションでは、「マップが失敗したときに通常の git diff に戻る」という問題を解決します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

コード レビュー グラフの場合、判断基準は次のとおりです。プロジェクトは Tree-sitter を使用してローカル構造グラフを構築し、MCP を通じてコード レビュー コンテキストを絞り込みます。 CI の鍵となるのは、増分マッピング、キャッシュ境界、および最小限のアクセス許可です。この段階で誤ってさらに許可を開かないでください。

1

git diff --stat origin/main...HEAD

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

ローカル結果と CI 結果の違いを再現します

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

code-review-graph build

ここでの完了基準は、インターフェイスが表示されることではなく、「ローカルと CI の結果の違いを再現する」ことで再現性のある結果が得られることです。

パーサーをアップグレードした後にキャッシュを再構築する

1
2

pipx upgrade code-review-graph
code-review-graph build

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

PR レビューの最終証拠には何を含めるべきですか?

「PRレビューの最終証拠に何を含めるべきか」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

git diff --check

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

Monorepo のマッピング ディレクトリを削減します。

このセクションでは、「Monorepo でのマッピング ディレクトリの削減」について説明します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

コード レビュー グラフの場合、判断基準は次のとおりです。プロジェクトは Tree-sitter を使用してローカル構造グラフを構築し、MCP を通じてコード レビュー コンテキストを絞り込みます。 CI の鍵となるのは、増分マッピング、キャッシュ境界、および最小限のアクセス許可です。この段階で誤ってさらに許可を開かないでください。

1

git diff --name-only origin/main...HEAD

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

Tree-sitter による解析に失敗したファイルを見つける

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

code-review-graph build

ここでの完了基準は、インターフェイスの外観ではなく、「Tree-sitter による解析に失敗したファイルの検索」の再現可能な結果です。

マップ プロダクトをソース コード バージョンにバインドします

1

git rev-parse HEAD

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

グラフを有効にする前と後のコンテキスト オーバーヘッドを比較します。

「グラフ有効化前後のコンテキストオーバーヘッドの比較」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

git diff --stat origin/main...HEAD

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

コードレビューグラフ FAQ

テスト環境をスキップして、公式プロジェクトでコードレビューグラフを直接使用することは可能ですか?

お勧めしません。まず、少なくとも 1 つの最小限の成功リクエスト、1 つの意図的な失敗、および 1 つの回復訓練を完了します。

code-review-graph コマンドは実行できますが、結果が正しくありません。まずどこを確認すればよいでしょうか？

まず入力範囲、実際の有効構成、および上流の応答を確認し、次にモデルの概要を確認します。プロセスが正常であっても、ビジネス結果が正しいとは限りません。

コードレビューグラフのキーまたはトークンが Git に入るのを防ぐにはどうすればよいですか?

システム環境変数、シークレット管理、またはプロジェクト外部の構成ファイルを使用し、コミットする前に差分を検索します。侵害が発見された後は、キーをローテーションする必要があります。

コードレビューグラフをアップグレードするときに見落とされる可能性が最も高いものは何ですか?

最も見逃しやすいのは、構成形式、デフォルトのリスニング アドレス、アクセス許可の範囲、キャッシュの互換性です。アップグレードする前に、バージョンと検証サンプルを保存してください。

コードレビューグラフの受け入れの問題

完了すると、次の質問に答えられるようになります。

• 正確にどのバージョンを使用していますか?
• どのディレクトリ、ポート、アカウント、外部サービスにアクセスできますか?
• 成功結果を元のデータまたは Git diff に戻すにはどうすればよいですか?
• アップストリームに障害が発生した場合、エラーが報告されるか、再試行されるか、または切り替えられますか?
• キーがログまたは履歴に表示される可能性はありますか?
• 10分以内に修正前の状態に戻すにはどうすればよいですか?

これらのいずれかに答えられない場合、コードレビューグラフはまだ試用版の状態にあるため、権限を拡張したり、運用自動化にプラグインしたりしないでください。