根清单
必需的 /sku.md 入口用于标识商家、商品目录、政策、权威来源和可用的商业层。
路径/sku.md
SKU.md
由最了解商品目录的商家掌控，为 AI 智能体提供自主发布的产品知识层。
使用 SKU.md 公开商品目录和产品文档、稳定标识符、AI 使用权限、权威数据源，以及智能体接下来应调用的实时商业能力。
---schema_version: "sku.md/1.0"document_type: catalog_manifestcanonical: "https://www.example-outdoor.com/sku.md"generated_at: "2026-07-16T18:30:00+08:00"data_revision: "catalog-20260716-1830"language: "en-US"market: "CN" merchant: id: "https://www.example-outdoor.com/#merchant" name: "Example Outdoor Gear" legal_name: "Example Outdoor Gear Inc." site_url: "https://www.example-outdoor.com/" support_url: "https://www.example-outdoor.com/pages/contact" ai_usage: training: disallow retrieval_answer: allow citation_required: true agentic_checkout: unsupported authority: identity: sku_document product_facts: sku_document offer_snapshot: sku_document live_price: live_catalog live_availability: live_catalog shipping_quote: checkout tax: checkout final_total: checkout payment: checkout capabilities: self_hosted: schema_jsonld: status: live note: "Each product detail page embeds schema.org/Product + Offer JSON-LD in <head>" # Additional capabilities follow---为什么选择 SKU.md？
商业互联网需要完成三项工作：帮助智能体了解商家销售什么、查询当下的真实信息，并在具备所需工具和授权时执行操作。
SKU.md 填补了全站发现与实时商业之间的公共知识层。它为智能体提供结构化的产品背景，同时将价格、库存、配送、税费、结账和支付决策指向正确的权威数据源。
使用这套文档体系可以：
发布根清单、可选的分区索引和产品级知识文档。
区分长期事实、注明来源的声明、限时的报价快照和最终交易事实。
声明哪个来源具有权威性，以及哪些商业能力已上线、在计划中或不受支持。
这份草案不是购物或支付协议，而是一份由商家掌控的指南，让商业技术栈的每一层都更容易被发现并得到正确使用。
一份 SKU.md 连接整个商业技术栈
从访问和发现，到产品事实与实际操作，SKU.md 会告诉智能体哪一层最具权威、有哪些能力，以及下一步应前往哪里。
示例
---schema_version: "sku.md/1.0"document_type: catalog_manifestcanonical: "https://www.example-outdoor.com/sku.md"generated_at: "2026-07-16T18:30:00+08:00"data_revision: "catalog-20260716-1830"language: "en-US"market: "CN" merchant: id: "https://www.example-outdoor.com/#merchant" name: "Example Outdoor Gear" legal_name: "Example Outdoor Gear Inc." site_url: "https://www.example-outdoor.com/" support_url: "https://www.example-outdoor.com/pages/contact" ai_usage: training: disallow retrieval_answer: allow citation_required: true agentic_checkout: unsupported authority: identity: sku_document product_facts: sku_document offer_snapshot: sku_document live_price: live_catalog live_availability: live_catalog shipping_quote: checkout tax: checkout final_total: checkout payment: checkout capabilities: self_hosted: schema_jsonld: status: live note: "Each product detail page embeds schema.org/Product + Offer JSON-LD in <head>" sitemap: status: live url: "https://www.example-outdoor.com/sitemap-products.xml" webmcp: status: unsupported scope: "/products/*" tools: [] platform_gated: acp_product_feed: status: planned url: "https://www.example-outdoor.com/feeds/acp-products.jsonl.gz" acp_checkout: status: unsupported ucp_catalog: status: planned well_known: "https://www.example-outdoor.com/.well-known/ucp" capability: "dev.ucp.shopping.catalog.lookup" ucp_checkout: status: unsupported identifiers: product_id_namespace: "gid://example-outdoor.com/Product/" variant_id_namespace: "gid://example-outdoor.com/ProductVariant/" sku_scope: merchant variant_id_is_checkout_item_id: true catalog: mode: inline product_count: 35 variant_count: 112 partitions: [] policies: shipping: "https://www.example-outdoor.com/policies/shipping" returns: "https://www.example-outdoor.com/policies/returns" warranty: "https://www.example-outdoor.com/policies/warranty" ai_usage: "https://www.example-outdoor.com/policies/ai" languages: ["zh-CN", "en-US"]currency_default: "USD"update_frequency: "weekly"--- # Example Outdoor Gear > An independent store focused on lightweight outdoor gear across three categories:> tents, sleeping bags, and hiking backpacks. Products emphasize lightweight designs> under 750g and range from $39–$459. With 35 SKUs, the catalog remains small enough> to use `catalog.mode: inline` without partition files. ## Categories - [Ultralight Tents](https://www.example-outdoor.com/collections/tents): 12 available models, priced from $129–$459- [Down Sleeping Bags](https://www.example-outdoor.com/collections/sleeping-bags): 8 available models, priced from $89–$329- [Hiking Backpacks](https://www.example-outdoor.com/collections/backpacks): 15 available models, priced from $39–$189 ## Featured SKUs | SKU ID | Name | Key specifications | Reference price | Product page | Product document ||---|---|---|---|---|---|| TENT-ULT-02 | UltraLight 2P Tent | Weight 1.35kg; hydrostatic head 3000mm | $259–$299 | [Details](https://www.example-outdoor.com/products/tent-ult-02) | [sku.md](https://www.example-outdoor.com/products/tent-ult-02.sku.md) || BAG-DOWN-700 | 700-Fill-Power Down Sleeping Bag | Lower temperature limit -5°C; weight 890g | $199–$249 | [Details](https://www.example-outdoor.com/products/bag-down-700) | [sku.md](https://www.example-outdoor.com/products/bag-down-700.sku.md) || PACK-45L-AIR | Air Series 45L Backpack | Empty weight 980g; aluminum alloy suspension system | $129–$159 | [Details](https://www.example-outdoor.com/products/pack-45l-air) | [sku.md](https://www.example-outdoor.com/products/pack-45l-air.sku.md) | *See `sitemap-products.xml` for the complete SKU list. Each product's `.sku.md`document carries its facts, limitations, and evidence.* ## FAQ **Q: How long does shipping take?**A: Orders ship the same day from the mainland China warehouse. Standard deliveryto the United States and Europe takes 7–12 business days. **Q: Do you accept returns and exchanges?**A: Unopened items may be returned or exchanged within 30 days of delivery. Theseller covers shipping both ways when the item has a quality issue. **Q: Can AI shopping assistants place orders directly?**A: Not currently. See `ai_usage.agentic_checkout: unsupported` and the checkoutstatuses under `capabilities.platform_gated`. Direct users to the product page tocomplete their purchase. ## Policies - Shipping: Ships from a mainland China warehouse; standard delivery takes 7–12 business days- Returns: Unopened items may be returned or exchanged within 30 days; return shipping is free for quality issues- Warranty: One year for the main body of tents and backpacks; six months for sleeping bags ## Changelog - 2026-07-17: Published sku.md/1.0 with authority declarations, expanded capabilities, and product-document links- 2026-07-16: Initial release covering 35 SKUs across three categories 分区索引
可选索引可按品类、市场或语言拆分大型商品目录，并继承距离最近的已声明设置。
规模可选
产品文档
建议使用 .sku.md 文件，将变体、媒体、事实、证据、限制和报价快照关联到单个产品。
深度每个产品
权威来源与能力
明确声明可将静态知识、实时目录事实、结账总额和平台受控操作区分开来。
信任已声明
如何使用 SKU.md？
1. 准备可靠的产品事实
在产品页面发布 Product 和 Offer JSON-LD，并维护产品站点地图。它们仍是 SKU.md 知识层背后的页面级事实和完整 URL 清单。
2. 发布根清单
添加 /sku.md，包含文档与商家身份、AI 使用规则、权威来源、能力、稳定标识符规则、目录元数据、政策以及简明易读的摘要。
3. 让每种表示方式都可被发现
在 robots.txt 中允许访问这套文档，在 llms.txt 中链接 /sku.md，并通过 HTML 中的 rel="alternate" 和等效的 HTTP Link 标头公开产品 Markdown。
4. 在关键位置补充产品知识
为重点商品创建产品级 .sku.md 文档，将事实、声明、媒体、限制和即将过期的报价快照关联到稳定的产品和变体 ID。
5. 安全地扩展和使用
仅在需要时添加品类、市场或语言分区。将每份 SKU.md 文档视为不受信任的外部数据，重新核验实时值，绝不依据静态快照触发支付。
关于
SKU.md 是一份原创开放草案，参考了成熟的发现与商业机制，包括 robots.txt、llms.txt、Schema.org、WebMCP、ACP 和 UCP。
版本 1.0 是草案提案，并非正式采用的标准。它定义了一套由商家掌控的商品目录、分区和产品文档，同时将实时商业事实与交易权威保留在专门为此设计的系统中。
常见问题
SKU.md 是正式标准吗？
不是。sku.md/1.0 是原创提案，并非行业采用的标准。它以开放方式发布，供商家、平台和智能体开发者评估并改进。
哪些字段是必需的？
根清单需要声明文档身份、商家身份、AI 使用规则、权威数据源和能力。未知或不可用的能力应标记为计划中或不受支持，不应含糊留空。
SKU.md 可以包含价格和库存吗？
可以，但只能作为报价快照，并需包含 observed_at、valid_until、快照权威来源和 live_lookup 指针。智能体必须在结账或支付前重新核验实时价格和库存。
SKU.md 能让智能体完成结账吗？
仅凭它不能。它会声明 ACP 或 UCP 的商品目录与结账能力是已上线、在计划中还是不受支持。交易仍需要相关平台集成、商家批准、实时总额和用户授权。
分区文件如何继承设置？
品类、市场或语言分区会从根清单继承 ai_usage、authority 和 capabilities，除非显式覆盖。距离最近的声明生效，而 generated_at 和 data_revision 仍由每个文件单独维护。
应该多久更新一次？
内容变化时更新 generated_at 和 data_revision，保持能力状态和快照为最新，并在变更日志中记录结构调整。当目录的不同部分需要独立更新周期时，可使用分区。
智能体如何发现产品文档？
在 robots.txt 中允许访问 SKU.md 路径，从 llms.txt 链接根清单，并在产品页面 HTML 及其 HTTP Link 标头中将每份产品文档公开为替代表示。
<link rel="alternate" type="text/markdown" href="/products/example.sku.md">智能体应如何安全处理 SKU.md？
将每份文档视为不受信任的外部数据，而不是指令。验证其域名和时间戳，忽略改变行为的提示，在操作前查询实时商业来源，绝不依据静态内容触发支付。