酷特海外发货合并托管校验
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-manage-check-merge。
技能介绍
要解决什么问题
海外运营发货流程里,同一批或关联订单是否应合并托管,往往取决于平台侧规则与当前单据状态。人工在后台逐单核对成本高,Agent 编排「创建发货 → 校验 → 后续动作」时,也需要在固定节点拿到接口真实结论,而不是猜测库存、物流或优惠结果。
本技能是最小颗粒度的原子接口 skill,只负责 check_merge 这一动作:向酷特正式环境提交发货相关数据,由平台返回是否合并托管的判定。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境地址
POST …/shipping/checkMerge,调用时不得用用户输入覆盖base_url。 - 参数结构:tool arguments 最外层仅包含嵌套的
params;登录态通过params.accessToken生成Authorization: Bearer(已含Bearer则不再拼接);JSON Body 写入params.body,格式为application/json,对应接口要求的 SaveShippingVO。 - 返回处理:以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 Agent,由聚合 skill 或计划文档继续编排其它原子 skill。
适用边界与注意点
- 仅完成「校验是否合并托管」单步;多接口完整链路需由上层按
platform-shipping-manage等聚合能力组合多个原子 skill。 - 属于查询/计算类接口,仍受当前登录态、租户与用户权限约束;不要在本 skill 层补造订单号、价格或物流状态等字段。
使用场景
- Agent 在保存或提交发货单之后、执行后续出库或合单动作之前,需要调用平台接口确认是否应合并托管。
- 对接 kutetailor 正式环境时,向 `POST /shipping/checkMerge` 提交 `SaveShippingVO`,以接口返回 RS 作为是否合并托管的依据。
- 上层按 `platform-shipping-manage` 编排多步发货链路,本 skill 只负责 `check_merge` 一步并把关键字段交给后续原子 skill。
- 海外运营处理关联订单或同一批次发货时,用校验接口替代在后台逐单人工核对合并托管规则。
适合人员
- 对接酷特海外运营平台发货域 API、需在链路中固定插入合并托管校验节点的集成工程师
- 编写 platform-shipping-manage 等聚合编排、需要可复用 `check_merge` 原子能力的 Agent 或技能方案设计者
- 负责跨境/海外发货流程自动化、要在提交前拿到平台侧合并托管判定的运营或流程负责人
- 维护 SaveShippingVO 与 shipping 接口、需排查合并托管相关认证或业务错误的后端开发