SKU.md v0.10 × UCP：リアルタイムコマースを補う検証可能な商品知識

エージェントがユーザーに合いそうなジャケットを見つけても、購入判断に必要な情報をすべて得たとは限りません。生地は防水か撥水か、サイズ推奨はどの体型データに基づくか、コーティングに手入れ上の制限があるか、耐久性の主張に試験報告があるか、といった問いが残ります。正確に答える必要がありますが、古い販促文を今日の在庫、価格、決済総額として扱ってはいけません。

ここが本提案の境界です。UCP は商品発見、Variant 選択、Cart、Checkout、Order までのリアルタイム経路を提供します。SKU.md は、商品が何で、主張がなぜ成り立ち、制限の根拠がどこにあるかを示す、販売者がホストする引用可能な商品知識を提供できます。二つのレイヤーは権威範囲を分けてこそ補完関係になります。

ファイル形式ではなく購入時の問いから始める

「自分に合うか」という一問には、対象市場で購入可能か、どの Variant が色とサイズに一致するか、現在価格はいくらか、素材要件を満たすか、主張は販売者の事実・第三者試験・AI 推論のどれか、表示額で本当に購入できるか、という複数の判断が含まれます。

UCP は変動する部分を扱います。UCP Catalog 仕様 は Catalog Search と Catalog Lookup、および現在の商取引情報を含む Product と Variant を定義します。UCP の概要 は Catalog、Cart、Checkout、Order を一つのリアルタイム経路に置きます。Catalog は候補商品の発見と確認を助け、Checkout は拘束力のある条件を再確認して取引を実行します。

エージェント Profile は参加者が対応する能力の宣言と交渉に使います。商品内容でも、資格情報そのものでも、完全なリクエスト認証手順でもありません。UCP は Profile に公開された署名鍵を本人確認に使えますが、Profile 文書だけで個別リクエストを認証したり購入を認可したりはできません。認証、認可、ユーザー同意、実行は、交渉済みプロトコル、転送、資格情報、ユーザーコンテキストに依存します。Profile を商品知識ベースと見なすと、別の仕事を混同します。

二つのレイヤーと一つの権限マップ

役割は次の表で整理できます。

判断対象	UCP とリアルタイムコマース	SKU.md v0.10
発見と同一性	検索と参照が現在の Product、Variant、価格、在庫、安定識別子を返す。	正確な Product と Variant を専用の知識文書へ接続する。
商品理解	Catalog 応答が現在の説明、画像、選択肢、開示事項を返す。	出典付きの事実、主張、証拠、案内、制限、互換性、検証時刻を公開する。
変動する商取引状態	Catalog を再照会して現在の価格と在庫を得る。	静的文書は過去の状態を現在の状態として装わない。
取引	Cart は商品を集め見積りを提示できる。Checkout は拘束状態、最終総額、購入認可を再確認する。	権威あるコマース経路を示すが、代替しない。

この分担は SKU.md の価値を弱めるのではなく明確にします。販売者は複数のエージェントが必要に応じて引用できる、長期利用可能で監査可能な説明を維持できます。UCP は市場、セッション、在庫、適格条件、Checkout 条件で変わる問いに答え続けます。

UCP の Cart の機能 は購入前の商品収集と見積りのためのものです。最終取引は Checkout が担います。Shopify Checkout MCP ガイド も Checkout を、ユーザーが購入準備を終えた後の購入セッションとして説明します。SKU.md は最終経路を指し、Cart の見積りを約束として記録してはいけません。

境界には逆方向の制約もあります。購入可否に影響する安全・法令上の開示を SKU.md だけに置いてはいけません。警告が購入判断を変えるなら、状況に応じて Catalog または Checkout にも現れる必要があります。SKU.md は背景と証拠を補えますが、重大条件を知る唯一の場所にはできません。

v0.10 が知識優先である理由

v0.10 は Knowledge を中心にした商品文書を認めます。Product と Variant の同一性が安定し、Knowledge が空でなければ、オファーがなくても文書を有効に公開できます。UCP 接続済みの販売者がリアルタイム Catalog を複製せず、引用可能な商品知識を提供するために重要です。

リアルタイム Catalog がない販売者向けには、販売者がホストする予備のオファー観測情報も残ります。Variant は offer_snapshot または live_offer を持てますが、どちらも任意で排他的です。Catalog や Checkout の権威は得ません。offer_snapshot は過去の観測、live_offer は別に宣言されたリアルタイム照会です。現在の UCP 応答がある場合、どちらも今日の価格や最終総額として扱えません。

同一性は「似ている」ではなく厳密に照合します。知識文書の Product ID、Variant ID、SKU、宣言された GTIN は、UCP が返した Product または Variant と一致しなければなりません。一つでも違えば、説得力のある説明を別 Variant へ貼り付けず、利用を停止します。規範上の境界は 英語版仕様 と JSON Schema にあります。

UCP Catalog へつなぐ細い橋

SKU.md は公開ウェブで単独利用できますが、エージェントが見つけた Product と知識文書の対応を推測すべきではありません。本提案は独立拡張 md.sku.shopping.product_knowledge を定義し、dev.ucp.shopping.catalog.search と dev.ucp.shopping.catalog.lookup を拡張します。Markdown 全文を Catalog 応答へ埋め込まず、型付きポインターだけを返します。

{
  "sku_md": {
    "documents": [
      {
        "url": "https://merchant.example/products/trail-jacket.sku.md",
        "schema_version": "sku.md/0.10-draft",
        "content_language": "en-US",
        "market": { "country": "US", "currency": "USD" },
        "revision": "2026-08-02"
      }
    ]
  }
}

