# レジストリのルールとチェック — AI Game DevアプリとCLI · AI Game Developer Wiki

コミュニティパッケージレジストリの命名規則、上限、自動チェック、署名付きインデックス、パブリッシャーパネル、そのAPI、エージェント向けMarkdownを解説します。

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

AI Game Devコミュニティレジストリにアップロードされたすべてのバージョンは、誰かがインストールできるようになる前に自動でチェックされます。手動レビューの待ち行列はありません。このページでは、パッケージが従わなければならないルール、各チェックが何をどのような理由で拒否するのか、公開されたバージョンが署名付きインデックスを通じてユーザーに届く仕組み、パブリッシャーパネル、レジストリのAPI、そしてAIエージェントが読むMarkdownページについて説明します。

## 名前

- **パブリッシャーid** は2〜40文字の小文字英字、数字、単一のハイフンで構成され、先着順です。予約済み: `aigd`、エンジン名 `unity`、`godot`、`unreal`、`brutal`、`bevy`、`threejs`、商標、役割語（`anthropic`、`claude`、`openai`、`official`、`admin`、`samples` など）、数字を英字に読み替えた紛らわしい名前（`un1ty`）、および予約名を単語や接頭辞として使うid（`unity-tools`、`my-godot`）。予約名はAI Game Devによって正当な保有者に割り当てられることがあります。
- **パッケージid** は `<publisher>.<name>` 形式で、マニフェストと一致している必要があります。`aigd.image` のようなアプリ予約のidは拒否されます。
- **優先順位:** アプリは `aigd.*` のidや、AI Game Dev自身のインデックスに掲載されているidに対するコミュニティのエントリを無視するため、公式パッケージを偽装することはできません。

## 上限

| 上限 | 値 |
| --- | --- |
| アーカイブ（gzip） | 圧縮50 MiB、展開後200 MiB |
| ファイル数 | アーカイブあたり5,000、ファイルあたり64 MiB |
| アカウントあたりのパブリッシャー数 | 3 |
| アップロード | 1時間あたり20回（アカウント単位、トークンによるアップロードはパブリッシャー単位） |
| チェック待ちのバージョン数 | パブリッシャーあたり5 |
| 有効なパブリッシャートークン | パブリッシャーあたり10、それぞれ最大365日間有効 |
| 信頼されたパブリッシャー | パッケージあたり10 |
| リリースノート | バージョンあたりMarkdown 20 KB |
| チャンネル | パッケージあたり5 |

## 自動チェック

アーカイブは信頼できないデータとして扱われます。サイズ上限付きでメモリ上に展開され、バイト列として読み取られるだけで、実行されることはありません。チェックは次の順序で実行され、レポートには各チェックとその結果が記載されます:

| チェック | 拒否するもの |
| --- | --- |
| `archive` | gzip以外のもの、上限を超えるアーカイブ、シンボリックリンク、ハードリンク、デバイス、絶対パス、`..`、制御文字、Windowsで無効な名前、大文字小文字を区別しない重複、`.git/` |
| `manifest` | アプリが読み込めないマニフェスト（アプリ自身のバリデータでチェック: スキーマ、所有するid、ゲームエンジンのルール） |
| `registry-rules` | あなたが保有していないパブリッシャー、予約済みのid、`enabledApiProposals` のエントリ、アーカイブ内に存在しない `main`、実際のPNG・JPEG・GIF・WebP・ICOでないアイコン、またはスクリプト・スタイル・外部参照・イベントハンドラを含むSVG |
| `secrets` | 秘密鍵や認証情報（クラウド、GitHub、GitLab、Slack、Stripe、Google、Anthropic、OpenAI、npm、PyPI、Hugging Face、ai-game.devのキー）、JWT、`.env`、`.npmrc`、`id_rsa` などのファイル。レポートにはファイル名と行番号のみが示され、値は決して示されません |
| `prompt-injection` | エージェントに指示しようとするテキスト（後述） |
| `native-code` | なし: ネイティブバイナリは許可され、フラグが付き、ユーザーにはパッケージに「native code」と表示されます |
| `virus-scan` | ウイルススキャナーが検出したものすべて（スキャンできなほど深くネストされたアーカイブを含む） |

