海外运营平台订单面料单耗查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-progress-fabric-usage-by-order-no。
技能介绍
要解决什么问题
在海外定制/成衣运营里,面料单耗往往和订单号绑在一起:排产、核料、对账或客服答复「这单用了多少布」时,都需要从酷特海外运营平台拉取权威数据。手工登录后台查单既慢,也容易和自动化流程脱节。本技能把「按订单号查面料单耗」收敛成一次可编排的 GET 调用,适合被上层 agent 嵌进更长的订单进度链路。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境
base_url,路径为/order/orden-fabric-usage/selectByOrdenNo,不接受用户输入覆盖域名。 - 动作标识:
fabric_usage_by_order_no,HTTP 方法为 GET。 - 入参约定:tool 参数统一放在嵌套的
params对象里;本接口在params.query中传ordenNo(订单号)。若接口需登录态,通过params.accessToken生成Authorization: Bearer(已带Bearer前缀则不重复拼接)。 - 返回原则:以接口原始响应为准,不补造库存、价格、物流等字段;认证、权限或业务错误时,把错误码与信息交给上层 agent 处理。
适用边界
这是 platform-order-progress 聚合能力下的原子 skill,只完成「查面料单耗」这一步。若用户还要查物流、工序或其它订单维度,需要由上层按文档组合多个原子 skill。查询类接口仍受租户、用户权限与当前登录态约束。
使用场景
- 海外客服拿到客户提供的订单号,需从酷特运营平台查询该单面料单耗后再答复核料或用量疑问。
- 上层订单进度 agent 已解析出 `ordenNo`,下一步自动调用本接口拉取面料单耗供排产或对账 skill 使用。
- 运营复盘单笔海外订单时,按订单号请求 `selectByOrdenNo`,用接口返回的单耗与内部记录逐项比对。
- 在 platform-order-progress 文档定义的链路里,仅需完成「根据订单号查面料单耗」这一 GET 步骤时触发本 skill。
适合人员
- 处理海外定制订单咨询、需凭订单号在系统里核对面料用量的客服或驻场运营。
- 把酷特 kutetailor 正式环境接口编排进 agent,并遵守 `params.query.ordenNo` 约定的集成或后端工程师。
- 按单跟进物料与排产计划,要把订单号对应的面料单耗纳入核对清单的计划或物料协调人员。
- 维护 platform-order-progress 聚合能力、负责拆分与组合 `fabric_usage_by_order_no` 等原子 skill 的 Agent 编排者。