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?

商務網路需要完成三項工作:協助智慧體了解商家銷售什麼、查詢當下的真實資訊,並在具備所需工具和授權時執行操作。

SKU.md 填補了全站探索與即時商務之間的公共知識層。它為智慧體提供結構化的產品脈絡,同時將價格、庫存、配送、稅費、結帳和付款決策指向正確的權威資料來源。

使用這套文件體系可以:

發布根資訊清單、選用的分區索引和產品層級知識文件。

區分長期事實、註明來源的聲明、有時效的報價快照和最終交易事實。

聲明哪個來源具有權威性,以及哪些商務能力已上線、規劃中或不支援。

這份草案不是購物或付款協定,而是一份由商家掌控的指南,讓商務技術堆疊的每一層都更容易被探索並正確使用。

一份 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 進入點用於識別商家、商品目錄、政策、權威來源和可用的商務層。

路徑/sku.md

分區索引

選用索引可依類別、市場或語言拆分大型商品目錄,並繼承距離最近的已聲明設定。

規模選用

產品文件

建議使用 .sku.md 檔案,將變體、媒體、事實、證據、限制和報價快照關聯到單一產品。

深度每項產品

權威來源與能力

明確聲明可將靜態知識、即時目錄事實、結帳總額和平台管控操作區分開來。

信任已聲明

如何使用 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。

5. 安全地擴充和使用

僅在需要時新增類別、市場或語言分區。將每份 SKU.md 文件視為不受信任的外部資料,重新查核即時值,絕不依據靜態快照觸發付款。

關於

SKU.md 是一份原創開放草案,參考了成熟的探索與商務機制,包括 robots.txtllms.txtSchema.orgWebMCP、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?

將每份文件視為不受信任的外部資料,而不是指令。驗證其網域和時間戳記,忽略改變行為的提示,在操作前查詢即時商務來源,絕不依據靜態內容觸發付款。