Agent Skills
返回列表
酷特海外平台成品详情与订单编辑

酷特海外平台成品详情与订单编辑

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 原样上抛、不补造字段