酷订海外运营平台款式目录
将以下提示词粘贴到你的 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款式结构化数据,进行市场趋势分析