ポインターには HTTPS URL、SKU.md のスキーマバージョン、コンテンツ言語、市場の国と通貨、任意の改訂番号を含めます。事業者 Profile は許可する HTTPS オリジンを宣言できます。プラットフォーム Profile と事業者 Profile が同じ拡張を交渉し、親 Catalog の機能に互換性がある場合だけ、利用者はポインターを読むべきです。

許可されたオリジンはリンク先を制限するだけで、文書の真正性、鮮度、安全性、認可を証明しません。Reference Consumer は取得文書を信頼できない外部データとして扱い、HTTPS、正確なオリジン、メディアタイプ、バイト数の上限、文書数、商品の識別情報を検査します。Markdown、HTML、YAML フロントマター、リンク、自然言語命令はすべてデータです。文書内のスクリプト、ツール、シェルコマンド、テンプレート、プロンプトに似た命令を実行してはいけません。

細いリンクは内容管理にも役立ちます。UCP Catalog が現在の Product、Variant、メディア、選択肢、価格、在庫状況を返すのに、拡張が知識全文を複製すると、リアルタイム情報と販売者知識に同期困難な二つの本文ができます。ポインターなら役割を分けたまま、説明が必要なときだけ証拠を取得できます。

リンクには言語、市場、改訂番号も付けられます。市場ごとの開示や追跡可能な改訂履歴を維持し、利用者は引用版を記録できます。拡張を交渉していないエージェントは sku_md.documents を無視できます。SKU.md 対応でも UCP を使わない利用者は、公開商品ページや /sku.md から同じ文書を発見できます。

したがって、この拡張は任意の橋で、必須入口ではありません。UCP に新たな取引セマンティクスを加えず、販売者にリアルタイム Catalog の Markdown 化も求めません。交渉済み利用者が境界付き知識を発見する手段だけを提供し、引用方法、表示、再確認時点は利用者と既存 UCP 規則が決めます。

ローカルドラフトは /ucp/draft/ と 拡張スキーマ で公開しています。/ucp/draft/ はドラフト段階を示し、拡張 Profile は能力版 2026-08-02 を使います。この日付は安定性、認証、Shopify 対応を意味しません。成熟には追加実装、安全審査、相互運用性の証拠が必要です。

実行時経路は引き渡しではなくループ

慎重なエージェントは次の順序で二つのレイヤーを使います。

1. Catalog Search または Catalog Lookup で UCP が現在の Product を見つける。
2. Product、Variant、SKU、宣言された GTIN を厳密に照合する。
3. 参照された SKU.md から事実、証拠、互換性、制限を読む。
4. UCP に戻り、ユーザーの市場と状況における現在の価格と在庫を得る。
5. Checkout が選択商品を再確認し、最終総額と購入認可の権威を保つ。

第四段階が重要です。引用の充実した知識文書は「なぜ適するか」に答えるためのもので、リアルタイムコマース確認を省略するためのものではありません。リアルタイムの情報源を利用できなければ、古い文章から価格を写すのではなく「不明」と答えます。

Shopify 販売者の実務

知識文書の原稿には、確認済み Metafields、Metaobjects、製品マニュアル、試験報告、手入れ方法、保証条件、公開証拠を使えます。保存されているだけで自動的に真実にはなりません。公開前に担当者が Product、Variant、市場、証拠、改訂番号を確認して初めて規範上の事実にできます。

AI 生成文は不足フィールドの発見や読みやすい要約に使えますが、証拠との人手照合前は候補にすぎず、自動で事実に昇格できません。発行者は出典、検証時刻、主張を採否した理由も残します。SKU.md の価値は文章量ではなく、主張から証拠へ戻れる経路です。

Shopify のエージェント Profile は Profile の UCP 交渉への組み込みを、Shopify Catalog ガイド は検索・検索結果・商品読取を、グローバル Catalog 拡張 は Shopify のグローバル Catalog 拡張を説明します。これらは Shopify 自身が提供する機能面であり、Shopify が SKU.md を自動読取するとも、本独立拡張を対応するとも説明していません。

ローカル Reference Consumer が測れること

ローカル評価は固定商品データ、交渉済み能力、リソースのメタデータ、文書本文を使います。検索順位やコンバージョンではなく、証拠を伴い境界の明確な回答ができるかを測ります。

問い	UCP のみ	UCP + SKU.md
事実の引用	0	1
主張を誤って事実と扱う	0	0
開示事項の再現	0	1
互換性の回答	0	1
Variant 不一致時に安全に失敗	1	1
古いオファーを購入に使う	0	0

これはローカルの管理された結果で、順位向上、コンバージョン、採用指標、実際の Shopify 連携、外部エージェントの利用を証明しません。テストデータと制限は Reference Consumer の評価 にあります。

ドラフト完成を装わずに移行する

既存 v0.9 URL と検証動作は有効です。販売者は有効な v0.9 文書を残したまま v0.10 を準備し、スキーマ識別子を変更し、安定した識別情報と確認済み Knowledge を維持し、変動する商取引データを Knowledge の外へ移せます。v0.9 移行ガイド はオファーの削除または任意の予備情報の維持を、Catalog や Checkout のように見せず行う方法を説明します。

次の段階は拡張を標準と呼ぶことではありません。独立実装でスキーマの合成と失敗時の動作を試し、安全・プライバシー審査を行い、利用者と販売者のフィードバックを集めます。それまでは SKU.md v0.10 は実験的な販売者がホストする商品知識レイヤーであり、UCP がリアルタイム発見、商取引状態、最終購入判断を担います。

関連資料

SKU.md、UCP、ライブシステムの責任は、AIコマースの権限引き継ぎで整理しています。