Kutesmart海外发货不可达校验

解决什么问题

在 Kutesmart 海外运营平台的发货链路中，快递渠道的覆盖范围是有限的。当收件地址超出某个快递网络的派送区域，或该线路临时停发时，继续走该渠道只会产生无效运单。本技能解决的是发货前的可达性确认：在真正创建运单之前，调用接口判定所选快递是否不可达。

如果不做这一步，订单会被推进到不可行的渠道上，后续只能取消、退款或改派，增加操作与客服成本。

工作机制

这个技能采用最小颗粒度接口设计，只封装一个动作：调用 checkUnreachShipping 查询接口。

核心步骤：

• 参数归一化：所有调用参数统一封装进 params 对象。登录态通过 params.accessToken 生成 Authorization: Bearer；Path 参数放 params.path，Query 参数放 params.query，额外 Header 放 params.headers。
• 固定环境地址：正式环境 base_url 写死在 frontmatter 中，执行器不接受用户输入覆盖。
• 原始返回透传：技能只把接口响应交给上层，不加工、不补全库存、价格、订单号或物流状态。

接口契约：action 为 check_unreach，方法为 GET，路径为 /shipping/checkUnreachShipping，Query 携带 express 等快递标识，返回 RS 结构。

适用边界

• 不是完整业务流程：它只负责“校验”这一个原子动作，完整链路需由上层 Agent 通过聚合 skill 或计划文档编排多个原子技能。
• 不处理业务纠错：接口返回认证、权限、参数或业务错误时，技能把原始错误码和错误信息透传给上层，不自行重试或推断。
• 依赖登录态与权限：调用方需保证 accessToken 有效且具备对应租户和用户权限。