Agent Skills
返回列表
厘米/英寸部位值切换

厘米/英寸部位值切换

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-product-detail-switch-position。

技能介绍

要解决的问题

海外运营平台的商品详情里,同一件商品的部位数值会以厘米和英寸两套单位展示。运营人员在不同市场间切换时,需要调用平台接口把某个部位的数值在两种单位之间转换,保证前台展示与商品数据一致。如果每次切换都手工拼参数、调接口、处理返回,链路长且容易出错——尤其当这个动作只是整条业务链路中的一环时。

这个 skill 把“部位值单位切换”收敛成一个最小颗粒度的原子动作:只负责调用 switch_position 这一个接口,不做多余的事。

核心能力与调用步骤

  • 单一职责:正式环境固定调用 GET https://www.kutetailor.com/api/product/product/product/public/switchPosition,base_url 写在 frontmatter 中,执行时不接受用户输入覆盖。
  • 参数约定:tool arguments 统一使用嵌套的 params 对象,最外层只放 params,不使用 params.xxx 这类点号顶层 key。
  • 字段归类:Path 参数写入 params.path,Query 参数写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。
  • 登录态:通过 params.accessToken 生成 Authorization: Bearer;如果传入值已含 Bearer,不要重复拼接。
  • 请求方式:GET/DELETE 的查询参数放在 URL query;POST/PUT 默认发送 JSON body,除非上层网关另有约定。

调用完成后,skill 把接口返回的 List 交给上层 agent。如果还需要库存、价格等其他数据,由上层 agent 按聚合 skill(platform-product-detail)或计划文档继续编排后续原子 skill,而不是在这个 skill 里顺手多做。

适用边界与注意点

  • 这是查询/计算类接口,但仍受当前登录态、租户和用户权限约束,无权限时接口直接报错。
  • 返回结果以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态。
  • 遇到认证、权限、参数或业务错误时,原始错误码和错误信息原样传给上层 agent,由上层决定如何处理。
  • 该动作依赖聚合 skill platform-product-detail 的上下文,单独使用时需确保商品 ID 与转换参数已由上层准备好。

使用场景

  • 跨境电商运营在商品详情页需要将厘米部位值快速切换为英寸展示,适配海外站点销售需求
  • 平台技术团队维护商品详情接口时,需标准化厘米/英寸数值转换的调用流程和参数校验规则
  • 海外仓配人员处理多单位商品库存时,调用该接口获取统一转换后的部位数值进行仓储管理
  • 多语言客服系统处理商品咨询时,通过接口自动转换部位单位数值回答客户尺码疑问

适合人员

  • 跨境电商运营专员:每周处理多单位商品数据,需快速切换展示单位适配不同市场
  • 海外电商平台技术负责人:维护商品详情接口,确保厘米/英寸转换符合业务规范
  • 国际化产品本地化经理:负责多市场商品信息同步,需要接口级单位转换能力
  • AI应用开发者:构建商品数据管理agent,需要原子化接口调用能力集成到工作流