シェアカード、ファビコン、アプリアイコン
デプロイされたアプリ(https://{name}.grok.me)は1200×630のカードでアンファールされ、すべてのアプリ(プレビューを含む)はタブにファビコンを表示します。シェアカードの <meta> タグは __root.tsx で記述しません — インジェクター(scripts/grok-pwa-shared.mjs)が各HTMLレスポンスに対して og:* と twitter:card を上書きします。アイデンティティデータのみを記述し、パスがすべてを書き込みます。ディスパッチ時には、何もシードしません:
src/lib/og/site.json— 事前にシードされず、必要な場合のみ作成:{ "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" };タイトルはデフォルトでホストスラッグになります。public/og.jpg— カスタム1200×630カード(オプション、それ以外はプレースホルダー)public/x-banner.jpg— ゲームのみ:50:11(1200×264)のXフィードカードpublic/favicon.svg— ルートのhead()からリンク;パスがランディングするまで、タブにはブラウザのデフォルトが表示されますが、問題はありません
__root.tsx を拡張し、丸ごと置き換えないでください(認証SSR、リデザイン、スキル抜粋):ファビコンリンクを削除すると、ローカルチェックでは検出できない空白のタブアイコンが配信されます。
決定:このアプリにどのカードを割り当てるか
デフォルト:アプリ独自のアートによるカスタムカード — あらゆる種類のゲームとレンダリング技術(Canvas/WebGL および DOMボード、カード、ワード、パズル、クイズ:divの三目並べグリッドもゲームです)、遊び心のあるアプリ、クリエイティブツール、コンテンツ指向およびブランド指向のページ。迷ったら、カスタムカードを作成してください。
プレーンなユーティリティアプリのみ(コンバーター、CRUDトラッカー、ダッシュボード、メモ/管理 — データが顔となるアプリ)は、デフォルトの og.grok.me プレースホルダーを維持します:public/og.jpg はありません。そのURL、"color" ノブ、およびリネームルールについては、references/placeholder-card.md を参照してください。
ゲームの og:type
あらゆる種類のゲームは、src/lib/og/site.json に "type": "x:game" を持ちます — パスがそのファイルを所有して書き込みます。ホスト名は含めず、カスタムカードに依存せず、website、裸の game、twitter:card、または考案された x:type に「修正」しないでください:Xのパイプラインはその正確な値をキーにしています。非ゲームではこれを省略します。あなたのチェック対象であり、編集対象ではありません — それが欠けている場合、またはカスタムカードが存在する場合に public/x-banner.jpg が欠けている場合は、ブランド警告となります。
ブランドアセットパス:常にサブエージェント、決して待たない
task ツールをお持ちですか?このパスをサブエージェントとしてディスパッチし、自分でカードアートを生成しないでください — インラインで行うと、数分の生成レイテンシがユーザーの前に発生します。名前とパレットが確定したらすぐに(AGENTS.md §「並行作業」)、このプロンプトをそのままディスパッチしてください。これは完全です — 以下の参照を開いてエンリッチしないでください;パス自身が読み取ります:
あなたはブランドアセットパスです。
ogスキルに従ってください。アプリ<NAME>、og:type<TYPE>、パレット<PALETTE>。あなたはpublic/ブランドアセットとsrc/lib/og/site.jsonを唯一所有します。
構築を続けてください。ユーザーがアートディレクションを行っている場合、または再利用するアートがまだ存在しない場合にのみ、逐次処理を続けてください。
決して待たないでください。 wait_tasks は使用せず、ブランドタスクに対して get_task_output も使用しないでください:タスクの出力を読み取ると消費され、消費されたタスクは完了通知を送信しないため、カードの結果(失敗を含む)は誰にも届きません。アプリがレンダリングされたらすぐに回答してください;後でパスがあなたを起こし、そのターンは多くとも1つの短い文 — 再公開を依頼する文です。public/og.jpg はビルドに含まれ、公開後にランディングしたカードはそれだけではライブアプリに到達しないためです:
「シェアカードを追加しました — すでに公開した場合はもう一度公開してください。」/「カードは失敗しました。デフォルトのカードが使用されています。」
パスが /workspace/.grok/og-pending を最新に保っている間、ブランドチェックはカードについて何も言いません:進行中は発見事項ではありません。マーカーは10分後に古くなるため、非常に長いパスでは警告が通ることがあります — しかし実行中にブランド警告が出ても、その作業をやり直す合図にはなりません。
task ツールがありませんか?その場合、あなたがパスです — 今すぐアセットをビルドしてください;他には何もありません。誰が実行しても、そのマーカーを主張し、ファイルを /workspace/.grok/ にステージングします — 決して public/ の中には入れません(vite build はこれをそのままデプロイされたアプリにコピーします)— scripts/write-atomic.mjs でハンドオーバーして、ビルドが半分のJPEGを読み取らないようにし、node scripts/brand-check.mjs --game で自己チェックします。
アセットをビルドする — パスはこれらを読み取り、親は読み取りません
ディスパッチ中ですか?開かないでください — 上記のプロンプトで完全です。1回の読み取りでこの手順がコンテキストに含まれ、後のすべてのターンでサブエージェントが作業を行います。
あなたがパスですか? references/brand-pass.md から始め、次に各資産ごとに読み取ります:public/og.jpg については references/custom-card.md、ゲームのみの public/x-banner.jpg については references/x-banner.md、public/favicon.svg とPWAラスターアイコンについては references/favicon-and-icons.md — これらはユーザーがインストール可能/PWAを要求した場合のみで、決してマニフェストを発明しないでください。そのSVGは手書きし、決して imagine_text_to_image を使用しないでください:16pxで鮮明である必要があります。ゲーム用に site.json を書く場合?references/og-type-contract.md が、Xが拒否するスペルについて説明しています。
リネーム時または重要なアイデンティティ変更時に再生成 — APP_NAME、site.json の title、および埋め込まれたカードタイトルが一緒に移動します。imagine_text_to_image またはxAI Images APIがない場合は、og.grok.me カードを維持してください;壊れた og:image URL を決して出荷しないでください。
サポート対象外
/api/og ルート、ランタイム画像レンダラー、ルートごとのカードはありません — カードは1つの静的サイト全体画像(public/og.jpg またはプレースホルダーサービス)です。robots.txt を追加する場合、Disallow: / を絶対に行わないでください:クローラーはタグを読み取るために / をフェッチする必要があります。