レジストリのルールとチェック
コミュニティパッケージレジストリの命名規則、上限、自動チェック、署名付きインデックス、パブリッシャーパネル、そのAPI、エージェント向けMarkdownを解説します。
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 のパブリッシャーパネルでは、サインインしたオーナーとメンテナーが自分たちの公開内容を管理できます。
- 自分のパブリッシャー、それぞれでの自分のロール、およびそのメンバー。
- 各パッケージのバージョンとその状態、および完全なチェックレポート。
- リリースノート、チャネル、非推奨化、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 に直接たどり着けます。
関連ページ
- 公開のワークフローについてはパッケージの公開を参照してください。
- CI と provenance については信頼済みパブリッシングを参照してください。
- インストール後にパッケージが実行できることについてはライフサイクル、ホスト、権限を参照してください。