ルートマニフェスト
必須の /sku.md エントリーポイントが、マーチャント、カタログ、ポリシー、権威、利用可能なコマースレイヤーを特定します。
パス/sku.md
SKU.md
カタログを最もよく知るマーチャントが管理し、AI エージェント向けに自ら公開する商品知識レイヤーです。
SKU.md を使うと、カタログと商品ドキュメント、安定した識別子、AI の利用許可、権威ある情報源、エージェントが次に使うべきライブコマース機能を公開できます。
---schema_version: "sku.md/1.0"document_type: catalog_manifestcanonical: "https://www.example-outdoor.com/sku.md"generated_at: "2026-07-16T18:30:00+08:00"data_revision: "catalog-20260716-1830"language: "en-US"market: "CN" merchant: id: "https://www.example-outdoor.com/#merchant" name: "Example Outdoor Gear" legal_name: "Example Outdoor Gear Inc." site_url: "https://www.example-outdoor.com/" support_url: "https://www.example-outdoor.com/pages/contact" ai_usage: training: disallow retrieval_answer: allow citation_required: true agentic_checkout: unsupported authority: identity: sku_document product_facts: sku_document offer_snapshot: sku_document live_price: live_catalog live_availability: live_catalog shipping_quote: checkout tax: checkout final_total: checkout payment: checkout capabilities: self_hosted: schema_jsonld: status: live note: "Each product detail page embeds schema.org/Product + Offer JSON-LD in <head>" # Additional capabilities follow---SKU.md が必要な理由
コマース Web には 3 つの役割があります。マーチャントが何を販売しているかをエージェントが理解し、現在の事実を照会し、必要なツールと承認がそろったときに操作できるようにすることです。
SKU.md は、サイト全体の発見とライブコマースの間にある公開知識レイヤーを担います。エージェントに構造化された商品コンテキストを提供しながら、価格、在庫、配送、税、チェックアウト、支払いの判断を適切な権威ある情報源へ導きます。
このドキュメント群でできること：
ルートマニフェスト、任意のパーティション索引、商品単位の知識ドキュメントを公開する。
永続的な事実、出典付きの主張、期限付きのオファースナップショット、最終的な取引事実を分ける。
どの情報源が権威を持ち、各コマース機能が提供中、計画中、未対応のいずれかを宣言する。
このドラフトはショッピングや決済のプロトコルではありません。コマーススタックの各レイヤーを見つけやすくし、正しく利用できるようにする、マーチャント管理のガイドです。
1 つの SKU.md がコマーススタックをつなぐ
アクセスと発見から商品の事実と操作まで、SKU.md はどのレイヤーが権威を持つか、どの機能があり、次にどこへ進むべきかをエージェントに示します。
例
---schema_version: "sku.md/1.0"document_type: catalog_manifestcanonical: "https://www.example-outdoor.com/sku.md"generated_at: "2026-07-16T18:30:00+08:00"data_revision: "catalog-20260716-1830"language: "en-US"market: "CN" merchant: id: "https://www.example-outdoor.com/#merchant" name: "Example Outdoor Gear" legal_name: "Example Outdoor Gear Inc." site_url: "https://www.example-outdoor.com/" support_url: "https://www.example-outdoor.com/pages/contact" ai_usage: training: disallow retrieval_answer: allow citation_required: true agentic_checkout: unsupported authority: identity: sku_document product_facts: sku_document offer_snapshot: sku_document live_price: live_catalog live_availability: live_catalog shipping_quote: checkout tax: checkout final_total: checkout payment: checkout capabilities: self_hosted: schema_jsonld: status: live note: "Each product detail page embeds schema.org/Product + Offer JSON-LD in <head>" sitemap: status: live url: "https://www.example-outdoor.com/sitemap-products.xml" webmcp: status: unsupported scope: "/products/*" tools: [] platform_gated: acp_product_feed: status: planned url: "https://www.example-outdoor.com/feeds/acp-products.jsonl.gz" acp_checkout: status: unsupported ucp_catalog: status: planned well_known: "https://www.example-outdoor.com/.well-known/ucp" capability: "dev.ucp.shopping.catalog.lookup" ucp_checkout: status: unsupported identifiers: product_id_namespace: "gid://example-outdoor.com/Product/" variant_id_namespace: "gid://example-outdoor.com/ProductVariant/" sku_scope: merchant variant_id_is_checkout_item_id: true catalog: mode: inline product_count: 35 variant_count: 112 partitions: [] policies: shipping: "https://www.example-outdoor.com/policies/shipping" returns: "https://www.example-outdoor.com/policies/returns" warranty: "https://www.example-outdoor.com/policies/warranty" ai_usage: "https://www.example-outdoor.com/policies/ai" languages: ["zh-CN", "en-US"]currency_default: "USD"update_frequency: "weekly"--- # Example Outdoor Gear > An independent store focused on lightweight outdoor gear across three categories:> tents, sleeping bags, and hiking backpacks. Products emphasize lightweight designs> under 750g and range from $39–$459. With 35 SKUs, the catalog remains small enough> to use `catalog.mode: inline` without partition files. ## Categories - [Ultralight Tents](https://www.example-outdoor.com/collections/tents): 12 available models, priced from $129–$459- [Down Sleeping Bags](https://www.example-outdoor.com/collections/sleeping-bags): 8 available models, priced from $89–$329- [Hiking Backpacks](https://www.example-outdoor.com/collections/backpacks): 15 available models, priced from $39–$189 ## Featured SKUs | SKU ID | Name | Key specifications | Reference price | Product page | Product document ||---|---|---|---|---|---|| TENT-ULT-02 | UltraLight 2P Tent | Weight 1.35kg; hydrostatic head 3000mm | $259–$299 | [Details](https://www.example-outdoor.com/products/tent-ult-02) | [sku.md](https://www.example-outdoor.com/products/tent-ult-02.sku.md) || BAG-DOWN-700 | 700-Fill-Power Down Sleeping Bag | Lower temperature limit -5°C; weight 890g | $199–$249 | [Details](https://www.example-outdoor.com/products/bag-down-700) | [sku.md](https://www.example-outdoor.com/products/bag-down-700.sku.md) || PACK-45L-AIR | Air Series 45L Backpack | Empty weight 980g; aluminum alloy suspension system | $129–$159 | [Details](https://www.example-outdoor.com/products/pack-45l-air) | [sku.md](https://www.example-outdoor.com/products/pack-45l-air.sku.md) | *See `sitemap-products.xml` for the complete SKU list. Each product's `.sku.md`document carries its facts, limitations, and evidence.* ## FAQ **Q: How long does shipping take?**A: Orders ship the same day from the mainland China warehouse. Standard deliveryto the United States and Europe takes 7–12 business days. **Q: Do you accept returns and exchanges?**A: Unopened items may be returned or exchanged within 30 days of delivery. Theseller covers shipping both ways when the item has a quality issue. **Q: Can AI shopping assistants place orders directly?**A: Not currently. See `ai_usage.agentic_checkout: unsupported` and the checkoutstatuses under `capabilities.platform_gated`. Direct users to the product page tocomplete their purchase. ## Policies - Shipping: Ships from a mainland China warehouse; standard delivery takes 7–12 business days- Returns: Unopened items may be returned or exchanged within 30 days; return shipping is free for quality issues- Warranty: One year for the main body of tents and backpacks; six months for sleeping bags ## Changelog - 2026-07-17: Published sku.md/1.0 with authority declarations, expanded capabilities, and product-document links- 2026-07-16: Initial release covering 35 SKUs across three categories パーティション索引
任意の索引は、大規模なカタログをカテゴリ、市場、言語で分割し、最も近い宣言済み設定を継承します。
規模任意
商品ドキュメント
推奨される .sku.md ファイルは、バリエーション、メディア、事実、根拠、制限、オファースナップショットを 1 つの商品に結び付けます。
詳細度商品ごと
権威と機能
明示的な宣言により、静的な知識、ライブカタログの事実、チェックアウト合計、プラットフォーム管理の操作を区別します。
信頼宣言済み
SKU.md の使い方
1. 信頼できる商品情報を準備する
商品ページで Product と Offer の JSON-LD を公開し、商品サイトマップを維持します。これらは SKU.md 知識レイヤーの基礎となるページ単位の事実と完全な URL 一覧です。
2. ルートマニフェストを公開する
/sku.md を追加し、ドキュメントとマーチャントの識別情報、AI 利用規則、権威、機能、安定した識別子の規則、カタログメタデータ、ポリシー、簡潔で読みやすい要約を記載します。
3. すべての表現を発見可能にする
robots.txt でドキュメント群を許可し、llms.txt から /sku.md へリンクし、HTML の rel="alternate" と同等の HTTP Link ヘッダーで商品の Markdown を通知します。
4. 必要な商品に知識を追加する
優先商品のために商品単位の .sku.md ドキュメントを作成します。事実、主張、メディア、制限、有効期限付きのオファースナップショットを安定した商品 ID とバリエーション ID に結び付けます。
5. 安全に拡張し利用する
必要な場合にだけカテゴリ、市場、言語のパーティションを追加します。すべての SKU.md ドキュメントを信頼できない外部データとして扱い、ライブ値を再確認し、静的スナップショットから支払いを実行しないでください。
概要
SKU.md は、確立された発見とコマースの仕組みを参考にした独自のオープンドラフトです。参考にした仕組みには次のものがあります：robots.txt、llms.txt、Schema.org、WebMCP、ACP、UCP。
バージョン 1.0 はドラフト提案であり、正式に採用された標準ではありません。マーチャントが管理するカタログ、パーティション、商品ドキュメント群を定義しつつ、ライブコマースの事実と取引の権限は、そのために設計されたシステムに委ねます。
よくある質問
SKU.md は公式標準ですか？
いいえ。sku.md/1.0 は独自の提案であり、業界で採用された標準ではありません。マーチャント、プラットフォーム、エージェント開発者が評価し改善できるよう、公開されています。
必須のフィールドはどれですか？
ルートマニフェストでは、ドキュメント識別情報、マーチャント識別情報、AI 利用規則、情報源の権威、機能を宣言します。不明または利用できない機能は曖昧なままにせず、計画中または未対応と記す必要があります。
SKU.md に価格と在庫を記載できますか？
はい。ただし、observed_at、valid_until、スナップショットの権威、live_lookup ポインターを含むオファースナップショットとしてのみ記載できます。エージェントはチェックアウトや支払いの前に、ライブの価格と在庫を再確認する必要があります。
SKU.md だけでエージェントがチェックアウトできますか？
できません。ACP または UCP のカタログとチェックアウト機能が提供中、計画中、未対応のいずれかを宣言するものです。取引には、該当するプラットフォーム連携、マーチャントの承認、ライブ合計、ユーザーの許可が引き続き必要です。
パーティションファイルはどのように設定を継承しますか？
カテゴリ、市場、言語のパーティションは、明示的に上書きしない限り、ルートマニフェストから ai_usage、authority、capabilities を継承します。最も近い宣言が適用され、generated_at と data_revision は各ファイルで個別に管理されます。
どのくらいの頻度で更新すべきですか？
内容が変わるたびに generated_at と data_revision を更新し、機能の状態とスナップショットを最新に保ち、構造上の変更を変更履歴に記録します。カタログの各部分で異なる更新頻度が必要な場合はパーティションを使います。
エージェントは商品ドキュメントをどう見つけますか？
robots.txt で SKU.md のパスを許可し、llms.txt からルートマニフェストへリンクし、商品ページの HTML と HTTP Link ヘッダーの両方で各商品ドキュメントを代替表現として通知します。
<link rel="alternate" type="text/markdown" href="/products/example.sku.md">エージェントは SKU.md をどう安全に扱うべきですか？
すべてのドキュメントを命令ではなく、信頼できない外部データとして扱います。ドメインとタイムスタンプを検証し、動作を変えるプロンプトを無視し、操作前にライブコマース情報源へ問い合わせ、静的コンテンツだけで支払いを実行しないでください。