AIを使ってゲームに変更を加えるときは、変更内容を確認しやすく、適用やロールバックもしやすい形にしましょう。「変更したファイルだけを渡す」というルールは引き渡しに役立ちますが、プロジェクト全体が不要になるわけではありません。ソースコードは、シーンやアセット、設定、エンジンが生成するデータに依存することが多く、それらは変更の基準となるプロジェクトと整合している必要があります。

この記事では、架空のホテル経営ゲームを例に、レイトチェックアウトのルールに小さな変更を加える手順を説明します。これは仮のシナリオで、実際にパッチの適用、エクスポート、テストを行ったプロジェクトはありません。以下の手順に沿って変更範囲を絞って依頼し、別の開発者がレビューできる形にまとめます。
変更の基準と依頼内容を明確にする
編集を始める前に、プロジェクトとエンジンの正確なバージョン、作業に使うブランチまたはコピー、対象の挙動を担うファイルを特定します。変える点と維持する点を書き出しましょう。たとえば、客室料金、ゲストの到着ルール、日次の給与支払いスケジュールを維持したまま、レイトチェックアウトに応じて客室清掃に入れる時刻をずらせます。
AIアシスタントには、対象のスクリプト、呼び出し元、データスキーマ、プロジェクトの規約など、作業に必要な最小限の情報を渡します。依存関係の把握に追加のファイルが必要なら、推測させずにそのファイルを渡しましょう。まず変更計画を求め、そのうえでパッチを依頼します。追加・変更・削除するすべてのファイルと、関連するシーン、アセット、設定、マイグレーションの依存関係も明記してもらいます。
ローカルには、余計な変更の入っていない基準状態を確保しておきます。バージョン管理を使えば比較の基準を固定できます。一度きりの試行なら、別のコピーを用意する方法でも構いません。パッチに無関係な編集を混ぜないようにしましょう。作業前の状態が明確であれば、AIアシスタントが何を変えたかを正確に特定しやすくなります。
ファイル一覧と実際の差分を確認する
バージョン管理ツールで変更範囲を把握し、次に行単位で差分を確認します。Gitのドキュメントには、変更されたパスを一覧にするための差分表示オプションとして、name-onlyやname-statusが記載されています。これらの表示で、どのファイルが変わったかを把握できます。パッチが正しいか、コンパイルできるか、変更が意図した挙動だけに収まっているかは、ファイル一覧からは判断できません。
変更されたファイルを一つずつ依頼内容と照らし合わせます。ロジックの変更範囲が絞られているか、新たな依存関係やコードの削除、既定値の変更、共通システムへの編集があるかを確認しましょう。新規ファイルも既存ファイルと同じように丁寧に読みます。名前が変わったスクリプトをシーンが参照していないか、データ項目に既定値が必要か、スケジュールの変更がセーブデータや別のシステムに影響するかも確認します。
ファイルごとに、変更した理由を簡潔に説明してもらいます。ソースファイルに対応する生成ファイルや、エンジンのインポート時に作られるファイルがある場合は、プロジェクト側で再生成されるかを確認しましょう。変更ファイルが少ないという理由だけで、大幅な書き換えを受け入れないようにします。管理クラスを一つ変更しただけでも、ゲーム全体の挙動が変わることがあります。
ソースの引き渡しとゲームのエクスポートを区別する
ソースパッチは、対応するプロジェクトに適用するための変更一式です。スクリプトとデータファイルを含んでいても、シーン、スプライト、設定、エンジンのメタデータは含まれていないことがあります。対象の完全なプロジェクトに適用し、そのプロジェクトの通常のエディター操作、インポート、ビルド、エクスポートの手順に従います。ソースの一部をまとめたフォルダーだけで実行できるとは限りません。
一部のエンジンは専用のパッチパッケージに対応しています。Godotの安定版向けコマンドラインドキュメントには、変更ファイルを対象とするexport-patchオプションと、patchesオプションが記載されています。また、エクスポートコマンドで設定済みのプリセットを使うことや、ベースとなるエクスポートに関する注意点も説明されています。これはGodot固有のパッケージ化機能です。変更したソースファイルをZIPにまとめれば同じものになる、あるいはUnityなど他のエンジンでも同じ仕組みが使えるとは限りません。

