KuteSmart海外C简定制品类查询

它解决什么问题

在 KuteSmart 海外运营平台的定制下单链路里，前端或上层 Agent 需要先拿到「C 简定制」可用的品类目录（也就是有哪些简定制款式分类可选），才能继续后面的款式详情、报价、配置等步骤。这个请求看起来简单，但实际接入时有几个容易踩的坑：

• 接口地址是固定的正式环境地址，不应该由用户输入覆盖；
• 参数层级要求统一嵌在 params 对象里，而不是把 key 直接铺在最外层；
• 鉴权、租户和用户权限仍然生效，并不是「公开接口就什么都不用管」；
• 返回的 List 需要原样交给后续 skill，不能自己补全库存、价格之类的字段。

这个技能就是把这些约定封装成一次原子调用，让上层 Agent 不用每次重新拼请求。

它是怎么工作的

核心能力只有一个：执行 simple_category_list 这个 action。

1. 读取 frontmatter 中固定的 base_url，与 action 表中的路径拼接，得到正式环境完整地址；
2. 按 action 表选择 HTTP method（这里是 GET）与 URL；
3. 把 Path 参数写入 params.path，Query 参数写入 params.query，JSON Body 写入 params.body，额外 Header 写入 params.headers；
4. 登录态接口用 params.accessToken 生成 Authorization: Bearer；如果传入值已经包含 Bearer，不要重复拼接；
5. 发起调用，把返回的 List 作为事实来源交给上层 Agent。

最外层只放 params，不要出现 params.xxx 这类点号顶层 key；POST/PUT 默认发送 JSON body，若上层网关另有约定，以网关契约为准。

适用边界与注意点

• 这是最小颗粒度接口 skill，只完成这一个接口动作。需要组合成完整业务链路时，由上层 Agent 按聚合 skill platform-style-catalog 或计划文档编排多个原子 skill。
• 它属于查询/计算类接口，但仍受当前登录态、租户和用户权限约束。
• 不要补造库存、价格、订单号、优惠金额或物流状态，接口没返回就不写。
• 遇到认证、权限、参数或业务错误时，把原始错误码和错误信息原样传给上层 Agent，不要吞掉或改写。