BLOG / what-is-sku-md.mdx
什么是 SKU.md？面向 agent 的商家托管商品知识
解释 SKU.md、文档家族、Readable–Queryable–Executable Web，以及它不会跨越的实时与交易权威边界。
SKU.md 是一种由商家托管的方式，让自动化消费者更容易发现商品、读取稳定且有来源的商品知识。它把耐久解释连接到实时商业来源，而不是取代这些来源。
更精确地说，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的交付流程。