SKU.md 不是商品 Feed：为什么我们故意不放实时库存和交易状态
v1.0.0 专题
用职责边界说明商品知识、商业 Feed 与交易系统的差异，以及为什么静态 Markdown 不应承载持续变化的报价。
当前状态： 本文依据当前 v1.0.0-beta 边界撰写，只陈述方法和证据要求，不把尚未验证的平台采用、排名、引用、推荐或销售结果写成事实。
让 SKU.md 迅速失去可信度的最简单方式，就是把它当成更新较慢的商品 Feed。Markdown 文件看起来仍然正式，却可能保留昨天的库存、已经结束的优惠或不再成立的配送承诺。更稳妥的设计是把产品含义、变化中的报价和交易决策分开。
三个层次回答三个不同问题
知识层回答“这是什么产品，在什么条件下适合使用”；Feed 回答“外部渠道要接收哪些商业字段”；交易系统回答“这位用户此刻能否在当前市场以当前价格购买这个变体”。把三者合在一个文件里，会让文档比审核流程更快过期。
| 层次 | 典型内容 | 变化速度 | 权威来源 |
|---|---|---|---|
| 商品知识 | 事实、建议、限制、兼容性、标识符、来源 | 低 | 商家审核的文档 |
| 商品 Feed | 报价字段、可售快照、渠道属性 | 中到高 | Feed 管道或平台目录 |
| 交易系统 | 可执行价格、库存分配、税费、配送、支付、订单状态 | 实时 | 商业后端 |
“参考值”也必须说明存在理由
把一个数值称为“参考价格”或“大致库存”，并不会自动消除误解。用户和 Agent 仍可能把它当成当前报价。只在足够新鲜时才有意义的商业字段，应由能够同时说明时间、市场、币种和失败状态的实时接口负责。
SKU.md 可以链接公开商品页或实时服务，但稳定文档只负责解释何时交接。遇到价格或库存问题时，消费者应要求实时来源，而不是复述静态 Markdown。
职责分离让失败更容易处理
描述性事实缺失时，可以保留未知并继续追问；Feed 延迟时，可以报告数据陈旧；结账失败时，商业系统可以返回当前原因。三类失败的恢复方式不同，一个文件无法在不丢失差异的情况下同时表达。
审核也因此更有意义。商家可以独立检查某条限制是否准确，不必把每小时变化的库存加入同一轮评审；运营团队更换定价系统时，也无需重写商品使用建议。
建立字段权威矩阵
为每个字段写明允许回答它的系统，以及可以接受的最大数据年龄。某一型号的尺寸可能长期稳定，兼容性可能随着固件支持变化，库存只在很短时间内有效，送达时间还取决于地址。这个矩阵应同时控制发布流程和 Agent 行为。
如果两个系统发生冲突，消费者不能静默合并。它应保留来源，为当前问题选择指定权威，并在冲突影响推荐时明确说明。
哪些内容适合进入 SKU.md
材料、尺寸、适用场景、明确排除条件、兼容要求、保养方式、型号标识符和来源链接都很合适。Updated 表示知识文档何时修改，并不保证库存新鲜。
可执行价格、库存、折扣、配送预计、税费、支付可用性、结账和订单状态应留在实时系统。只要 Agent 知道何时跳转，一个链接就足够。
发布前的逐句检查
检查文件中的每条陈述：“普通用户会不会把它理解为购买瞬间仍然成立？”如果答案依赖时间、市场、客户、地址或剩余数量，就把它移交给实时权威。最终文档会更短、更耐久，也更适合被引用。
同一件商品处在三种时间尺度里
以一盏充电露营灯为例。防水等级、接口、尺寸和“不可水下使用”的限制可能数月不变；渠道 Feed 中的价格、促销文案和地区可售性可能每天变化；结账时的库存预占、税费和配送承诺可能在几秒内变化。如果把三类信息塞进同一个静态文档，整份知识都被迫按照最快的字段刷新，而且缓存稍有延迟就会误导购买。
正确的分工是：SKU.md 保存经审核的商品含义并链接来源；Feed 按渠道要求分发报价；交易系统在最后时刻确认是否可买。Agent 可以组合三层信息，但必须保留每条信息来自哪里、何时确认，不能把不同时间的值压平成一个看似“当前”的记录。
混在一起会产生哪些故障
第一类是过期的确定性：最后一件商品已经被预占，缓存文件仍写着“有货”。第二类是市场混淆：一个地区含税的价格被当成所有市场的通用价格。第三类是政策漂移：承运商或截单时间改变后，旧配送承诺仍留在知识文件中。这些不是格式错误，而是权威边界错误。
更新频率不同也意味着流程不应耦合。若每次库存变化都要生成、审核、部署并清除整个知识图，稳定知识会被大量噪声淹没；若让慢速内容审核承担交易状态，顾客又会看到旧答案。把系统拆开，才能分别为准确性、时效性和责任人设定合适的标准。
设计清楚的实时交接
当问题涉及用途、兼容性、限制、标识符或稳定事实时，Agent 可以依据 SKU.md 回答并附上来源；涉及当前价格、库存、税费、配送、支付或订单时，应调用或打开权威商业系统。混合问题可以分两步：先确认产品是否适合，再确认指定变体此刻能否购买。
交接时应携带已解析的商品和变体标识、市场、数量，以及仍需确认的事实，不应携带推测出来的价格或库存。这样，商家既能改善 AI 对商品的理解，又不会把一份可审阅的静态知识文件变成脆弱的交易缓存。
用四个问题判断字段归属
增加字段前先问：谁是权威来源、变化有多快、缓存错误会造成什么后果、决策时由哪个接口确认。经审核的材质组成属于知识层；可能导致下单失败的库存数属于库存服务。稳定标识符可以进入知识文件，但引用该标识符的渠道报价仍是渠道数据。
这套问题也决定缓存策略。稳定知识可以正常缓存并带更新时间；实时调用要有独立的新鲜度与故障规则。商业服务暂时不可用时，Agent 仍可解释适配性，但不能把故障推断成“有货”或“可购买”。