失敗したバージョンは、すべての理由を添えて `rejected` になります。修正して同じバージョンを再度アップロードしてください。スキャナーが一時的に利用できない場合、バージョンは待機して再試行されます。スキャンされないまま通過することは決してありません。

### プロンプトインジェクション

パッケージのテキストはエージェントに届きます: ツールの説明、スキル、README、リリースノートなどです。レジストリは、すべてのマニフェスト文字列、`README*`、Markdownファイルとテキストファイル、`SKILL.md`、`CLAUDE.md`、`AGENTS.md`、`skills/`・`agents/`・`commands/`・`prompts/` 配下のファイルをすべてのルールで読み取り、コードファイルは高信頼度のルールで読み取ります。テキストはまず正規化されるため（HTMLエンティティ、Unicodeの似た文字、不可視文字、Markdownの強調）、偽装は通用しません。次のものを拒否します:

- 以前の指示を無視・上書きするよう求める指示、またはシステムプロンプトを明かすよう求める指示。
- チャットの役割マーカー（`<|im_start|>`、`[INST]`、`<system>` など）。
- 隠し文字: ゼロ幅文字や双方向制御文字、Unicodeタグ文字。
- 読み取れるテキストにデコードされる長いbase64文字列。
- AIに呼びかけるHTMLコメントや隠し要素。
- キー、トークン、認証情報、または会話の内容をどこかへ送信するよう求めるもの。
- ジェイルブレイクのフレーズ、ユーザーに行動を隠すよう求めるもの、ツールの自動承認や権限チェックの回避を求めるもの。

一般的なゲーム用語（「god mode」）、絵文字、バッジ、APIドキュメントは通過します。無害なテキストがチェックに引っかかった場合は、言い換えるか、誤検知をAI Game Devに報告してください。

## 署名付きインデックス

公開されたバージョンは専用のストレージ（`community-packages.ai-game.dev`）に書き込まれ、レジストリが Ed25519 で署名するコミュニティインデックスに掲載されます。各アプリは、アプリに組み込まれた鍵で署名を検証し、有効期限切れのインデックスや、すでに受け入れたものより古いインデックスを拒否し、各アーカイブについて展開前に `sha512` の整合性を、展開後にツリーハッシュを検証します。インデックスには、各バージョンのアーカイブに加えて、パッケージごとに発行元、評価、README、アイコン、チャネル、非推奨情報が、バージョンごとにリリースノート（先頭 4 KB）、非推奨情報、provenance、ネイティブコードフラグが含まれます。

AI Game Dev が取り消したバージョンはインデックスの `revoked` リストに掲載されます。各アプリは次回の読み込み時（実行中のアプリは約 30 分ごとにインデックスを読み込みます）にそのバージョンを無効化し、二度とインストールしません。

## パブリッシャーパネル