レビュー担当者に渡す場合は、変更ファイル、読みやすい差分、依存関係のメモ、プロジェクトとエンジンのバージョン、正確な適用手順を含めます。特定のプラットフォーム向けのビルドやエンジン用のパッチが成果物なら、エンジンがサポートするエクスポート手順で作成し、その成果物自体をテストします。どちらを渡すのか明記しましょう。
別の開発者が理解できるパッチを依頼する
依頼の範囲を絞るには、たとえば次のように伝えます。「変更はレイトチェックアウト時のスケジュールルールに限り、客室の割り当て、料金、ゲストの到着、給与支払いの処理は維持してください。無関係なシーンには手を加えず、変更ファイルと新規ファイルを一覧にし、必要な依存関係とロールバック手順を記載してください」。どの状態を基準にするかを明示したうえで、unified diff形式の差分、または変更したファイルだけをまとめたディレクトリを出力してもらいます。
作業中のプロジェクトに上書きする前に、パッチをレビューします。パスがプロジェクトルートからの相対パスになっているか、ファイル名が正しいか、シークレットやローカルキャッシュのファイルが含まれていないか、新しいコードがプロジェクトの規約に沿っているかを確認します。ファイル全体を置き換えるパッチなら、元のファイルと比較して、変更対象外の内容が失われないことを確かめましょう。
パッチを適用したら、バージョン管理ツールで作業状態を確認します。AIアシスタントが2ファイルの変更と説明しているのに、差分では10ファイルが変わっている場合は、作業を止めて理由を調べます。エンジンのインポート処理で生成ファイルが更新されることもあります。そうした変更は意図したソースの変更と区別し、プロジェクトの通常のリポジトリ運用方針に従います。
パッチを適用し、ビルドして挙動を検証する
作業用のコピー、または未反映の変更がないブランチにパッチを適用し、想定されているバージョンのエンジンでプロジェクト全体を開きます。依頼した挙動を確認する前に、インポートやビルドのエラーを解消します。ホテルの例では、レイトチェックアウトの日付、客室の空き状況、ゲストの到着、客室清掃のスケジュールを検証し、変更対象外の料金や給与支払いも従来どおりであることを確認します。
変更前後を比較できるよう、プロジェクトのバージョン、変更ファイル、手順、期待した結果、実際の結果を記録します。通常の操作や境界条件に加え、変更したデータが永続化される場合は保存と再読み込みを試し、ロールバックもテストします。成果物がダウンロード用のビルドなら、エディターのプレビューだけで済ませず、対象プラットフォームでそのビルドをテストします。

ロールバックの対象を絞り、慎重に元に戻す
変更を適用する前に、余計な変更の入っていない状態を復元できるようにしておきます。パッチに問題があれば、パッチで変更したファイルだけを復元するか、パッチを単独で記録したコミットを取り消します。Gitのrestoreコマンドで指定したパスを復元できますが、そのパスにある現在の作業ツリーの変更も破棄されます。先に無関係な作業が含まれていないか確認してください。
ロールバックの結果も検証します。プロジェクトを開き直し、元の挙動に戻ったことと、未コミットの作業が失われていないことを確かめましょう。AIアシスタントのパッチがほかのローカル変更と混在している場合は、広範囲に影響するリセットやクリーンアップのコマンドを避けます。
よくある質問
変更したゲームのソースファイルだけをAIアシスタントに渡せますか?
はい。関連する周辺コード、プロジェクトの規約、制約もあわせて渡すことが条件です。基準となる完全なプロジェクトはローカルに保持し、差分の提示を依頼します。引き渡し資料に、変更したファイルが必要とする依存関係が記載されているかを確認しましょう。パスとバージョンの詳細も引き渡しメモに明記します。
変更ファイルをまとめたパッケージだけで、完全なゲームビルドを作れますか?
いいえ。ソースファイルが、パッケージに含まれないシーン、アセット、設定、生成ファイル、エンジンのインポートデータに依存している場合があります。対応する完全なプロジェクトにパッチを適用し、そのプロジェクトの通常の手順でビルドまたはエクスポートします。基準としてどの完全なプロジェクトが必要かをレビュー担当者に伝えましょう。
Gitで変更されたファイルだけを一覧表示するにはどうすればよいですか?
対象の基準状態に対して、Gitのname-onlyやname-statusなどの差分表示を使い、そのうえで実際の差分も確認します。ファイル一覧から分かるのは変更範囲です。コードが正しいか、安全かは判断できません。差分を読み取れる程度に、作業ツリーに余計な変更がないことも確認します。
Godotでは変更したファイルだけをエクスポートできますか?
Godotの安定版向けコマンドラインチュートリアルには、変更ファイルを対象とするexport-patchオプションと、パッチのリストについての説明があります。この機能にはエクスポートプリセットと互換性のあるベースエクスポートが必要です。ソースフォルダーをZIPにまとめる一般的な方法や、単体で動作するビルドとは異なります。使用するエンジンのバージョンに対応したドキュメントに従い、プリセットとベースエクスポートの要件を満たしてください。
AIが作ったゲームコードのパッチをロールバックするにはどうすればよいですか?
変更を適用する前に、基準状態を保持するか、バージョン管理で余計な変更の入っていないチェックポイントを確保します。レビュー済みのファイルだけを復元するか、パッチを取り消してから再ビルドし、元の挙動を確認します。未コミットの作業がある場合は、広範囲に影響するクリーンアップのコマンドを避けます。復元したプロジェクトがビルドでき、元の挙動に戻っていることを確かめてください。
引き渡す内容を明確にする
完全なプロジェクトを正式な原本として管理します。依存関係と変更の基準を添えて、レビューしやすい小さなパッチを渡し、プロジェクトの通常の手順でビルドとテストを行います。別の開発者は必要な変更ファイルを受け取れますが、それらのファイルだけでゲームが完成するわけではありません。
別のアイデアをブラウザーで遊べるプロトタイプにしたい場合は、SEELE AI Game Makerを試してみてください。これはプロトタイプを作るための別の方法であり、コードにパッチを当てたり、既存プロジェクトをエクスポートしたりする機能ではありません。


