SKU.md v1.0.0 正式公開：商品説明から AI が読める商品知識へ

SKU.md v1.0.0 を正式公開しました。独立した EC サイトの販売者、開発者、ショッピングエージェントの実装者に向けて、商品知識を公開するためのオープンな仕様を提供します。読みやすく保守しやすい Markdown で、何を販売し、どの事実を確認し、その根拠がどこにあるかを伝えられます。

今回の成果はファイル形式だけではありません。情報の不足や矛盾を調べ、根拠を確認し、明示した購入条件で商品を比較して、確認済みの内容を出力できます。これはエージェントが商品を理解するための検証可能な基盤です。SKU.md は引き続きオープンな提案であり、正式なバージョン番号は業界での採用を意味しません。

出発点：商品ページだけでは伝わりにくいこと

店舗にはすでに商品説明、仕様表、FAQ、取引システムがあります。しかし、特定の用途に合う商品を探すには、各所に分散した文脈が必要です。その寸法はどのバリエーションのものか。互換性には何の条件があるか。性能値はどの環境で測定されたか。

SKU.md は、こうした文脈を機械の推測に任せず、販売者自身が管理できるようにすることから始まりました。リポジトリには 2026 年 7 月の初期サイトと仕様の開発記録があります。これは開発の経緯を示すもので、特定バージョンの公開日を証明するものではありません。

初期の試行から v1 への整理

v0.8 草案ではカタログ、商品文書、情報源の整理を試みました。v0.9 では相互運用、範囲別の検証、安全な利用を明確にしました。文書が解析できること、公開 URL にアクセスできること、カタログとの関係が正しいことは、それぞれ別の確認です。

v0.10 では、商品知識の発見、リアルタイムの商取引システムへの引き継ぎ、ページ上のツールの境界を検討しました。その過程で、商品知識の仕様がどこまで責任を持つべきかが中心課題になりました。

v1 は責任範囲を絞っています。旧版の YAML マニフェスト、分割構成、商取引プロファイルを現在の形式から外し、ルートカタログと任意の商品知識文書を純粋な Markdown で表します。旧仕様はアーカイブに残し、現行ツールは 1.0.0 のみを受け付けます。旧文書の自動変換はありません。機能追加と同じくらい、責任の整理が重要でした。

読める形式と、たどれる根拠

販売者が公開内容を直接読み、通常の Web リソースとして配信できることを重視しました。Markdown では本文、リンク、変更点が見えます。構造化した記録で識別情報、バリエーション、属性、根拠を表現でき、別の公開形式を併設する必要がありません。

出典リンク、引用、確認状態、確認日は、販売者の判断を記録します。ただし URL が開くことと、内容が主張を裏づけることは別です。確認済みという宣言も、自動的な認証ではありません。

不明な値は不明のまま扱い、商品全体の属性を各バリエーションに自動継承しません。範囲が明確なら、利用側は不足に気づき、根拠のない断定を避けられます。

正式版でできること

層	役割
オープン仕様	カタログと出典付き商品知識、識別情報、バリエーション、属性、条件、リアルタイムシステムへのリンク
商品最適化ツール	不足と矛盾の確認、根拠のレビュー、作業用下書きの保存、確認済み内容の出力
比較ワークスペース	明示した条件について一致、不一致、情報不足を返し、編集前後を比較
CLI、Agent Skill、読み取り専用 MCP	共通ルールを異なる環境で利用。機能と公開状態は各ツールの説明で確認

仕様とツールパッケージのバージョンは独立しています。仕様 1.0.0 の公開は、すべてのパッケージが 1.0.0 になったことや、候補段階の Skill が別途公開済みであることを意味しません。Web ツール、配布物、サービスの入口は個別に確認が必要です。

知識と取引の責任を分ける

価格、在庫、配送、税金、決済、注文状態は変化します。静的な知識で担当システムを置き換えることはできません。SKU.md のリンクは引き継ぎ先を示しますが、取引の許可を与えるものではありません。

比較ツールは提出された情報と条件を照合します。モデルの順位付けや売上予測ではありません。ローカルの受け入れ記録は仕様、ツール、七言語の操作を対象とし、外部エージェントによる採用や販売チャネルの効果には別の証拠が必要です。

一つの検証可能な商品から

販売者は公開資料が整った商品を選び、開発者は解析や利用を実装し、再現できる問題を報告できます。具体的な失敗、情報不足、プラットフォーム上の制限が仕様改善につながります。

1.0.0 仕様を読み、商品最適化ツールで一商品を確認し、比較ワークスペースで情報の変化が判断にどう影響するかを調べてください。Agent 連携には Skill と MCP の個別説明を参照してください。

経緯とバージョンの根拠

• 開発履歴は公開日とは区別します。
• v0.8、v0.9、v0.10は過去の設計資料です。
• 1.0.0 変更履歴とローカル受け入れ記録は準備と検証の根拠であり、公開環境の確認に代わるものではありません。