酷特海外平台款式 Ready to Buy 库存
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-finish-stock。
技能介绍
要解决什么问题
在海外运营场景里,业务侧经常需要知道某个款式是否具备 Ready to Buy 可售库存,而不是只看目录展示或静态资料。人工查后台或拼多个系统入口既慢,也容易和平台侧口径不一致。本技能只做一件事:按 styleId 调用酷特海外运营平台正式环境的 finish stock 查询,把接口返回的库存列表作为事实来源交给上层 agent 或后续步骤使用。
技能如何工作
这是最小颗粒度的原子 skill,对应单一 action:finish_stock。
- 请求:
GET/style-info/finishStock(完整基址见 skill frontmatter 的base_url,执行时固定使用,不可被用户输入覆盖) - 参数:Query 中传
styleId,按 skill 约定写入params.query - 鉴权:登录态接口通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer前缀则不再重复拼接 - 返回:
List形态,表示该款式下的 ready to buy 库存数据
上层若要做「选款 → 查库存 → 下单」等完整链路,需要自行编排本 skill 与同系列的 platform-style-catalog 聚合能力或其它原子接口,本 skill 只负责完成本步 HTTP 调用并把关键字段传出。
适用边界与注意点
- 仅覆盖 finish_stock 这一接口动作;多步骤需求不要指望本 skill 一次做完。
- 工具参数最外层只放
params对象(path / query / body / headers 分槽位),不要用params.xxx这类点号顶层 key。 - 仍以接口响应为准:不要自行补造库存数量、价格、订单号或物流状态。
- 若返回认证、权限、参数或业务错误,应把原始错误码与错误信息原样交给上层 agent 处理。
使用场景
- 用户指定某个款式的 styleId,需要在对话里立刻拉取该款式的 Ready to Buy 现货库存列表
- 编排「选款→查库存→后续下单」链路时,本步只负责调用 finishStock 并把列表结果交给下一步 skill
- 客服或运营确认某海外款式是否具备可售 finish stock,避免仅凭目录页猜测库存
- 上层 agent 收到「查 ready to buy 库存」意图且已有 styleId 时,用本接口替代人工登录后台查询
适合人员
- 负责海外款式上架与可售性核对、需按 styleId 对接平台 finishStock 的运营
- 正在把 platform-style-catalog 拆成原子 skill、需要接入 finish_stock 动作的 agent 集成工程师
- 在对话式工作流里编排多接口步骤、要把库存查询与选款/下单 skill 串联的产品或自动化负责人
- 处理海外客户询盘时、需用正式环境接口核实某款式 Ready to Buy 库存的商务或客服支持