酷特海外运营款式成品库存查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-style-finish-stock。
技能介绍
要解决什么问题
海外运营里,款式目录和履约往往拆成多步:先锁定 styleId,再查成品仓里还能卖多少。人工在运营后台翻页或让 agent 乱猜库存,既慢也容易和平台真实数据不一致。本技能只做一件事——按款式查询成品库存,把接口返回当作事实来源,交给后续定价、补货或下单类 skill 继续编排。
技能如何工作
执行器固定走正式环境 GET /style/style-info/getStyleFinishStock,不接受用户改写 base_url。调用时 tool arguments 最外层只包一层 params:
- Query:
styleId写入params.query - 登录态:
params.accessToken生成Authorization: Bearer …(若已带Bearer则不重复拼接) - 其它 Path / Body / Header 按网关约定分别放进
params.path、params.body、params.headers
对应 action 为 style_finish_stock。返回字段以 RS 响应为准;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上层 agent 透传,而不是本地补造库存数量或订单状态。
适用边界
这是 platform-style-catalog 聚合能力里的最小颗粒度原子 skill。用户一句话里若还涉及款式列表、价格、订单创建等多接口流程,本技能只完成库存查询这一步,完整链路需由上层 agent 按聚合文档或其它原子 skill 组合。查询类接口仍受租户、用户权限与当前登录态约束。
使用场景
- 海外运营 agent 已拿到款式 `styleId`,需在下单或补货前核对平台成品仓可售数量
- 编排 `platform-style-catalog` 链路时,在款式详情之后单独调用库存接口,避免与其它款式列表接口混在一次请求里
- 客服或履约同事根据客户指定款号,让 agent 只查成品库存并把 RS 原始字段交给后续定价 skill
- 接口返回权限或参数错误时,需要把平台错误码透传给上层 agent,而不是在对话里编造库存数
适合人员
- 负责酷特海外运营平台款式目录对接、需在 agent 里按款查仓存的后端或集成工程师
- 编写多步业务计划的 agent 编排者,需要把 `style_finish_stock` 作为原子步骤插入履约前校验
- 海外客服或供应链同事,经常要根据客户款号确认成品是否还有可发库存
- 维护 `platform-style-catalog` 聚合 skill 文档的平台架构或业务中台同学