酷特海外运营款式目录
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog。
技能介绍
要解决什么问题
在海外运营场景里,业务侧往往需要从系列 / 款式视角查目录,而不是只按 SKU 或商品 ID 翻列表。酷特海外平台的 style 模块提供 new arrival、ready to buy、简定制与成品等多条查询链路;若与 platform-product-browse 的商品视角混用,还容易把 style id 和 product id 当成同一套标识。
本技能面向只读查询:固定根地址 https://www.kutetailor.com/api/style,统一用嵌套 params 传参,在候选结果里保留 styleId/id、styleNo/code、类型、品类、系列、价格、图片与库存摘要,便于交给后续下单或商品类 skill 时标明字段来源。
核心能力与推荐流程
动作覆盖分页新品、全系列列表、按系列查款式、ready to buy / ready to wear 首页与列表、成品与简定制详情、库存及批量图片、标签与 C 站简定制品类等接口。
- 按系列找款:先
all_series,再styles_by_series。 - 找现货成品:优先
ready_home或ready_to_buy。 - 看详情:成品用
finish_detail,简定制用design_detail。 - 下单前查库存:
finish_stock或style_finish_stock。 - 补图:
style_images批量拉取产品 URL。
查询内部款式接口时建议携带 Authorization: Bearer。
边界与注意点
这是只读 skill:不调用款式导入、上下架、图像搜索重建等维护接口(如 /style-import/*、addProductImageSearch、updateProductImageSearch),也不修改款式、库存、标签或图片。最外层 tool arguments 只能放 params;与商品浏览 skill 互补时,务必区分 style 与 product 两套 ID。
使用场景
- 海外站点要做 seasonal 专题页,需先拉全量已上架系列,再按 seriesId 分页筛款式候选
- 客服接到「现货能不能发」咨询,需在用户给出 styleId 后查 ready to buy 或成品库存接口再答复
- 用户从 new arrival 列表点进某款,Agent 需区分成品与简定制并分别调 finish_detail 或 design_detail
- 商品详情页缺主图,已有款式 id 列表,需批量调 listProductUrl 补齐展示 URL
适合人员
- 负责 Kutetailor 海外 C 站选品与专题运营、需按系列而非 SKU 组织款式的运营
- 对接酷特 style 模块、在 Agent 里封装 params 与 Bearer 鉴权的后端或集成工程师
- 处理海外订单与现货承诺、需查成品库存摘要后再转下单流程的客服或订单支持
- 与 platform-product-browse 联调、需明确 styleId 与 productId 来源的电商中台开发