從一個商品開始：Shopify、SHOPLINE、WooCommerce 與 BigCommerce 商家的 SKU.md 導入指南
v1.0.0 專題
對照 Shopify、SHOPLINE、WooCommerce 與 BigCommerce 的發布條件，從一個商品開始生成、審核並驗證 SKU.md。
為 Agent 購物準備商品知識，不必從全店改造開始。對 Shopify、SHOPLINE、WooCommerce 和 BigCommerce 商家，合理的第一步是選一個商品：整理真實資料，確認自己的商店能如何提供檔案，再決定是否擴大範圍。
SKU.md v1.0.0 提供一套開放、可檢查的表達方式。它補充商品頁面、結構化資料與通路 Feed；商店原有的庫存、支付和訂單流程繼續承擔即時交易。這裡介紹的是可評估的整合路徑，不代表四個平台已經原生支援 SKU.md。
先確定能發布什麼，再選擇路徑
整合至少涉及兩項不同工作：內容準確，以及線上交付正確。營運人員可以整理規格、變體、限制和來源；技術人員或服務商需要確認商店網域下的實際回應。
下面的判斷參考平台官方資料。具體方案仍取決於商店的託管方式、權限和回應測試，不應只根據「可以上傳檔案」就宣佈完成。
| 平台 | 商家可控制的部分 | 整合前要確認的條件 | 驗證重點 |
|---|---|---|---|
| Shopify | 主題內容；自主管理店面的路由取決於架構 | App Proxy 有固定前綴，不能據此認定已控制根路徑 | 實際地址返回 Markdown，而不是主題 HTML |
| SHOPLINE | 商品內容與允許設定的重新導向 | 官方重新導向功能不等於已提供規範檔案；需確認同源交付方式 | 目標地址、回應內容與重新導向鏈 |
| WooCommerce | 取決於託管權限的 WordPress 路由或靜態檔案 | 技術人員需設定正確回應；僅增加重寫規則還不夠 | 狀態碼、內容類型、快取與正文 |
| BigCommerce | Stencil 範本或自主管理店面的路由 | 自訂頁面範本不證明可輸出根路徑 Markdown；受控店面需單獨實作 | 區分 HTML 頁面與檔案回應 |
這些是依據平台能力做出的實作判斷，不是平台相容認證。如果目前店面沒有合適的發布路徑，先維護準確的商品資料，並讓服務商評估；不必僅為一個檔案更換建站平台。
目前規範如何發現檔案
優先在同一網站的精確 /sku.md 路徑提供根目錄檔案。只有該路徑返回明確的 HTTP 404 時，消費者才可以檢查同源首頁的一條無歧義宣告，例如：
<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">被宣告的檔案也必須滿足目前規範，包括同源 HTTPS，且地址不帶查詢參數或片段。超時、伺服器錯誤和格式錯誤都不是「根檔案不存在」，不能用備用入口掩蓋。
這是一種有條件的規範路徑，不是任何主題都能直接使用的技巧。首頁宣告與實際檔案都必須可控、可驗證；普通 CDN 檔案連結、HTML 介紹頁或跨源跳轉不能直接當成已合規。
從最小目錄開始
以下是虛構商店的最小根檔案。替換為真實商店名稱、簡介、網域與目錄地址後，再生成和檢查；它本身不聲稱已經描述某個商品的完整屬性。
# Example Outdoor Gear
> Lightweight outdoor equipment for hikers.
SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)
Website: [example-outdoor.com](https://www.example-outdoor.com/)
## Catalog
- [All products](https://www.example-outdoor.com/collections/all)商品知識文件是可選的。增加第一個商品時，應從根目錄明確連結到它，並在商品文件中保留目錄回鏈、商品頁面和逐條事實的來源。涉及變體時，說明事實屬於整個商品還是某個具體款式。
五步完成一次可驗證的試點
- 選擇商品。 優先選公開資料完整、經常有人詢問規格的商品，不必先抓取整個商店。
- 審核事實。 對照真實頁面確認身分、規格、限制及證據；未知就是未知，不憑經驗推斷。
- 生成並檢查。 使用生成器準備根檔案，需要更細的屬性審核時使用商品最佳化工具。
- 發布並驗證。 由負責商店的人提供檔案，再用線上地址檢查驗證真實 URL；商品文件還要檢查目錄關聯。
- 安排維護。 指定負責人，在規格、變體或來源變化時更新文件，並重新檢查；儲存上次審核依據。
驗收時確認公開 HTTPS 地址、HTTP 200、UTF-8 Markdown 正文及規範允許的內容類型（text/markdown 或 text/plain）。還要檢查安全跳轉、目錄關係和來源；瀏覽器裡看見一段文字並不代表全部通過。
如何判斷試點值得繼續
一個可交付的試點，應能回答：檔案是否真的可存取，事實是否有來源，變體範圍是否正確，哪些購買問題仍需即時系統回答。再考慮擴大商品數量，而不是隻統計生成了多少檔案。
SKU.md 不會登入商家後台、自動發布商品或自動提交到外部購物通路。商家仍決定發布哪些內容；Agent 是否消費這些知識，需要獨立驗證。價格、庫存與配送承諾始終回到商店即時系統。
從快速開始開始，把一份已審核的商品知識交給負責商店的人。這一步小而具體，也最容易發現值得解決的問題。
平台資料與規範
- Shopify App Proxy：代理路由能力與限制。
- SHOPLINE 重新導向：地址轉發能力。
- WordPress 路由重寫：WooCommerce 所用基礎平台的路由機制。
- BigCommerce 店面類型與自訂範本：不同店面的控制範圍。
- SKU.md 1.0.0 規範：檔案、發現與驗證要求的依據。