本文へ移動

規範となる英語仕様

小さく、出典を保つ SKU.md 契約。

v1 はルートカタログと任意の商品知識という2つの純 Markdown を定義します。固定ラベルは英語、本文は任意言語です。

ルートカタログ

/sku.md に正確に公開し、店舗、公式サイト、同一オリジンの公開カタログを示します。

# Example Outdoor Gear> Lightweight outdoor equipment for hikers. SKU.md: [1.0.0-beta](https://sku.md/spec/1.0.0-beta/)Website: [example-outdoor.com](https://www.example-outdoor.com/) ## Catalog- [All products](https://www.example-outdoor.com/collections/all)

商品知識

正規商品ページごとに1文書。各項目は絶対 HTTPS の Source で終わります。

# UltraLight 2P Tent> A lightweight two-person tent for three-season backpacking. SKU.md: [1.0.0-beta](https://sku.md/spec/1.0.0-beta/)Catalog: [Example Outdoor Gear](https://www.example-outdoor.com/sku.md)Product: [Official product page](https://www.example-outdoor.com/products/tent)Updated: 2026-08-11 ## Facts- Packaged weight is 1.35 kg. [Source](https://www.example-outdoor.com/products/tent)

商品 HTML の代替リンク

商品ページは Markdown の代替リンクを宣言できますが、ルート /sku.md と Product knowledge リンクが主要な発見経路です。

<link rel="alternate" type="text/markdown" href="https://www.example-outdoor.com/products/tent.sku.md">

構文

見出し、固定ラベル行、リスト、通常の Markdown リンクを使います。未知の節は人向け本文として残りますが、規範フィールドではありません。

3つの検証範囲

範囲が明確な結果だけが意味を持ちます。

document

構造、安全なリンク、サイズ、出典規則を確認。

published

URL、HTTP 200、MIME、UTF-8、リダイレクト、最終資源を追加確認。

graph

相互リンク、同一オリジン、出典到達性、重複・循環を追加確認。

参照コンシューマーの動作

事実と出典を一緒に扱い、静的文書をライブ権限にしません。

  • 商品事実ごとに利用した Source を示す。
  • 事実、助言、制限、互換性を区別する。
  • 価格、在庫、配送、決済はライブ情報へ移し、不明なら不明と答える。

安全境界

SKU.md は公開 Markdown であり、隠し命令ではありません。

  • HTML、script、form、危険 URL、超過サイズ、不正 UTF-8 を拒否。
  • 自動抽出を、人の確認なしに店舗確認済みとしない。
  • 順位操作、隠し Agent 指示、取引資格情報を入れない。

バージョン履歴

1.0.0-betav0.10 と非互換で、互換モード、変換、選択 UI はありません。