酷特海外平台成品 MyStyle 列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-ready-to-wear。
技能介绍
要解决什么问题
在海外运营或选款场景里,业务侧往往需要一份成品 mystyle 款式目录:分页、可筛选,且数据必须来自平台正式接口,而不是模型臆造库存或款式字段。本技能只做一件事:调用酷特海外运营平台的 ready_to_wear 查询接口,把分页结果原样交给上层 agent 做编排。
技能如何工作
- 固定环境:执行器使用 frontmatter 中的正式环境
base_url(GET …/api/style/style-info/readyToWear),不允许用用户输入覆盖。 - 单一 action:
ready_to_wear,HTTP GET,Query 参数按 ParamToBuyVO 写入params.query。 - 参数约定:tool 顶层只放
params;Path / Query / Body / 额外 Header 分别进params.path、params.query、params.body、params.headers。 - 登录态:需要时在
params.accessToken生成Authorization: Bearer …(已含Bearer则不重复拼接)。 - 返回:接口声明为 IPage 分页结构;以响应体为事实来源,不补造价格、库存、订单号等。
适用边界与注意点
这是 platform-style-catalog 聚合链路里的原子技能(原始 action:ready_to_wear)。若用户要「登录 → 多表关联 → 下单」等完整流程,应由上层 agent 组合多个原子 skill 或按计划文档编排;本 skill 只完成本接口调用,并把关键字段交给后续步骤。认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,便于排查。
使用场景
- 海外选款会上需要按筛选条件拉取成品 mystyle 分页列表,供对比 SKU 与款式属性
- Agent 编排款式目录链路时,只需完成 ready_to_wear 一步并把 IPage 交给下游做详情或下单
- 运营后台对接 kutetailor 正式环境,用 ParamToBuyVO 查询可售成品款式而非手写静态表
- 排查「列表为空或字段不对」时,用固定 GET 接口复现请求并对照平台原始错误码
适合人员
- 负责酷特海外运营平台对接的后端,需要原子化调用 readyToWear 并统一 params 传参
- 搭建多 skill 选款/下单链路的 Agent 工程师,要把成品 mystyle 列表作为 catalog 聚合中的一环
- 海外 merchandising 或买手助理,需在对话里按条件查成品款式目录且结果以接口为准
- 维护 platform-style-catalog 文档与聚合 skill 的平台同学,需对齐 ready_to_wear 的边界与返回字段