Agent Skills
返回列表
Kutesmart海外平台成品商品详情

Kutesmart海外平台成品商品详情

开发编程 更新于 2026.08.29

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

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

技能介绍

解决什么问题

在对接 Kutesmart 海外运营平台时,获取成品商品的详情或下单页信息是一个高频但底层的接口调用需求。开发者在构建复杂的业务链路(如完整的下单流程)时,往往需要直接面对底层 API 的鉴权、参数拼接和错误处理,这会分散对核心业务逻辑的注意力。

核心能力与关键步骤

@user_ac9585d3/platform-product-detail-finish-detail 作为一个最小颗粒度的原子技能,专门负责调用 finish_detail 动作。

  • 固定环境调用:执行器会严格使用 frontmatter 中配置的正式环境固定地址 GET https://www.kutetailor.com/api/product/product/product/public/selectFinishOrder,拒绝用户输入覆盖 base_url。
  • 参数规范注入:支持通过嵌套的 params 对象传递参数。例如,将 Query 参数(如 id)写入 params.query,Path 参数写入 params.path。
  • 鉴权与请求组装:自动使用 params.accessToken 生成 Authorization: Bearer 请求头,若已包含 Bearer 则不重复拼接。POST/PUT 请求默认发送 JSON body。
  • 事实返回传递:成功时返回 OrderFinishInfoVO 对象,失败时将原始错误码和信息透传给上层 Agent,绝不臆造库存、价格或订单状态。

适用边界与注意点

  • 原子级定位:本技能只完成单个接口的调用。如果需要组合成完整的业务链路(如先查详情再下单),必须由上层 Agent 通过聚合技能或计划文档进行编排。
  • 状态与权限依赖:虽然是查询类接口,但仍严格依赖当前的登录态、租户上下文和用户权限。
  • 数据真实性:所有返回的库存、价格、优惠金额等字段,必须以接口响应为唯一事实来源,禁止在本地进行任何形式的补造或缓存篡改。

使用场景

  • 在开发海外电商下单流程时,需要获取成品商品的 SKU、库存与价格信息,用于渲染下单确认页。
  • 搭建多步下单 Agent 工作流,第一步需要调用该技能拿到 OrderFinishInfoVO,再交给后续库存校验环节。
  • 排查下单页展示异常时,需要单独触发一次成品商品详情查询,核对接口返回的优惠金额与运费是否为最新。
  • 在多租户 SaaS 后台中,需要按当前登录用户权限查询其可见的成品商品详情,避免跨租户数据泄露。

适合人员

  • 负责 Kutesmart 平台对接的后端工程师,需要快速接入成品商品详情查询接口并处理鉴权与错误码。
  • 构建电商下单机器人的 Agent 开发者,需要一个原子技能作为业务链路中的详情获取节点。
  • 维护海外运营平台下单页的前端工程师,需要确认接口返回字段与页面展示数据一致。
  • 负责多租户权限管控的后端工程师,需要验证接口在当前登录态和租户上下文下的返回边界。