C 端分类树查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-product-browse-product-category-tree。
技能介绍
解决的问题
在海外运营平台的C端商品浏览场景中,商品分类树的实时更新直接影响用户导航和商品展示的准确性。手动调用接口查询分类树时,常遇到参数格式混乱、环境地址不固定、认证信息处理繁琐等问题,导致开发效率低且易出错。
工作机制
该技能是最小颗粒度的接口技能,仅负责product_category_tree动作。调用时需遵循固定规则:
- 环境地址:固定使用正式环境地址
GET https://www.kutetailor.com/api/product/product_category/public/{userId}/{type},不接受用户输入覆盖。 - 参数传递:统一使用嵌套
params对象,Path参数userId和type写入params.path。 - 认证处理:登录态通过
params.accessToken生成Authorization: Bearer,若传入值已含Bearer则不重复拼接。 - 结果处理:以接口响应为事实来源,不补造任何数据,错误时传递原始错误码和信息。
适用边界与注意点
该技能仅完成单个接口调用,若业务需求涉及多个步骤,需由上层agent按聚合skill或计划文档编排。返回的分类树数据需符合当前登录态、租户和用户权限,调用前需确认权限范围。
使用场景
- 海外运营人员需要在后台查看当前 C 端类目层级,用于确认商品挂载位置是否与类目结构调整一致。
- 商品录入前,运营要确认目标类目是否仍在展示,按分类树路径选择正确的挂载节点。
- 上层 agent 在编排商品浏览链路时,需要先获取 C 端分类树,再决定后续商品列表的过滤条件。
- 排查前端类目显示问题时,研发需要调用该接口对比当前返回的分类树与线上展示是否一致。
适合人员
- 海外电商平台运营:需要在上架商品前确认 C 端分类树中的类目路径和可用节点。
- 导购或商品中台研发工程师:需要在代码中封装分类树查询接口,先明确调用契约和返回字段。
- 上层 agent 编排者:需要把多个原子接口组合成商品浏览链路,先拿到分类树再决定后续动作。
- 前端或小程序开发者:需要在类目选择器中渲染分类树,先验证接口返回的层级结构。