海外运营平台按品类查询订单尺寸
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-size-by-category。
技能介绍
要解决什么问题
在海外运营平台的订单履约与生产排程里,同一笔订单往往包含多个品类,各品类的裁片尺寸、规格明细分散在平台侧接口中。业务同学或上层 agent 若需要「只看某一品类下的尺寸清单」,不应手写 URL、拼 query,也不应在对话里猜测 ordenId 与品类参数的传递方式。
本技能对应平台原子动作 order_size_by_category:对正式环境固定路径发起 GET 查询,把接口原始响应作为事实来源交给后续编排。
技能如何工作
- 固定调用:
GET https://www.kutetailor.com/api/order/order/orden-size/getOrdenSizeByCategoryList(base_url来自技能 frontmatter,不可由用户输入覆盖)。 - 工具参数统一放在顶层
params对象内:Query 写入params.query(含ordenId、品类相关字段),登录态用params.accessToken生成Authorization: Bearer(已带Bearer则不重复拼接)。 - 返回字段以平台
RS>响应为准;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,便于聚合 skill 或计划文档做重试、换步或人工介入。
适用边界与注意点
这是最小颗粒度接口 skill,只完成本接口一步。若用户需求涉及订单组成、物流、价格等多接口链路,应由上层 agent 引用 platform-order-components 等聚合技能按文档编排多个原子 skill。
查询类接口仍受当前登录态、租户与用户权限约束;不要根据对话内容补造库存、价格、订单号或物流状态。
使用场景
- 海外运营 agent 已拿到 `ordenId`,需要只拉取某一品类下的裁片/尺寸明细再交给排产或核价步骤。
- 多品类订单核对时,业务人员要对照平台返回的尺寸清单,确认该品类规格是否与下单一致。
- 编排 `platform-order-components` 链路时,上层计划把「按品类查尺寸」作为单独一步,避免与其它订单接口混参。
- 客服或履约同事根据订单号与品类筛选,查询平台侧尺寸组成用于异常工单说明。
适合人员
- 负责酷特海外运营平台订单履约、需在对话或 agent 中按品类核对尺寸的运营专员
- 将 `platform-order-components` 拆成多个原子 skill 对接的生产系统或内部工具工程师
- 为裁切/缝制排程准备数据、要从平台接口拉订单品类尺寸的生产计划人员
- 搭建企业运营类 agent、需要准确映射 `order_size_by_category` 参数与鉴权方式的集成开发者