開始する前に
- GDK をインストールします。例では October 2026 GDK (エディション
261000) を使用しています。261000は、ゲームのビルドに使用するエディションに置き換えてください。 - Model Context Protocol (MCP) サーバーへの接続、コンピューター上のファイルの読み取り、コマンドの実行のいずれかが可能なエージェントを使用します。ほとんどのコーディング エージェントは、これら 3 つすべてに対応しています。
- 機密コンテンツに対して組織が承認している AI ツールを確認します。GDKX のドキュメント、ヘッダー、ツールは機密情報です。
エージェントに提供する GDK のコンテキストを選択する
オンラインのソースは、現在の GDK について説明しています。以前の GDK でビルドする場合は、インストール済みのヘッダーとオフラインのドキュメントもエージェントに提供して、使用している GDK に存在しない API をエージェントが使用しないようにします。
XBOX ドキュメント MCP サーバーに接続する
https://docs.xbox.com/mcp にある XBOX ドキュメント MCP サーバーを使用すると、エージェントは公開されているドキュメントを検索して引用できます。API キーやサインインは必要ありません。たとえば Visual Studio Code では、プロジェクトの .vscode/mcp.json ファイルにサーバーを追加します。
.vscode/mcp.json
https://docs.xbox.com/llms.txtには、全ページが短い説明とともに一覧表示されます。https://docs.xbox.com/llms-full.txtには、ドキュメントの全文が 1 つのファイルに含まれています。- 任意のページの URL の末尾に
.mdを追加すると、そのページを Markdown として取得できます。
エージェントにオフラインのドキュメントを提供する
GDKX は、GDK エディションのxbox\documentation フォルダーにある GDKDocumentationMarkdown.zip に、GDK のドキュメントを Markdown ファイルとしてインストールします。これらのファイルはインストールした GDK と一致するため、そのバージョンに関して最も正確なドキュメント ソースになります。
各ページは YAML フロントマターで始まります。permissioned-type の値は、ページのアクセス分類 (public、private、secret のいずれか) を示します。アーカイブのルートにある site-map.md ファイルには、ページの一覧が含まれています。
-
ソース リポジトリの外にあるフォルダーにアーカイブを展開します。PowerShell で次のコマンドを実行します。
-
AI ツールが機密コンテンツに対して承認されていない場合は、公開ページのみを残します。次のコマンドは、
permissioned-typeがpublicではない Markdown ファイルをすべて削除します。このフィールドを持たないファイルも削除されます。 - エージェントにフォルダーへのアクセスを許可します。たとえば、フォルダーをエディターのワークスペースに追加するか、プロジェクト指示ファイルでフォルダーを指定します。
インストール済みのヘッダーとツールをエージェントに示す
GDK インストーラーは、インストール済みの GDK の場所をエージェントに伝える環境変数を設定します。GameDKは GDK のルート フォルダーです。コマンドライン ツールのbinフォルダーと、%GameDK%261000\などのインストール済みの各エディションのフォルダーが含まれています。GameDKCoreLatestとGameDKXboxLatestは、インストール済みの最新のエディションを指します。
%GameDK%261000\ など、ゲームで使用しているエディションのフォルダーをエージェントに指定してください。
各エディションの下にあるフォルダーについては、GDK のヘッダーとライブラリのディレクトリ構造 を参照してください。API を使用する前に、PC の場合はエディションの windows\include フォルダー、XBOX 本体の場合は xbox\include フォルダーにあるヘッダーで宣言を確認するよう、エージェントに指示します。XBOX サービス API (XSAPI)、libHttpClient、PlayFab のヘッダーなど、一部のヘッダーには、各 API について説明するドキュメント コメントも含まれています。
%GameDK%bin にあるコマンドライン ツールは、/? を付けて実行すると使用方法を出力します。エージェントは、ツールのオプションを推測する代わりに、ツールを使用する前にそのツールの /? を実行できます。HRESULT を説明に変換するには、xberror.exe を使用します。
バージョンが一致したサンプル コードをエージェントに提供する
XBOX GDK サンプルの一覧 を使用して、実装する機能のサンプルを見つけます。リポジトリとサンプルの README で、GDK のバージョン、ディレクトリ レイアウト、プラットフォームの要件を確認します。main ブランチがプロジェクトと一致しない場合は、互換性のある サンプル リリース を選択します。 互換性のあるリリースをクローンまたはダウンロードし、該当するサンプルのソースと README のローカル パスをエージェントに提供します。サンプルの初期化、エラー処理、非同期処理の有効期間、クリーンアップのパターンに従うよう、エージェントに指示します。別の GDK レイアウトからプロジェクト設定をコピーするのではなく、インストール済みのヘッダーに照らして API を検証するよう、エージェントに指示してください。エージェントにコマンドラインからビルドさせる
ビルドを行うには、エージェントに Gaming Command Prompt と同じ環境が必要です。スタート メニューのショートカットで使用されている引数を指定してGamingDesktopVars.cmd を実行し、同じ cmd プロセスでビルドを実行します。
GamingDesktopVS2022 を使用します。環境は別々のコマンド間で引き継がれないため、エージェントはスクリプトとビルドを一緒に実行する必要があります。
プロジェクト指示ファイルを追加する
ほとんどのコーディング エージェントは、リポジトリのルートにあるAGENTS.md や .github/copilot-instructions.md などのプロジェクト指示ファイルを読み取ります。このファイルを使用して、すべてのエージェント セッションに同じ GDK のコンテキストを提供します。次の例をもとに、山かっこで囲まれた値を置き換えてください。
AGENTS.md
