海外运营订单发货条件检查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-cancel-confirm-check-shipping-condition。
技能介绍
要解决什么问题
在海外运营平台的撤单确认流程里,业务方往往要先判断一批订单当前是否仍满足发货条件,再决定是否继续撤单或走后续节点。若由上层 Agent 直接拼 HTTP 请求,容易在 base_url、鉴权头、Query 参数命名上与平台契约不一致,也会在接口报错时「脑补」库存或物流状态。
本技能是最小颗粒度的原子接口技能,只负责 check_shipping_condition 这一动作:按订单 ID 查询平台侧是否满足发货条件,并把真实响应交给后续 skill 或编排逻辑。
技能如何工作
- 固定调用正式环境:
GET https://www.kutetailor.com/api/order/order/orden/checkShippingCondition(base_url来自技能 frontmatter,不接受用户输入覆盖)。 - 工具参数统一放在嵌套对象
params中:Query 使用params.query,其中orderIds为必填查询项;登录态通过params.accessToken生成Authorization: Bearer(若已含Bearer则不重复拼接)。 - 执行器按表选择 HTTP 方法与路径,GET 查询参数拼到 URL query;返回以接口响应为唯一事实来源,不补造订单号、价格、库存或物流状态。
- 认证、权限、参数或业务错误时,应把原始错误码与错误信息向上层 Agent 透传,便于聚合 skill
platform-order-cancel-confirm做分支处理。
适用边界与注意点
- 仅覆盖检查是否满足发货条件;完整撤单确认链路需由上层按聚合 skill 或计划文档组合多个原子 skill。
- 属于查询/计算类接口,仍受当前登录态、租户与用户权限约束;多步骤需求时本技能只完成本接口调用,关键字段需交给后续步骤。
使用场景
- 撤单确认前需按 orderIds 批量查询平台是否仍允许发货,再决定是否提交撤单
- 聚合 skill 编排中,在调用撤单接口前先执行发货条件检查并据 RS 分支
- 客服处理海外订单取消工单时,需核对系统返回的发货条件而非人工猜测物流状态
- 接口联调或排障时,用固定 GET 地址验证 accessToken 与 orderIds 参数是否合规
适合人员
- 负责海外运营平台撤单确认链路的运营或实施,需要原子接口 skill 与聚合文档对齐
- 把 platform-order-cancel-confirm 拆成多步的 Agent 编排者,需单独挂载 check_shipping_condition
- 对接 kutetailor.com 订单 API 的后端或集成工程师,要统一 params 嵌套与 Bearer 鉴权约定
- 处理跨境订单异常(撤单、停发)的业务运营,需以接口响应为依据向上级或客户说明