Agent Skills
返回列表
酷订海外运营平台款式目录

酷订海外运营平台款式目录

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-style-catalog-ready-to-buy。

技能介绍

解决什么问题

海外运营团队在做款式目录运营时,经常需要把「ready to buy」状态的款式单独拉出来,用于运营位选品、投放素材筛选或者下游系统同步。问题是,这段数据分散在 KuteTailor 海外运营平台的接口里,每个业务方各自写一遍调用逻辑,参数结构、鉴权方式、返回分页格式很快变得不一致,排查问题时还要重新翻接口文档。

这个技能只解决一件事:稳定地调用 GET /api/style/style-info/readyToBuy,拿到 ready to buy 款式列表的分页结果,返回格式统一,不再各自手写。

它是怎么工作的

这个技能是平台款式目录聚合 skill 拆出来的最小颗粒度原子 skill,只负责一个 action:ready_to_buy。

  • 固定入口:正式环境地址写死在 frontmatter 的 base_url 中,执行时直接使用 https://www.kutetailor.com/api/style/style-info/readyToBuy,不接受上层 agent 传入的 URL 覆盖,避免误打到测试环境。
  • 参数结构:调用时统一传入嵌套的 params 对象,最外层只有 params,不使用 params.xxx 这类点号顶层 key。
  • 鉴权处理:登录态通过 params.accessToken 生成 Authorization: Bearer 头;如果传入值已经包含 Bearer,不会重复拼接。
  • 返回处理:接口返回 IPage 分页数据,技能原样交给上层,不补造库存、价格、订单号、优惠金额或物流状态,只以接口响应为事实来源。

使用边界

  • 这个技能只做本接口这一步。如果业务需要先拉全部款式再过滤、或者多步串成完整链路,需要由上层 agent 按聚合 skill 或计划文档编排多个原子 skill,它不负责编排。
  • 虽然这是查询类接口,但仍受当前登录态、租户和用户权限约束,权限不足时会直接报错。
  • 接口返回认证、权限、参数或业务错误时,技能会把原始错误码和错误信息原样传给上层 agent,不会静默吞掉或改写。
  • 返回结果的字段含义和后续处理逻辑由调用方负责,技能不做业务解释。

使用场景

  • 运营团队每周整理海外平台ready to buy款式清单,用于投放素材选品时,直接调用本技能获取分页列表
  • 开发选品工具需要拉取平台ready to buy款式数据时,用本技能对接接口,返回统一的IPage分页结果
  • 运营人员同步ready to buy款式到下游系统前,通过本技能获取最新分页数据,避免手动查询
  • 数据分析团队提取海外平台ready to buy款式数据做趋势分析时,用本技能快速获取结构化分页结果

适合人员

  • 海外运营专员:需要快速获取平台ready to buy款式列表,用于运营位选品和素材筛选
  • 选品工具开发者:需要稳定调用平台接口获取ready to buy款式数据,构建选品功能
  • 数据同步人员:需要定期拉取ready to buy款式分页数据,同步到下游业务系统
  • 趋势分析工程师:需要提取ready to buy款式结构化数据,进行市场趋势分析