酷特海外运营订单工艺查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-craft。
技能介绍
要解决什么问题
在海外运营平台的订单履约链路里,工艺组成(品类、工序等)往往决定排产、成本与对外说明是否一致。业务同学或上层 Agent 若只有订单号,却拿不到平台侧登记的工艺明细,后续核对、对账或组合其它接口(库存、物流)时容易断链。
本技能对应酷特海外运营平台的最小粒度动作 order_craft:只负责调用正式环境固定地址,把「某张订单的工艺是什么」查清楚,并把接口原始返回交给后续步骤使用。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境
base_url,对应GET https://www.kutetailor.com/api/order/order/orden-craft/getOrdenCraft,调用时不得用用户输入覆盖。 - 参数约定:tool 参数统一放在嵌套对象
params下;本动作为 GET,查询条件(如ordenId、品类/工艺相关字段)写入params.query。 - 登录态:若需鉴权,通过
params.accessToken生成Authorization: Bearer;若值已含Bearer前缀则不再重复拼接。 - 返回原则:以接口响应为唯一事实来源,不补造订单号、价格、库存或物流状态;认证、权限、参数或业务错误时,应把原始错误码与信息向上传递。
适用边界
这是 business-ops 下的原子接口技能,隶属聚合能力 platform-order-components。若用户需求涉及多步(例如先查订单再改状态),应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill;本技能只完成「查询订单工艺」这一步。
使用场景
- 上层 Agent 编排 platform-order-components 链路时,需用 ordenId 调用 getOrdenCraft 拉取该单的工艺组成再走后续接口
- 海外订单履约前,运营或客服要核对平台登记的品类与工序是否与工厂排产说明一致
- 对账或异常工单处理时,仅凭订单号向正式环境查询工艺明细,作为与账单、生产记录的比对依据
- 集成测试海外运营订单模块时,单独验证 order_craft 动作的 Query 参数与 Bearer 鉴权是否符合网关约定
适合人员
- 负责酷特 kutetailor 正式环境订单 API 对接、需在 Agent 里封装 GET 查询的后端集成工程师
- 按聚合 skill 文档把订单组成、工艺、状态等多原子接口串成完整链路的平台实施或解决方案顾问
- 处理海外运营订单异常时,经常要凭 ordenId 查工艺字段再和 ERP/排产系统人工核对的运营或对账专员
- 在 business-ops 类目下维护 Kutesmart 技能包、约束 params 嵌套与 base_url 不可覆盖的技能平台编辑或发布同学