# パッケージ — AI Game DevアプリとCLI · AI Game Developer Wiki

AI Game Devアプリに含まれるパッケージの種類、Packagesウィンドウやgamedev pkgでのインストール・更新・除外・削除の方法、レベルについて説明します。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/app/packages)。

パッケージは、Blender、SuperColliderによる音楽、プロジェクトのナレッジベース、Tripoの3D生成、ローカルの画像・動画モデル、クラウドの動画・音声モデル、そしてチームが自ら作るものなど、アプリ全体の機能を拡張します。このページでは、パッケージとは何か、どのパッケージがアプリに付属するのか、そしてデスクトップのPackagesウィンドウと `gamedev pkg` コマンドでそれらを管理する方法を説明します。

## パッケージとは

パッケージは、マニフェスト `aigd-package.json` と、任意でいくらかのJavaScriptを含むフォルダーです。仕組みはVS Code拡張機能と同じです。パッケージが表示するものはすべてマニフェストで宣言され、コードが実行される前に見え、コードは何かがそれを必要としたときにだけ起動します。

パッケージは次のものを提供できます:

- Tools行の**セッションツール**。多くの場合MCPサーバーに支えられ、エージェントが新しいツールを利用できるようになります。
- `/blender` や `/kb` などの**スラッシュコマンド**。デスクトップのチャットとCLIの両方で動作します。
- コマンドパレット用の**コマンド**、**メニュー**とコンポーザーツールバーのボタン、**ステータスバー**の項目。
- **パネル**、サイドパネルの**ビュー**、独自のウィンドウ、ファイルタイプ用の**カスタムエディター**やプレビュー。
- **設定**、短いアプリ内**チュートリアル**、他のパッケージやClaudeプラグインへの**依存関係**。
- 純粋なデータ: ローカルの画像・動画モデルはコードを持たないパッケージで、ファイル、ダウンロードサイズ、ライセンス、対応するハードウェアを宣言します。

すべてのパッケージには `publisher.name` 形式のidがあります。ファーストパーティのパッケージはパブリッシャー `aigd` を使い、たとえば `aigd.blender` のようになります。

## パッケージ、Claudeプラグイン、MCPサーバー、エンジン拡張機能

アプリには4種類の拡張機能があります。どれも最終的にはエージェントが使えるツールになりますが、管理する場所が異なります:

| 種類 | 拡張する対象 | 管理する場所 |
| --- | --- | --- |
| パッケージ | アプリ本体: ツール、コマンド、パネル、エディター、モデル | Packagesウィンドウ、`/packages`、`gamedev pkg` |
| Claudeプラグイン | Claudeエージェント: スキル、コマンド、エージェント、プラグインのMCPサーバー | **Settings**、**Claude Plugins**、または `/plugin` |
| MCPサーバー | 現在のプロジェクト向けの、ローカルまたはリモートの任意のMCPサーバーからのツール | **Settings**、**MCP servers**、または `/mcp` |
| エンジン拡張機能 | Unity、Unreal、Godotプラグイン内の追加ツール | サイドバーの拡張機能アクション、または `/install-extension`（[extensions](https://ai-game.dev/docs/extensions) を参照） |

Settingsで追加したMCPサーバーは、追加したときに開いていたプロジェクトに属し、他のプロジェクトには表示されません。新しいプラグインやMCPサーバーは、すでに開いているチャットには次のメッセージから適用されます。

## アプリに付属するパッケージ

初回起動時に、アプリはデフォルトのパッケージをユーザーレベルで自動的にインストールするので、すべてのプロジェクトで利用できます:

| パッケージ | 追加される内容 |
| --- | --- |
| `aigd.blender` | Blender: エージェントが実際のBlenderで3Dモデルを構築・編集します |
| `aigd.supercollider` | 音楽: SuperColliderでゲーム音楽を作曲、レンダリング、エクスポートします |
| `aigd.knowledge` | ナレッジベース: プロジェクト内のMarkdownノートで、エージェントが読み取りと更新を行います |
| `aigd.tripo` | Tripo: 3D、テクスチャ、メッシュ、リグ、アニメーションのツール |
| `aigd.sdcpp` | stable-diffusion.cppによるローカルの画像・動画生成 |

削除したデフォルトが再び追加されることはありません。パッケージをインストールしても、すべてのチャットで有効になるわけではありません。ツールはセッションごとにTools行でオンに切り替えます。ローカルの画像・動画モデルやクラウドモデルファミリーは個別のパッケージです。すべての一覧は[パッケージカタログ](https://ai-game.dev/ja/docs/wiki/app/packages-catalog)を参照してください。

## Packagesウィンドウ

ウィンドウ右下のステータスバーにあるパッケージアイコン（「Open Packages」）から開けます。上部にプロジェクトとそのレベルが表示され、以下のタブがあります:

- **Installed**: このプロジェクトで有効なパッケージと、そのステータス、バージョン、レベル。
- **Browse**: AI Game Devのパッケージレジストリを検索します。
- **Claude plugins**: パッケージがこのプロジェクトのために必要とするClaudeプラグイン。
- **Models**: ダウンロード可能なローカルの画像・動画モデル。プロジェクトに生成ランタイムがある場合に表示されます。

ヘッダーには**Check for updates**と**Reload**があり、後者はプロジェクトのパッケージを再起動します。パッケージを選択すると、その詳細、レベル、設定、エラーが表示されます。

## パッケージをインストールする

### デスクトップアプリの場合

1. Packagesウィンドウを開き、**Browse**を選択します。
2. たとえば `hello` で検索し、パッケージを選択します。
3. 追加ボタンの下でレベルを選択します: **User**、**Project**、**Local**（[レベル](https://ai-game.dev/ja/docs/wiki/app/packages#levels)を参照）。
4. **Add to Project**（または**Add to User**、**Add to Local**）をクリックします。

レジストリ外のパッケージを追加するには、追加ボックスに入力します。レジストリ ID（`aigd.blender`、任意で `aigd.blender@^1.2` のようなバージョン範囲も可）、GitHub リンクまたは `owner/repo`、npm パッケージ（`npm:<name>` またはその npmjs.com リンク）、あるいはフォルダパスを受け付けます。

### CLI で

プロジェクトフォルダで `gamedev pkg` を実行するか（`--cwd <path>` を渡す）、インタラクティブ CLI で `/packages` を使います。既定のレベルは `--project` です。

```bash
gamedev pkg list                          # the packages in effect for this project
gamedev pkg list --user                   # the user level alone
gamedev pkg add aigd.blender --user       # from the registry, for every project
gamedev pkg add github:owner/repo         # from GitHub, for this project
gamedev pkg add npm:some-package --local  # from npm, this machine only
```

範囲を指定せずに追加されたレジストリパッケージは `^<installed version>` として書き込まれるため、互換性のある更新を受け取ります。

## レベル: user、project、local

パッケージとその設定は 3 つのレベルで宣言されます。上位のレベルが下位のレベルを上書きします。local は project に勝ち、project は user に勝ちます。

| レベル | 適用範囲 | 宣言場所 | Git にコミット |
| --- | --- | --- | --- |
| User | このコンピューター上のすべてのプロジェクト | `~/.ai-game-dev/packages.json` | いいえ |
| Project | プロジェクトを開くすべてのユーザー | `<project>/.ai-game-dev/packages.json` | はい |
| Local | このコンピューター上のこのプロジェクトのみ | `<project>/.ai-game-dev/packages.local.json` | いいえ（アプリが `.ai-game-dev/.gitignore` に追加します） |

各レベルにはその隣にロックファイル（`packages-lock.json`、`packages-lock.local.json`）もあり、正確なバージョンを固定するため、プロジェクトを共有するチームメイトは同じバイト列をインストールします。

チーム全体が必要とするパッケージには **Project**、個人的なツールには **User**、自分のコンピューターにインストールされたツールへのパスのようなマシン固有の選択には **Local** を使います。

## 1 つのプロジェクトでパッケージを除外する

あるプロジェクトで user レベルのパッケージをオフにするには、それを選択してレベル行の **Exclude** を選ぶか、次のようにします:

```bash
gamedev pkg exclude aigd.blender            # off in this project (written to the project file)
gamedev pkg include aigd.blender            # undo
```

この場合プロジェクトファイルには `"aigd.blender": false` が保持され、他のプロジェクトには影響しません。

## パッケージを更新する

自動更新は既定でオンです。アプリは起動直後、4 時間ごと、および **Check for updates** をクリックしたときにチェックします。各レベルが宣言する範囲の中で、アプリと互換性のある最新バージョンをインストールし、実行ごとに 1 件の通知を表示します。たとえば「Updating 1 package… (1/1)」の後に「Updated 1 package」と表示されます。

- パッケージごとに、Packages ウィンドウの **Auto-update** スイッチ、または `gamedev pkg auto-update off <id>` で自動更新をオフにできます。この選択はコンピューターごとです。
- `gamedev pkg update`（すべて）または `gamedev pkg update <id>` で今すぐ更新します。
- ローカルフォルダからのパッケージ、およびタグに固定された GitHub ソースは自動更新されません。

新しいアプリを必要とするパッケージはその旨を表示します（「requires AI Game Dev >=X, you have Y」）。先にアプリを更新してください。

## パッケージを削除する

それを選択して **Remove** を選ぶか、次のようにします:

```bash
gamedev pkg remove <id>              # remove it from the project level
gamedev pkg remove <id> --user       # remove it from the user level
```

他のパッケージの依存関係としてのみインストールされたパッケージには Remove はなく、Exclude のみです。何も必要としなくなると自動的に消えます。

## パッケージ設定

パッケージを選択して **Settings** を開きます。各設定の横で、その設定を書き込むレベルを選びます。チップには現在の値がどこから来ているかが表示されます。設定には **Browse…** と空き容量チェックを備えたフォルダピッカーや、アプリから提供される選択肢もあります。

CLI では:

```bash
gamedev pkg settings aigd.blender                 # every key, its value and level
gamedev pkg settings <id> <key> <value> --local   # write a value at a level
gamedev pkg settings <id> <key> --unset --project # clear the value at a level
```

値は保存前に宣言された型と照合されます。拒否された値は何も変更せず、終了コード 1 で終了します。

## 依存関係

パッケージは他のパッケージや Claude プラグインに依存できます。アプリがそれらをインストールし、プロジェクトごとに各パッケージのバージョンを 1 つだけ保持します。Packages ウィンドウでは依存関係が「installed for `<id>`」としてそのレベルとともに表示されます。パッケージが必要とする Claude プラグインはプロジェクトごとにアプリ管理のキャッシュへインストールされ、そのプロジェクトのセッションでのみ読み込まれ、あなた自身の Claude Code には決して読み込まれません。

## 安全性とエラー

パッケージは VS Code 拡張機能と同様にユーザーの権限で実行されます。サンドボックスはありません。信頼できるソースからのみパッケージをインストールしてください。AI Game Dev レジストリのパッケージは、展開前に公開されたチェックサムと照合して検証されます。

パッケージが失敗すると、そのカードに警告数が表示され、**Errors** タブに詳細が一覧表示されます。サードパーティパッケージのエラーはどこにも送信されません。当社のレジストリにあるファーストパーティの `aigd` パッケージのエラーは、クラッシュレポートへの同意がある場合にのみ当社へ報告されます。インストール済みのパッケージはネットワーク接続なしで起動します。

## 次のステップ

- [パッケージカタログ](https://ai-game.dev/ja/docs/wiki/app/packages-catalog)で利用可能なすべてのパッケージを確認できます。
- [パッケージの作成](https://ai-game.dev/ja/docs/wiki/app/creating-packages)で独自のパッケージを作成できます。
- ブログ記事 [packages, Claude plugins and MCP servers](https://ai-game.dev/ja/blog/ai-game-dev-packages-plugins-mcp)では、Packages ウィンドウとプロジェクトの MCP サーバーが実際に動作する様子を紹介しています。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/app/packages

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/app/packages