酷特海外平台 Ready to Buy 首页款式数据
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-ready-home。
技能介绍
要解决什么问题
在海外运营场景里,Ready to Buy 首页往往依赖款式目录服务的一屏聚合数据:运营或 agent 需要知道「当前首页该展示哪些可购款式」,而不是自己拼字段或猜库存。若把整站目录、详情、下单混在一个大 skill 里,编排和权限边界都会变糊。
本 skill 只做一件事:按平台契约调用 ready_home,把接口返回的列表当作事实来源交给后续步骤(筛选、详情、下单等由其它原子 skill 或聚合文档编排)。
如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url,不接受用户输入覆盖;路径为GET /style/style-info/readyHome(相对 base 的/style-info/readyHome)。 - 参数约定:tool arguments 最外层仅嵌套
params;需登录时在params.accessToken生成Authorization: Bearer(值已含 Bearer 则不重复拼接)。 - 本 action 无必填 path/query/body:可按上下文传 query 或 headers,以网关实际契约为准。
- 返回:接口定义的 List,即 ready to buy 首页数据;不得补造价格、库存、订单号或物流状态。
边界与注意
- 这是 platform-style-catalog 聚合能力中的原始 action
ready_home;多接口业务链路需由上层 agent 组合多个 skill。 - 认证、权限、参数或业务错误时,应把原始错误码与错误信息原样传给上层,便于重试或换路。
- 仍受当前登录态、租户与用户权限约束;查询类接口也不应绕过权限假设。
使用场景
- 海外运营 agent 编排「先看首页可购款式再查详情」时,先调用 readyHome 拉取当前 Ready to Buy 首页列表。
- 对接酷特 kutetailor 正式环境,在自动化脚本里定期抓取 ready to buy 首页款式,用于与后台配置对账。
- 实现 platform-style-catalog 聚合链路的第一步:仅取 ready_home 返回的 List,再交给筛选或详情 skill 继续处理。
- 客服或内部问答 bot 被问到「首页 Ready to Buy 有哪些款」时,用本接口响应作为唯一数据依据作答。
适合人员
- 负责酷特海外站 Ready to Buy 首页排期的运营,需要用接口核对「线上首页实际返回哪些款式」而非手工截图。
- 为 Kutesmart 平台写多 skill 编排的 agent 工程师,要把 ready_home 作为款式目录链路里的固定原子步骤接入。
- 维护 kutetailor.com 对接工具的后端开发,只需单一 GET 动作获取 readyHome 列表并写入监控或报表。
- 做海外定制/成衣业务的数据或商品同学,在权限范围内用登录态拉首页款式清单做选品分析输入。