技能介绍

这个技能解决的问题

当你手里只有一串物流单号，却需要确认某个海外运营平台里的物流状态时，最常见的做法是打开后台、复制单号、切换页面、再人工判读。对于需要批量或自动化处理的 Agent 来说，这会把一次简单查询变成多步人肉操作，而且中间还可能因为登录态、租户、权限或参数拼装不一致而出错。

kutesmart-海外运营平台物流查询-根据物流单号查询物流信息 只做一件事：根据物流单号调用平台接口，拿到该接口返回的物流信息，并把关键结果交给上层 Agent 继续使用。

核心能力与关键步骤

这个 skill 是最小颗粒度接口 skill，action 固定为 shipping_by_code，正式环境地址固定为 GET https://www.kutetailor.com/api/shipping/shipping/getShippingOne。调用时不需要从用户输入覆盖 base_url，也不要把地址改成其他环境。

执行时需要注意以下约定：

参数统一放嵌套对象：最外层只放 params，不要使用 params.xxx 这类点号顶层 key。
按接口位置传参：Path 参数写入 params.path，Query 参数写入 params.query，JSON Body 写入 params.body，额外 Header 写入 params.headers。
本接口为 GET 查询：shipping_by_code 的 Query 参数是 code，也就是物流单号；不要给它塞 body 或凭空增加参数。
登录态要正确拼接：如果上游已经提供带 Bearer 的 token，就不要重复拼接；需要拼接时使用 params.accessToken 生成 Authorization: Bearer。
返回值必须忠于接口响应：接口没有返回的库存、价格、订单号、优惠金额或物流状态不要补造。

适用边界与注意点

这个 skill 只负责单个平台接口动作，不包含登录、下单、取消、退款、批量导入或跨系统编排。如果你的业务需要多个接口步骤，应由上层 Agent 按聚合 skill 或计划文档把多个原子 skill 串起来；本 skill 只完成自己的接口调用，并把关键返回字段交给后续 skill。

同时，它仍然遵循当前登录态、租户和用户权限。如果接口返回认证失败、权限不足、参数错误或业务错误，应把原始错误码和错误信息原样传给上层 Agent，而不是自行降级或猜测成功。适合使用它的场景很明确：输入是物流单号，目标是通过 shipping_by_code 拿到平台接口返回的物流信息，并把结果作为后续处理的事实来源。