[ai-game.dev/publisher](https://ai-game.dev/publisher) のパブリッシャーパネルでは、サインインしたオーナーとメンテナーが自分たちの公開内容を管理できます。

- 自分のパブリッシャー、それぞれでの自分のロール、およびそのメンバー。
- 各パッケージのバージョンとその状態、および完全なチェックレポート。
- リリースノート、チャネル、非推奨化、yank。
- パブリッシャートークン（作成、一覧、取り消し）。
- GitHub と GitLab 向けの信頼済みパブリッシャー（コピーできるワークフロースニペット付き）。
- チェック中のアップロードの状態。

## レジストリ API のルート

CLI とパネルが行うすべての操作は `https://ai-game.dev/api/registry/v1` を経由します。エラーは単一のエンベロープ `{"error": {"code", "message", "fields"}}` を使用します。

| ルート | 権限 | 内容 |
| --- | --- | --- |
| `POST /publishers`、`GET /publishers`、`GET /publishers/{slug}` | サインイン済み、メンバー | パブリッシャーを申請する。自分のパブリッシャーを一覧する。1 つのパブリッシャーをそのパッケージとバージョンとともに取得する |
| `GET /me/publishers` | サインイン済み | 自分のパブリッシャーとそのロール |
| `GET /publishers/{slug}/members` | メンバー | メンバー一覧 (メールアドレスはオーナーのみ) |
| `POST /publishers/{slug}/members`、`DELETE …/members/{userId}` | オーナー | メンテナーの追加または削除 |
| `POST /publishers/{slug}/tokens`、`GET …/tokens`、`DELETE …/tokens/{id}` | メンバー | パブリッシャートークン |
| `POST /uploads`（multipart `tarball`、任意で `notes`） | メンバーまたはトークン | バージョンをアップロードする |
| `GET /packages/{id}/versions/{version}` | メンバーまたはトークン | 状態、チェックレポート、リリースノート |
| `PATCH /packages/{id}/versions/{version}` | メンバー | リリースノートを編集する |
| `POST /packages/{id}/versions/{version}/yank` | メンバーまたはトークン | yank または復元 |
| `POST`、`DELETE /packages/{id}/deprecate` および `…/versions/{version}/deprecate` | メンバー | 非推奨化または非推奨の解除 |
| `GET /packages/{id}/dist-tags` | 公開 | チャネル |
| `PUT`、`DELETE /packages/{id}/dist-tags/{tag}` | メンバー | チャネルの設定または削除 |
| `GET`、`POST /packages/{id}/trusted-publishers`、`DELETE …/{tpId}` | 読み取りはメンバー、変更はオーナー | 信頼済みパブリッシャー |
| `POST /oidc/token` | CI | CI の ID トークンをアップロード用の資格情報と交換する |
| `GET /packages/{id}/ratings`、`PUT` および `DELETE …/rating` | 公開、サインイン済み | 評価（パッケージの発行元のメンバーは評価できません） |

## エージェント向けの Markdown ページ

AI エージェントはサイトを Markdown として読むため、パッケージに関するすべてに Markdown 版が用意されています。

- **カタログ。** `ai-game.dev/packages`（段階的に公開中）のパッケージカタログには、公式およびコミュニティのすべてのパッケージが掲載され、各パッケージには `/packages/<id>` という専用ページがあります。どちらのパスにも `.md` を付けるか、`Accept: text/markdown` でリクエストすると、同じ内容を Markdown で取得できます。名前、id、バージョン、発行元、説明、インストールコマンドが含まれます。
- **このドキュメント。** この wiki のすべてのページには `/docs-md/` 配下に Markdown ミラーがあり（このページは `/docs-md/wiki-app-package-registry.md`）、ページ上部の **View as Markdown** からリンクされています。ミラーでもすべてのスクリーンショットが画像リンクとして保持されます。
- **LLM 向けのサイトインデックス。** `https://ai-game.dev/llms.txt` にこれらのページが掲載されているため、パッケージを書くよう指示されたエージェントは、マニフェストリファレンスとパッケージ API に直接たどり着けます。

**ヒント**

エージェントにパッケージを書かせるには、[パッケージ API](https://ai-game.dev/ja/docs/wiki/app/package-api) と[マニフェストリファレンス](https://ai-game.dev/ja/docs/wiki/app/package-manifest)の Markdown ミラーを指定し、変更のたびに `gamedev pkg validate` を実行させてください。

## 関連ページ

- 公開のワークフローについては[パッケージの公開](https://ai-game.dev/ja/docs/wiki/app/publishing-packages)を参照してください。
- CI と provenance については[信頼済みパブリッシング](https://ai-game.dev/ja/docs/wiki/app/trusted-publishing)を参照してください。
- インストール後にパッケージが実行できることについては[ライフサイクル、ホスト、権限](https://ai-game.dev/ja/docs/wiki/app/package-lifecycle#permissions)を参照してください。

---

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

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