什麼是 SKU.md？寫給 AI agent 的商家自有商品知識
BLOG / what-is-sku-md.mdx
解釋 SKU.md、文件家族、Readable–Queryable–Executable Web，以及它不會跨越的即時與交易權威邊界。
SKU.md 是一份由商家自行託管、給自動化購物代理讀取的商品資訊入口。它讓 agent 更容易找到商品、讀到穩定且有來源的說明，也指出哪些即時資訊必須回到商家系統確認；它補上的是解釋層，不是即時商業資料本身。
更精確地說，SKU.md 是由商家託管的商品發現與穩定商品知識：agent 可以找到商品、理解有來源的事實，並知道去哪裡複查即時商業狀態；它不是新的結帳協議。
問題出在商品知識四散各處
同一商品的資訊可能散落在 HTML、Product JSON-LD、Feed、手冊、政策頁、尺寸表、即時 Catalog 與 Checkout 中。標題和現價解釋不了某項材質說法是否經過測試、覆蓋哪個 Variant、證據何時審核；行銷長文也不會告訴顧客，今天的庫存到底由誰負責。
SKU.md 用一組小型文件說清身分、知識、證據、限制與即時核驗入口，避免把它們揉成一個虛假的「唯一真相」。
Readable、Queryable、Executable 各自負責什麼
| 層級 | 擅長回答 | 權威邊界 |
|---|---|---|
| Readable Web | 穩定解釋、證據、披露與發現 | SKU.md 參與這一層 |
| Queryable Web | 目前目錄、價格、庫存與配送估算 | 即時 Catalog、API 或 MCP 負責 |
| Executable Web | 購物車、支付、訂單與頁面操作 | Checkout、訂單系統、UCP 或經審查的 WebMCP 操作負責 |
這三層不是一站接一站的流程終點，而是一條循環：發現商品、讀取來源知識、查詢目前條件，再在高影響操作前請求使用者確認。靜態知識應讓這條循環更安全，不能刪掉即時檢查。
v0.10 文件家族
v0.10 規範定義根 Catalog Manifest、可選 Partition Index 與 Product Document。最小 manifest-basic 可以發布身分與目錄連結，卻不虛構即時能力。Product Document 把 Knowledge 綁定到穩定 Product 和 Variant；沒有任何報價也可以有效。
可選 offer_snapshot 只記錄歷史觀察，可選 live_offer 指向另行宣告的即時查詢。兩者都不會把 Markdown 變成有約束力的報價。Canonical 與 parent 讓文件之間的關係可以被檢查；線上資源測試只能證明交付成功，不能證明內容一定正確。
誰來發布、實作和消費
發布者是有能力審查商品來源的商家或授權營運方；實作者打造生成器、驗證器、平台路由與保守的消費端；消費者可以是 agent、目錄工具、無障礙工具，或需要來源依據的內部系統。
| 角色 | 應負責的選擇 | 不安全捷徑 |
|---|---|---|
| 發布者 | 確認身分、來源、日期與限制 | 把未審行銷文案升級為 Fact |
| 實作者 | 歧義時安全失敗，並驗證公開交付 | 把本機 Schema 通過當作發布成功 |
| 消費者 | 引用來源並複查易變狀態 | 把舊快照當作今日價格 |
SKU.md 不能賦予什麼
它不能授予權限、驗證請求、批准支付、保證履約，也不會因為一條陳述能解析就讓它變真。它更不能證明模型一定抓取、引用、推薦、排序或帶來轉換。
這個作用範圍不大，卻很實際。商家可以公開一份穩定、可審查的商品解釋，並指出哪些不確定性必須回到即時來源解決。
延伸閱讀
透過llms.txt、agents.md 與 SKU.md 的職責矩陣比較相鄰格式，再看發布第一份 SKU.md的交付流程。