Agent Skills
返回列表
商品详情与库存价格查询

商品详情与库存价格查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 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 站参数约束调用详情与库存价格接口。
  • 做成品补货判断的品类运营,需要按颜色尺码核库存并避免零库存提交。