海外运营平台 Ready to Buy 款式列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-ready-to-buy。
技能介绍
要解决什么问题
在海外运营平台里,「ready to buy」款式目录往往只是完整业务链路中的一环:用户要查可直购款式分页列表,但上层 agent 还可能要接着做详情、下单或库存校验。若把多个 HTTP 步骤揉进一个巨型 skill,参数约定和错误语义会混在一起,不利于编排与回放。
本技能是 platform-style-catalog 聚合下的原子接口 skill,只负责 readytobuy 这一动作:对正式环境固定地址发起 GET /style-info/readyToBuy,把分页结果交给后续 skill 或计划文档继续处理。
技能如何工作
- 固定基址:执行器使用 frontmatter 中的
base_url(正式环境https://www.kutetailor.com/api/style),不接受用户输入覆盖。 - 统一参数壳:tool arguments 最外层仅
params;Path →params.path,Query →params.query(本接口为 ParamToBuyVO),Body →params.body,额外 Header →params.headers。 - 登录态:需登录时在
params.accessToken生成Authorization: Bearer;值已含Bearer则不再拼接。 - 返回事实:以接口响应为准构造
IPage列表;不补造库存、价格、订单号、优惠或物流状态。认证、权限、参数或业务错误时,原样传递错误码与信息给上层 agent。
适用边界
- 用户需求若涉及多接口步骤,本 skill 只完成本 GET;其余步骤由上层按聚合 skill 或
doc/skill/platform-style-catalog/SKILL.md编排。 - 仍受当前登录态、租户与用户权限约束;查询类接口不代表已下单或已锁库存。
使用场景
- 海外运营同事要在对话里先拉取可直购款式分页列表,再交给后续 skill 查详情或比价
- 上层 agent 按 platform-style-catalog 计划编排时,需要单独执行 ready_to_buy 这一步 GET
- 客服或运营核对「哪些款式处于 ready to buy」时,用 ParamToBuyVO 条件查询正式环境列表
- 集成测试验证登录态与租户权限下,readyToBuy 接口能否返回预期 IPage 字段
适合人员
- 负责酷特海外运营平台款式上架与可购状态维护的品类/运营同学
- 把 platform-style-catalog 拆成多个原子 skill 编排的 Agent 或后端集成工程师
- 需要在正式环境用 accessToken 拉 ready to buy 列表做对账或巡检的数据/业务分析同事
- 为海外站选款或补货前,要先拿到可直购款式分页结果的采购或商品规划人员