酷特海外运营 C 端分类树
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-product-browse-product-category-tree。
技能介绍
要解决什么问题
在海外运营场景里,商品浏览、搜索和筛选往往依赖统一的 C 端分类树:前端导航、按类目聚合、以及后续按类目拉列表,都需要先拿到树形结构。若每个 Agent 各自拼 URL、混用 Path/Query 或改写正式环境地址,很容易出现鉴权不一致、环境串用或字段臆造。
本技能是最小颗粒度的原子接口封装,只负责 product_category_tree 这一动作:向固定正式环境发起查询,并把接口原始响应交给上层编排。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境
base_url,调用GET /product_category/public/{userId}/{type},完整路径为https://www.kutetailor.com/api/product/product_category/public/{userId}/{type};不接受用户输入覆盖base_url。 - 参数约定:tool arguments 最外层仅包含嵌套对象
params;Path 变量userId、type写入params.path;需要登录态时通过params.accessToken生成Authorization: Bearer(若已含Bearer则不重复拼接);额外 Header 放在params.headers。 - 返回原则:以接口响应为唯一事实来源,不补造库存、价格、订单号等字段;认证、权限、参数或业务错误时,将原始错误码与错误信息向上传递。
需要「分类树 + 列表 + 详情」等多步链路时,由上层 Agent 按聚合 skill platform-product-browse 或计划文档组合多个原子 skill;本技能只完成分类树查询这一步。
适用边界与注意点
- 属于查询类接口,仍受当前登录态、租户与用户权限约束;无权限时按接口错误如实上报。
- 若用户需求超出单次
GET分类树(例如还要搜索关键词、翻页商品),应拆分到其它对应原子 skill,勿在本技能内虚构中间结果。
使用场景
- 海外店铺搭建 Agent 在拉商品列表前,需按 userId 与 type 先取 C 端分类树做导航或类目筛选
- 商品浏览聚合流程里只缺分类树一步,由本技能调用固定 GET 接口,把树结构交给后续列表 skill
- 运营核对前台类目层级时,通过正式环境接口查询 public 分类树,避免手工抄录或本地臆造节点
- 多接口编排计划中标注了 product_category_tree,由执行器替换 path 参数并完成 Bearer 鉴权后返回原始 RS
适合人员
- 对接酷特 kutetailor 海外商品 API、要在 Agent 里按规范嵌套 params 的集成工程师
- 负责 platform-product-browse 聚合链路、需把分类树作为第一步原子调用的平台 Agent 维护者
- 海外商品运营在上线或改类目前,要核对 C 端分类树与权限是否一致的类目配置同学
- 编写多步商品浏览计划的解决方案架构师,需要可复用的 product_category_tree 原子能力