Agent Skills
返回列表
酷特海外平台简定制详情

酷特海外平台简定制详情

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-style-catalog-design-detail。

技能介绍

要解决什么问题

在海外运营平台的款式目录链路里,业务方或上层 Agent 往往只需要一步:根据款式标识拉取简定制详情,而不是自己拼 URL、鉴权头和 Query 约定。若把多个接口混在一个大而全的工具里,参数形态和错误语义也不一致,编排和回归都会变难。

本技能是最小颗粒度的原子 Skill,只负责 design_detail 这一动作:在固定正式环境基址下发起 GET,用 Query 参数 id 换取 StyleDesignVO。

技能如何工作

  • 固定端点:使用 frontmatter 中的正式环境 base_url,调用路径为 /style-info/getDesignDetail,不接受用户输入覆盖基址。
  • 参数约定:tool arguments 最外层仅包含嵌套的 params;Query 写入 params.query(含 id);需登录态时在 params.accessToken 中传入,执行器生成 Authorization: Bearer(若已含 Bearer 则不重复拼接)。
  • 返回事实:以接口原始响应为准,不向用户或上层补造库存、价格、订单号、优惠或物流等字段。
  • 错误上抛:认证、权限、参数或业务错误时,保留原始错误码与错误信息,交给后续 Skill 或聚合层处理。

适用边界

  • 用户若需要「查目录 + 详情 + 下单」等多步流程,本 Skill 只完成本接口;完整链路应由上层按 platform-style-catalog 等聚合文档编排多个原子 Skill。
  • 这是查询类接口,仍受当前登录态、租户与用户权限约束;无权限时不会本地「降级」为假数据。

使用场景

  • 上层 Agent 已拿到款式 id,需要单独拉取简定制详情(StyleDesignVO)再交给后续下单或展示 Skill
  • 编排 platform-style-catalog 链路时,在列表或筛选步骤之后只执行 design_detail 这一步 HTTP 调用
  • 客服或运营助手根据用户提供的款式编号,查询海外运营平台该款式的简定制配置与展示字段
  • 排查鉴权或参数问题时,需要以固定正式环境地址重放 GET /style-info/getDesignDetail 并原样回传错误

适合人员

  • 负责酷特海外运营平台 OpenAPI 对接、需要按官方 params 约定封装 design_detail 的后端工程师
  • 维护 platform-style-catalog 聚合 Skill、把 design_detail 与其它款式目录原子能力串成业务链路的 Agent 开发者
  • 海外款式运营或商品配置同学,通过对话式 Agent 按 id 核对简定制详情是否与平台一致
  • 集成 kutetailor 正式环境、需在工具层固定 base_url 且禁止用户覆盖域名的平台集成工程师