Agent Skills
返回列表
Kutesmart 简定制商品详情

Kutesmart 简定制商品详情

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md 的官方安装指南,在 AI 助手中安装规范名为 @user_ac9585d3/platform-product-detail-custom-detail 的技能。

技能介绍

它解决什么问题

简定制商品在下单页要展示详情:库存、价格等信息都来自海外运营平台的一个接口。但这类接口通常是细粒度的,一个完整的下单页可能要串起多个步骤。如果让每个 agent 都从头实现一遍调用逻辑,参数组织、鉴权、错误处理很容易各写各的,维护成本很高。

这个 skill 只做一件事:调用 custom_detail 这个原子动作,取回简定制商品详情/下单页详情,把结果交给上层 agent。

它如何工作

  • 固定入口:正式环境地址写在 frontmatter 的 base_url 中,固定为 GET https://www.kutetailor.com/api/product/product/product/public/selectProductOrden,执行时不接受用户输入覆盖。
  • 参数组织:所有 tool arguments 统一放进嵌套的 params 对象。Path 参数写 params.path,Query 参数写 params.query,JSON Body 写 params.body,额外 Header 写 params.headers。最外层只放 params,不要用 params.xxx 这类点号顶层 key。
  • 鉴权:登录态接口用 params.accessToken 生成 Authorization: Bearer;如果传入值已包含 Bearer,不再重复拼接。
  • 请求约定:custom_detail 使用 GET,查询参数 id 放在 URL query,返回 OrderProductVO。POST/PUT 默认发送 JSON body;若上层接口网关另有约定,以网关契约为准。
  • 职责边界:当用户需求需要多个接口步骤时,本 skill 只完成自己这一跳,并把关键返回字段交给后续 skill,由上层 agent 按聚合 skill(platform-product-detail)或计划文档编排。

适用边界与注意点

  • 即使这是查询/计算类接口,也仍然需要遵守当前的登录态、租户和用户权限。
  • 返回结果必须以接口响应为事实来源,不要补造库存、价格、订单号、优惠金额或物流状态。
  • 如果接口返回认证、权限、参数或业务错误,直接把原始错误码和错误信息透传给上层 agent,不要自行改写。

使用场景

  • 在下单页联调中,需要按商品 id 调用 custom_detail,获取简定制商品的库存和价格等详情并渲染。
  • 当多个接口步骤组合成完整下单链路时,需要由本 skill 单独完成 custom_detail 这一跳并把返回字段交给后续步骤。
  • 排查 selectProductOrden 接口的认证、权限或参数错误时,需要透传原始错误码和错误信息给上层 agent。
  • 在聚合 skill platform-product-detail 的编排文档中,需要将本技能作为原子动作接入简定制商品详情流程。

适合人员

  • 负责 Kutesmart 海外运营平台下单页开发的工程师,需要按规范调用 custom_detail 并处理返回结构。
  • 设计多接口业务链路的 agent 开发者,需要将原子 skill 组合成完整下单流程。
  • 联调商品详情与库存价格数据的后端工程师,需要核对接口返回和错误透传。
  • 排查 selectProductOrden 权限或参数问题的技术负责人,需要定位认证和租户约束。