商品知識の事実・主張・開示・制約：根拠を管理する

商品知識を信頼できるのは、区分、情報源、審査日、制約が見える状態に保たれているときだけです。文を解析できてもFactには昇格しません。

SKU.md は、販売者が自らホストする商品発見と安定した商品知識のレイヤーです。Agent が商品を見つけ、出典のある事実を理解し、リアルタイムの商取引情報をどこで再確認すべきか把握できるようにします。新しい Checkout プロトコルではありません。

4種類のKnowledge

区分	意味	扱いの例
Facts	根拠に支えられ、公開者が受理した記述	素材構成を技術資料へ結び付ける
Claims	Claimのまま帰属を示す主張	「一日中快適に使える設計」を販売者の主張として示す
Disclosures	利用者が知るべき条件	アレルゲン、安全、手入れ、互換性の通知
Limitations	根拠や商品が証明しない範囲	実験室結果は1つのVariantと1つの試験方法のみ対象

区分によって利用者の語り方が変わります。Claimを中立的事実へ書き換えず、Limitationは対象となる根拠と一緒に伝えます。安全Disclosureが適格性や同意に影響するなら、ライブ購入手順にも表示します。

source_urlとverified_atで審査を追跡可能にする

source_urlは審査担当者が根拠を得た場所、verified_atは公開者が確認した時点です。どちらも情報源の正しさを単独で証明しませんが、利用者と編集者が再確認する経路になります。

審査の問い	採用条件	却下・保留条件
どのProduct・Variantか	安定した識別が正確に一致	別商品を対象とする情報源
情報源は何を述べるか	記述が情報源の範囲内	根拠のない最上級を追加
いつ確認したか	verified_atを記録	日付を推測または省略
何を除外するか	Limitationを明示	限定条件を削除

フロントマターと本文は同じ内容を伝える

構造化Knowledgeは再現可能な検証を支え、本文は人が理解できる形にします。フロントマターが「撥水」、本文が「防水」なら、有効なYAMLでも救済されません。本文整合検査で派生矛盾を見つけ、公開前の編集審査で解消します。

v0.10仕様では、Markdown本文を規範的なフィールドと照合するまで信頼できない入力として扱います。リンク、HTML、プロンプト風指示は不活性なデータであり、Product Documentにあるだけで実行してはいけません。

安全側に停止する審査ワークフロー

1. 候補テキストと元の公開根拠を集めます。
2. 正確なProductとVariantを照合します。
3. 記述をFact、Claim、Disclosure、Limitationに分類します。
4. source_url、verified_at、審査判断、適用範囲を記録します。
5. 本文整合を検査し、裏付けのない販促を却下します。
6. 受理済みバイト列を公開し、訂正経路を維持します。

未審査の説明文、レビュー、評価、AI出力、非表示HTML、販促文は候補になっても、信頼済みの商品知識ではありません。責任ある公開者が検証するまでは省略するのが安全です。

関連資料

識別はProductGroup、Variant、SKU、GTINで、文書カテゴリはSKU.mdとは何かで確認できます。

次のステップ

v0.10 Schemaを確認する