技能介绍

解决的具体问题

在 KuteSmart 海外运营平台的发货管理链路中，很多自动化流程会先需要读取当前账号可用的发货地址列表。若用临时 prompt 拼 HTTP 调用，容易出现 base_url 被用户输入覆盖、accessToken 重复加 Bearer、查询参数和请求体位置不一致，以及把接口没返回的物流状态、订单号、优惠金额补写进结果等问题。该 skill 把这个问题收敛为一个固定动作：只调用 GET https://www.kutetailor.com/api/shipping/shipping-address，完成 shipping_address_list 接口请求，并把返回的分页地址数据交给上层编排。

技能如何工作

这个 skill 是最小颗粒度接口 skill，不直接完成多步业务闭环，而是作为原子能力被上层 agent 调用。关键步骤包括：

固定正式环境地址：执行器使用 frontmatter 中的 base_url，不从用户输入覆盖，避免把生产请求发到测试或未知域名。
统一参数结构：tool arguments 最外层只放 params，不要把 params.query、params.body 写成点号顶层 key；查询参数放 params.query，Path 放 params.path，请求体放 params.body，额外 Header 放 params.headers。
处理登录态：登录态接口根据 params.accessToken 生成 Authorization: Bearer，如果传入值已经包含 Bearer，不要重复拼接。
保持响应事实来源：接口返回 IPage 分页结构后，skill 只传递关键返回字段；认证、权限、参数或业务错误时，把原始错误码和错误信息交给上层 agent 处理。

适用边界与注意点

适合需要获取 KuteSmart 海外运营平台发货地址列表的查询场景，不适合作为完整发货流程的终点。若业务还要创建订单、选择物流、更新地址或触发发货，应由聚合 skill platform-shipping-manage 或计划文档编排多个原子 skill。使用时仍需满足当前登录态、租户和用户权限；不要基于该 skill 补造库存、价格、订单号、优惠金额或物流状态。