酷特海外平台成品详情与订单编辑
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-finish-detail。
技能介绍
要解决什么问题
在海外运营平台的款式目录链路里,编辑订单或核对成品信息时,往往需要一份与当前款式绑定的成品详情,以及在编辑场景下对应的订单详情。若由上层 Agent 自行拼 URL、猜 query 字段或改写 base_url,很容易打到错误环境,或在返回里「补全」库存、价格、物流等字段,导致后续步骤基于错误事实决策。
技能如何工作
本 skill 是原子接口 skill,只负责 finish_detail 这一动作:对正式环境固定地址发起 GET /style-info/getFinishDetail,查询参数通过 params.query 传入,通常包括必填的 id(款式/成品标识)和可选的 ordenId(编辑订单上下文)。
调用约定与其它酷特平台原子 skill 一致:
- 工具参数最外层仅使用嵌套的
params,分别承载path、query、body、headers - 登录态通过
params.accessToken生成Authorization: Bearer …(已含Bearer时不重复拼接) - 执行器使用 frontmatter 中的固定正式环境
base_url,不接受用户输入覆盖
成功时返回以接口为准的 StyleFinishVO;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent 编排重试或换路。
适用边界
- 只完成单次成品详情查询;完整「目录浏览 → 下单 → 改单」需由上层按聚合 skill
platform-style-catalog或计划文档串联多个原子 skill。 - 返回内容必须视为接口响应的事实来源,不要在本 skill 层补造库存、价格、订单号、优惠金额或物流状态。
使用场景
- 用户在海外运营平台打开某款式的编辑订单页,Agent 需用款式 id 与 ordenId 拉取 StyleFinishVO 再展示字段
- 编排 platform-style-catalog 链路时,在改单前单独调用 finish_detail,避免上层自行拼 GET 查询参数
- 客服核对「这款成品在待改订单里显示什么」时,只查 getFinishDetail 并以接口返回为准回答
- 自动化脚本在确认是否允许继续改单前,先 GET 成品详情及关联订单详情做权限与数据校验
适合人员
- 负责酷特海外运营平台改单、对账的运营,需要按款式 id 精确查到成品与订单详情
- 对接 kutetailor.com 款式目录 API 的集成工程师,要把 finish_detail 作为原子 skill 编入 Agent 计划
- 维护 platform-style-catalog 聚合 skill 的维护者,需要在文档链路里明确 finish_detail 的触发与参数约定
- 为业务 Agent 编写改单前校验逻辑的开发者,要求错误码与 StyleFinishVO 原样上抛、不补造字段