厘米/英寸部位值切换
将以下提示词粘贴到你的 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,需要原子化接口调用能力集成到工作流