Agent Skills
返回列表
酷特海外平台 · 按系列查款式

酷特海外平台 · 按系列查款式

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 选品同事在对话式工具里指定系列编号,需要稳定走正式环境固定地址