技能介绍

要解决什么问题

海外运营平台的商品详情里，库存与价格往往绑定在「部位」维度上，且同一套数据需要在 厘米（cm） 与 英寸（inch） 两套单位之间展示或换算。人工在后台来回改单位既慢，也容易和前台展示不一致。本技能只负责调用平台已提供的 部位值切换 公开查询接口，把切换后的列表结果交给上层 agent 继续编排（例如刷新详情页、联动 SKU 价格等）。

技能如何工作

固定动作：switch_position，对应 GET /product/product/public/switchPosition。
正式环境：执行器必须使用 frontmatter 中的 base_url（https://www.kutetailor.com/api/product/product/product/public/switchPosition），不允许用用户输入覆盖。
参数约定：tool 参数统一放在嵌套对象 params 里；Query 写入 params.query（含商品 id 及单位/部位相关转换参数）；需登录态时在 params.accessToken 中传 token，生成 Authorization: Bearer（若已含 Bearer 则不重复拼接）。
返回：以接口实际响应为准，类型为 List；不要自行补造库存、价格、订单或物流状态。

适用边界与注意点

这是 最小颗粒度 的原子 skill，只完成一次 switch_position 调用。若用户流程涉及登录、拉详情、改价、下单等多步，应由上层 agent 按聚合 skill platform-product-detail 或计划文档串联多个原子 skill。接口若返回认证、权限、参数或业务错误，应把 原始错误码与错误信息 原样交给上层处理。

截图预览

使用场景

客服或运营 agent 已拿到商品 id，用户要求详情页部位尺寸改为英寸展示，需调用 switchPosition 取切换后的部位列表。
编排 platform-product-detail 时，在展示库存价格前先按 cm/inch 参数调用本接口，再把 List 交给后续刷新详情的 skill。
对接 Kutetailor 正式环境的集成脚本，在批量核对 SKU 部位维度单位前，对单个商品执行一次部位值切换查询。
用户在前台切换「厘米/英寸」后，上层 agent 仅负责本 GET 动作，并将接口原始 List 用于渲染或比对，不自行推算价格。

适合人员

维护 Kutetailor 海外商品详情的运营，需要在 agent 对话里按用户单位偏好拉取切换后的部位与库存展示数据。
编写 platform-product-detail 聚合 skill 的 agent 开发者，要把 switch_position 作为原子步骤接入多接口业务链路。
对接酷特正式环境 API 的后端集成工程师，在商品 id 与转换参数已知时单独验证 switchPosition 返回结构。
负责跨境尺码与部位标注的商品同学，通过 agent 触发接口核对厘米与英寸两套部位值是否与平台一致。