海外返修订单单笔查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-repairs-order-repair-order-one。
技能介绍
问题背景
在海外运营平台的日常开发中,返修订单查询往往不是一个孤立的接口调用,而是一条由多个原子操作组成的业务链路。当上层 Agent 需要获取某笔返修订单的原始数据时,它并不关心接口的鉴权细节、参数拼装规则或响应解析逻辑,只想拿到一份结构清晰、来源可靠的结果。与此同时,平台侧又要求所有查询必须走固定的正式环境地址,参数格式必须统一,返回的错误信息必须原样传递。这种「既要标准化,又要可编排」的矛盾,正是这个技能要解决的问题。
核心工作方式
这个技能只承担一个最小颗粒度的动作:repair_order_one,即根据订单号查询单笔返修订单。调用方式固定为 GET https://www.kutetailor.com/api/order/order/orden/getRepairOrdenOne,查询参数为 ordenNo,返回结果标记为 RS。
参数传递遵循统一的嵌套规范:所有请求参数都封装在 params 对象中,禁止使用 params.xxx 这类点号顶层 key。登录态通过 params.accessToken 生成 Authorization: Bearer,若传入值已包含 Bearer 则不重复拼接。路径参数写入 params.path,查询参数写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。执行器强制使用 frontmatter 中的固定 base_url,不接受用户输入覆盖。
对于查询类接口,技能会严格遵守当前登录态、租户和用户权限,不补造任何库存、价格、订单号或物流状态字段。如果接口返回认证、权限、参数或业务错误,原始错误码和错误信息会原样传给上层 Agent,供后续决策。
适用边界与注意点
这个技能只负责单笔返修订单的查询,不处理多步骤业务流程。当用户需求涉及多个接口调用时,需要由上层 Agent 按聚合 skill 或计划文档编排多个原子技能。它不解析业务含义,不缓存数据,也不做字段映射——返回结果就是接口响应本身,后续加工由消费方负责。
另外,ordenNo 是该接口唯一的查询参数,使用时必须确保传入值与平台侧订单号完全一致,否则可能查不到记录或返回业务错误。由于接口固定在正式环境,开发调试阶段请自行在沙箱或测试环境中验证,不要尝试通过用户输入切换 base_url。
使用场景
- 客服需要按 ordenNo 查询海外返修订单详情,用于处理售后申请
- 上层 Agent 编排返修流程,先调用该接口获取单笔订单基础数据
- 运维排查返修接口报错,需要获取认证或权限相关的原始错误信息
适合人员
- 海外售后客服,需要在工单系统中快速查询返修订单状态
- Agent 开发者,需要将原子接口集成进返修业务编排链路
- 平台运维,需要根据接口错误码定位登录态或租户权限问题