酷特海外运营 · 按品类批量查可用尺寸
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-customer-measurement-cus-size-ready-by-category-list。
技能介绍
要解决什么问题
在海外运营与客户量体流程里,同一客户往往要按多个品类确认「当前能否下单、有哪些可选尺码」。若由 Agent 自行拼 URL 或混用测试/正式地址,容易出现租户权限不一致、查询参数漏传,以及把接口未返回的尺寸当成可用库存。
本技能只做一件事:在正式环境固定基址下,调用 get_cus_size_ready_by_category_list,用 Query 中的 cusId、categoryList 等字段,按品类批量拉取可用尺寸相关结果,并把响应原样交给上层编排。
技能如何工作
- 单一 action:
get_cus_size_ready_by_category_list,HTTP 方法为 GET,路径为/customer-size/getCusSizeReadyByCategoryList(相对base_url)。 - 参数约定:tool 入参最外层仅使用嵌套对象
params;Path 进params.path,Query 进params.query,Body 进params.body,额外 Header 进params.headers。 - 登录态:通过
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀则不再重复拼接。 - 事实来源:返回字段以接口响应为准;不补造库存、价格、订单号或物流状态。认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递。
适用边界与注意点
这是最小颗粒度接口技能,不包含多步量体或下单链路;需要完整业务时,由上层 Agent 参照聚合 skill platform-customer-measurement 或其它计划文档组合多个原子 skill。
base_url 以技能 frontmatter 中的正式环境地址为准,不得用用户输入覆盖。本接口属查询/计算类,仍受当前登录态、租户与用户权限约束;若用户需求超出单次批量查尺寸,本技能只完成本接口调用并把关键字段交给后续步骤。
使用场景
- 海外客服在客户选定多个西装、衬衫品类后,需一次性核对各品类当前可选尺码再回复报价
- 量体顾问在录入客户 cusId 时,按 categoryList 批量拉取平台返回的可用尺寸,避免逐品类手工查后台
- 上层 Agent 编排量体链路时,在本步骤只调用 getCusSizeReadyByCategoryList,把 RS 字段交给后续选码或下单 skill
- 运营排查「某客户某品类无码」工单时,用固定正式环境接口复现 Query 参数与原始错误信息
适合人员
- 负责酷特海外 kutetailor 客户咨询、需在对话中按多品类确认可下单尺码的客服或运营
- 对接 platform-customer-measurement 聚合能力、要把「按品类查可用尺寸」做成原子 tool 的后端或 Agent 集成工程师
- 量体业务产品/实施同学,需要弄清 cusId 与 categoryList 在正式环境接口上的入参与权限边界
- 处理跨境定制订单异常、需要以接口响应为事实来源核对尺码就绪状态而非臆测库存的运营支持