大きな変更を6本のPRに分け、AIレビューから統合まで進めた実例
20ファイルの変更で必要なソースがレビュー担当へ届かず、判定が停止。依存順の6PRへ分け、試験を移し、監視処理の欠陥を修正して統合した実例から、審査単位の決め方を説明します。

20ファイルにまたがる変更をAIレビューへ渡したところ、判定不能で止まりました。変更前と変更後を含む比較用ソース入力は1,449,118 bytes。Netsujoのレビュー構成では、変更全体に関する判断を求めた担当へ、その判断に必要なソースが届いていませんでした。
そこで、変更を依存順のある6本のプルリクエスト(PR)に分けました。それぞれを正式レビューへ出し、途中で見つかった欠陥を修正して、ソースへ統合しています。この記事では、分割の境界をどう選び、テストと依存関係をどう扱ったかを説明します。
1. 判定不能になった理由を特定する
対象は、AIによる実行の書込範囲を評価し、実行経路へ接続する変更でした。共通の判定ライブラリ、実行環境への登録、仕事の割当、起動、監視、終了時の確認が関係します。あるファイルの正しさを判断するだけでは、全体として必要な条件が守られるかを確かめられません。
当時の自社QCは、比較用ソース入力が512 KiB、つまり524,288 bytesを超えると、入力を複数の窓へ分ける審査方式に切り替えていました。この値は自社のレビュー方式を切り替える条件です。モデル一般が読める量の上限を示すものではありません。
問題になったのは、26の要素にまたがる統合条件を判断する窓へ、必要なソースが渡っていなかったことです。関連する部分の名前や、判断すべき項目が分かっていても、実装そのものを確認できなければ、条件が成立すると結論できません。
判定を止めた判断は妥当でした。こちらが見直すべきだったのは、レビュー担当へ届ける材料と、担当に求める判断の対応です。レビューの依頼文を強くしたり、根拠のない推測で穴を埋めたりすることでは、ソースの不足は解消しません。
この整理によって、次の作業が具体化しました。各段の判断に必要なソースが、その段の審査へ届くように変更単位を作ります。
2. 6本を、依存する順番に分ける
分割では、共通の判定を先に置き、その判定を使える状態にしてから、実行経路へ接続しました。以下は、分割案を作った時点の比較用ソース入力です。変更前のBASEと変更後のHEADを含みます。
表:分割案作成時の比較用ソース入力
| 順序 | 審査する変更 | ソース入力(bytes) | 次段との関係 |
|---|---|---|---|
| 1 | 書込範囲を評価するライブラリと単体試験 | 77,773 | 後段が呼び出す判定を先に確認する |
| 2 | 実行環境へライブラリを含める登録 | 283,510 | 必要なコードが配布対象に入る |
| 3 | 作業割当時の能力確認 | 285,157 | 対象の実行経路を選べる状態にする |
| 4 | 実行開始処理と評価の接続 | 250,550 | 評価を実際の起動経路へ結ぶ |
| 5 | 起動・監視処理と終了時の確認 | 369,206 | 実行前後の条件を扱う |
| 6 | macOS固有の起動試験 | 318,826 | OS固有の経路を確認する |
出典:Netsujoの変更分割記録。元の比較用ソース入力は1,449,118 bytesです。表は分割案を作った時点の値で、最終の各モデル要求の総入力量やtoken数ではありません。合計は1,585,022 bytesで、元より増えています。総量は減っていません。 512 KiBは、この自社QCで分割審査へ切り替える条件です。
表の各部分は、その条件の下で通常の1回の審査に収まる構成になりました。分割によって作ったのは、判断する範囲と受け取るソースが対応する単位です。共通する文脈を複数の審査へ渡すため、合計量が増えることとも両立します。
また、分割案の数値と、実際の最終レビューに渡した入力は区別しています。分割後には修正も入り、正式レビューの入力構成にも違いがあります。この表を最終実行の全入力として合算し、費用や速度の改善を評価することはできません。
3. テストも依存先と一緒に配置する
最初のライブラリには、その判定を確認する単体試験を付けました。これにより、後段が呼び出す判定の前提を先に確かめられます。次の登録段階では、そのライブラリが配布対象に含まれるソース上の構成を扱い、作業割当、実行開始へと接続を進めました。
この順序には、審査で答える問いを絞る役割があります。ライブラリの段階では「この入力に、この判定を返すか」。実行開始の段階では「必要な箇所で、その判定を使っているか」。起動・監視の段階では「実行前後や別の経路でも、確認が保たれるか」を扱います。各段を分けても、全体の目的は維持します。
テストの依存関係にも同じ整理が必要でした。後段の実行開始処理が入ってから成立する試験は、その処理を導入する段へ移して戻しました。先行するPRに未導入の機能を前提とする試験を置くと、そのPRだけを検証できません。一方、分割の途中で試験を外したままにすると、最終的に確かめるべき経路が抜けます。
実務で同じ方法を取るなら、各PRに「この段で確認すること」「前段が提供する前提」「後段で戻す試験」を記録しておくと、移動した試験を追えます。統合時には、元の変更目的に対する試験がどこで実行されるかを照合します。
この事例の6本には依存順があります。担当を増やして同時に進める設計とは異なり、前段で確かめた条件を次段が使います。並列化できる範囲を考える場合も、その依存が成立していることを先に確認します。
4. 分割後のレビューで、実際の欠陥を直す
分割後の審査では、起動・監視処理に欠陥が見つかりました。再起動した監視処理が一部の経路で、書込範囲の確認を省く可能性がありました。この指摘を受けて修正し、修正後の候補を正式レビューへ戻しています。
監視処理が起動し直せることと、起動し直した後も必要な確認を通ることは、別の条件です。通常の起動経路を確認しただけでは、復帰時の経路まで同じ条件が保たれると判断できません。今回の欠陥は、この接続部分にありました。
この発見があるため、成果を「変更内容を一切変えず、分割しただけで通した」と説明することはできません。初期の分割では同じ変更目的を保ちましたが、その後にレビュー結果を受けた実装の修正を加えています。
審査単位が具体的になったことで、起動・監視・終了時の条件を確認する段で、その経路の問題を指摘できました。これはこの事例で確認できた結果です。分割すれば必ず欠陥が見つかる、あるいは全体の安全性が保証されるという一般化はしていません。
読者が自社の変更へ移すなら、正常系に加えて、再起動・復帰・終了のように同じ条件へ戻る経路を、どのPRが審査するか決めると役立ちます。経路をまたぐ条件は、担当が分かれるほど明示しておく必要があります。
5. 成立した成果を、ソース統合として記録する
6本は2026年11月18〜19日に、それぞれの候補に対する正式レビューを経てソースへ統合しました。途中のレビューでは、再起動した監視処理が一部の経路で書込範囲の確認を省く欠陥も見つかり、修正しました。ここで確認した成果は、この変更群のソース統合です。
各候補で正式レビューを通過したことと、実行するすべての端末や、そのコードを使うすべての仕組みで受入が終わったことは、別に確認します。配布対象への登録がソースへ入っていても、実機がその版を採用し、必要な経路を動かした証拠が要ります。この記事は、その全実機受入や製品本番の動作完了を報告するものではありません。
また、元の1本と分割後の6本について、総token、料金、完了までの時間を同じ条件で比較していません。比較用ソース入力の合計も増えています。この取り組みで実証した価値は、審査できる変更単位を作り、具体的な欠陥を修正しながら統合へ進めたことにあります。
6. 実装を分ける前に、レビューの単位を決める
同じ問題に直面したときは、まず判定が止まった箇所を特定します。必要なソースの欠落、曖昧な受入条件、実装上の欠陥では、次に変えるものが違います。今回のように材料が届いていない場合は、入力の構成と審査の責任範囲を合わせます。
分割案は、次の順序で作ると判断を具体化できます。
- 各段で答える問いを一文にする。 共通の判定、配布への登録、実際の呼出しなど、確認する条件を明記します。
- その問いに必要なソースを列挙する。 差分の行だけで足りるか、呼出し元・呼出し先・未変更部分も必要かを確認します。
- 依存する順番を決める。 前段が提供する条件と、後段がそれを使う場所を対応させます。
- 試験の置き場所を決める。 各PRで成立する試験と、後段で戻す試験を記録します。
- 最後の受入範囲を決める。 ソース統合、端末への採用、実行経路の確認、本番での確認を、それぞれ必要な証拠と結び付けます。
ファイル数やbyte数は、この計画が自社のレビュー構成で実行できるかを確かめる材料です。小さく切ることだけを目標にすると、関連する実装が離れ、かえって判断に必要な文脈を失う場合があります。問いとソースが一緒に届く大きさを選びます。
AIレビューを導入する際には、モデルへ何を渡すかと、どこまで判断を任せるかをセットで設計します。今回の6PRは、その対応を見直し、実際の指摘を直して統合した一例です。
自社のAI開発で、検証・レビュー・統合の境界を整理したい方は、AI開発・レビュー工程の設計を相談するからご相談ください。支援範囲はAI実装支援にまとめています。