商品详情与库存价格查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-product-detail。
技能介绍
为什么需要这个 skill
商品候选列表接口返回的往往是缩略信息:一张主图、一个名称、一个价格区间。运营或客服真正要回答的问题是“这个商品能下单吗、有哪些颜色和尺码、某个组合还有库存吗、换一种币种是多少”。这些问题散落在多个只读接口上,直接拼请求容易漏参数,尤其是 C 站详情接口要求 source 与 originSign,只传 ctoken 会被拒。
它做什么
这个 skill 只做一件事:把一个商品候选 id 推进到“可以下单的详情摘要”,不写购物车、不提交订单。
- 根据
type分流:简定制调custom_detail(OrderProductVO),成品调finish_detail(OrderFinishInfoVO)。 - 成品按
color+size调product_stock取BigDecimal,库存为 0 时明确拦截,不进入提交流程。 - 需要特定币种时按路径参数调
product_price,拿到retailPrice、taxRate、ifCharge、embroidery。 - 简定制可继续取
product_size的部位尺寸标准,或用switch_position做厘米/英寸单位切换。
推荐流程是线性的:接收候选 → 选 action → 从详情里保留 styleId、category、fabricCode、price、currencySymbol、size 和库存列表 → 按需补价格或尺寸 → 输出可下单摘要交给后续购物车/订单 skill。
注意点
id是商品 id,styleId是款式 id,保存购物车用的是后者,混用会直接失败。- C 站调用必须带
source: C和originSign,不要只依赖ctoken。 - 只读边界很硬:不调用
saveStyleMyCart、saveStyleOrden、submitOrdenList,也不在库存为 0 或缺颜色/尺码时建议提交。 - 后端返回的业务错误原样透传,并提示缺哪个上下文,不伪造
styleId、价格或库存。
使用场景
- 客服收到“这个成品有哪些颜色尺码”,用商品 id 调 finish_detail 拿到颜色尺码库存。
- 运营在加购前要确认某颜色尺码是否有库存,调 product_stock 按 id、color、size 查询。
- 用户要看简定制商品的面料和工艺选项,调 custom_detail 获取 fabricsList、craft、categoryList。
- 需要按指定币种报价时,调 product_price 用 productId 和 currency 取零售价与税率。
适合人员
- 海外运营平台的客服,需要按商品候选快速回答颜色尺码、库存和价格问题。
- 跨境定制业务的运营,要在下单前核对简定制面料、工艺和尺寸标准。
- 负责接入商品只读接口的工程师,需要按 C 站参数约束调用详情与库存价格接口。
- 做成品补货判断的品类运营,需要按颜色尺码核库存并避免零库存提交。