酷特海外平台 · 按系列查款式
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-styles-by-series。
技能介绍
要解决什么问题
海外运营里,款式往往按系列组织:上新、选品、对接 ERP 或客服时,需要先拿到「某个 seriesId 下有哪些款式」的分页列表。若 agent 直接拼 URL、混用 Path/Query/Body,或擅自改正式环境地址,很容易踩权限和网关契约问题。
本 skill 是 platform-style-catalog 聚合能力里的原子接口,只负责 styles_by_series 这一动:用固定正式环境 GET /style/style-info/getStylesBySeriesId,把系列维度的款式目录查回来,关键字段交给后续 skill 继续编排。
如何工作
- 触发:用户或上层计划明确「根据系列查询产品 / 款式」时使用;多步业务(登录、详情、下单等)由上层 agent 组合其它原子 skill。
- 参数形态:tool 入参统一为嵌套
params;Query 写params.query(含seriesId及分页/筛选);登录态用params.accessToken生成Authorization: Bearer(值里已有 Bearer 则不重复拼接)。 - 执行约束:
base_url以 skill frontmatter 为准,不接受用户输入覆盖;HTTP 方法与路径按文档固定为 GET。 - 返回:以接口真实响应为准(分页
IPage);不补造库存、价格、订单号等;认证/权限/参数错误原样上抛给上层。
适用边界
- 仅覆盖「按系列查款式」单接口,不包含系列树维护、款式详情、库存或价格计算。
- 仍受租户、用户权限与当前登录态约束;需要完整选品链路时,请配合同聚合下的其它 action 或计划文档编排。
使用场景
- 海外运营 agent 已拿到 seriesId,需要分页拉取该系列下全部款式 SKU 供选品对比
- 上新前按系列核对平台款式列表,与内部 PLM 或 Excel 清单做差异检查
- 客服机器人接到「这个系列有哪些款」咨询,需调用正式环境接口返回可核对的分页结果
- 编排 platform-style-catalog 链路时,作为 styles_by_series 原子步骤写入计划并传递 IPage 关键字段
适合人员
- 负责酷特海外运营平台上架与系列维度的商品运营,需按 seriesId 批量查款式
- 对接 kutetailor.com 开放接口的后端或集成工程师,在 agent 里封装 styles_by_series
- 编写多 skill 编排文档的 agent 设计者,要把「按系列查产品」拆成独立原子调用
- 海外 B2B 选品同事在对话式工具里指定系列编号,需要稳定走正式环境固定地址