Kutesmart 简定制商品详情
将以下提示词粘贴到你的 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 权限或参数问题的技术负责人,需要定位认证和租户约束。