KuteSmart 已上架商品品类查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-product-browse-all-categories。
技能介绍
要解决的问题
海外运营平台的商品体系里,品类数据是商品浏览、搜索、筛选等多个上层能力的共同依赖。业务侧需要拿到「已上架的简定制 / 成品」这部分品类时,常规做法是在宿主系统里硬写一段请求 https://www.kutetailor.com/api/product/product/product/selectAllCategory,把 HTTP 方法、登录态拼接、错误处理、返回字段解析全部内联进业务逻辑。结果是每条用到品类的链路都要各自维护一份调用代码,接口地址变更或鉴权方式调整时,改动散落各处。
技能如何工作
这个技能把 all_categories 这一个动作单独封装成最小颗粒度的原子 skill,只做一件事:按约定发起 GET 请求并返回品类列表。
- 固定环境地址:正式环境地址写在 frontmatter 的
base_url中,执行器不接受用户输入覆盖。 - 统一参数结构:所有 tool arguments 收敛到一个嵌套的
params对象,最外层不再出现params.xxx这类点号顶层 key。 - 按位置归位:
params.path承载路径变量,params.query承载查询参数,params.body承载 JSON Body,params.headers承载额外请求头。 - 登录态透传:通过
params.accessToken生成Authorization: Bearer;若传入值已包含Bearer,执行器不会重复拼接。 - 契约约束:C 站调用需在 Header/Query 中带
source和originSign;POST/PUT 默认发送 JSON body,若上层网关另有约定则以网关契约为准。
调用完成后,技能把接口原始返回交给上层 agent。如果完整业务链路需要多个接口步骤,由上层 agent 按聚合 skill(platform-product-browse)或计划文档编排多个原子 skill,本技能只负责自己的这一步。
适用边界与注意点
- 只读动作:本技能是查询类接口,不会创建、修改或删除任何数据。
- 不做字段兜底:返回结果以接口响应为唯一事实来源,技能不会补造库存、价格、订单号、优惠金额或物流状态等响应中不存在的信息。
- 错误原样透传:遇到认证、权限、参数或业务错误时,把原始错误码和错误信息原样传给上层 agent,不自行吞掉或猜测成功。
- 仍需权限校验:即使是查询类接口,也必须遵守当前登录态、租户和用户权限,token 失效或越权同样会返回错误。
使用场景
- 海外运营平台的开发者编写商品浏览页,需要在前端分类筛选里渲染已上架的简定制和成品品类列表。
- AI agent 编排工程师正在串一条多步业务链路,当前步骤要先取品类列表,再把返回交给后续的商品查询或列表筛选步骤。
- 品类运营需要核对简定制和成品的上架品类范围,确认平台分类与商品发布使用的分类是否一致。
- 平台开发者在封装商品相关原子能力,需要把固定正式环境地址和正确的 Authorization 头格式固化进执行器。
适合人员
- 海外运营平台的前端或后端工程师,需要在商品浏览与搜索功能中接入已上架品类数据。
- AI agent 编排工程师,负责把品类查询作为原子步骤嵌入多接口业务链路并约定字段交接。
- 品类运营或商品运营专员,需要获取并核对简定制、成品的上架品类清单。
- 平台基础设施开发者,需要为下游业务方封装固定环境地址和登录态传递规则。