このページは英語から機械翻訳されています。英語の原文を読む。

レジストリのルールとチェック

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

2026年11月19日に更新 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

自動チェック

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

チェック拒否するもの
archivegzip以外のもの、上限を超えるアーカイブ、シンボリックリンク、ハードリンク、デバイス、絶対パス、..、制御文字、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/tokenCICI の 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 に直接たどり着けます。