Kutsmart 商品首页与轻量过滤

问题背景

海外运营团队在配置商城首页、分类页商品列表时，常面临两种问题：要么直接对接通用接口，要自己处理分页、排序、分类筛选、标签过滤等参数，重复拼接逻辑；要么用大而全的聚合服务，但又不需要那么多功能，反而增加维护成本。我们需要一个最小颗粒度的接口技能，专门处理「商城首页、分类页商品浏览+轻量过滤」这一个动作。

核心能力与执行逻辑

这个技能封装了固定接口 GET /product/product/public/selectProductHome，核心能力包括：

• 标准化参数组织：所有请求参数统一封装在嵌套的 params 对象里，pageNum、pageSize 等分页参数，type 分类类型，可选的 sort 排序规则、category 分类ID、labels 标签列表等过滤条件，都按规范放在 params 内，避免顶层参数混乱；
• 环境地址固定：正式环境调用地址写在技能 frontmatter 的 base_url 中，执行时不接受用户输入覆盖，防止调用到非生产环境；
• 登录态自动适配：通过 params.accessToken 生成 Authorization: Bearer 请求头，若传入值已包含 Bearer 则不重复拼接；
• 返回值忠实传递：直接返回接口的 IPage 数据结构，不补造库存、价格、优惠金额等缺失字段，确保数据真实性。

使用时，当用户需要获取商城首页商品、分类页商品列表，或做轻量的分类、标签、排序过滤时，技能会按以下步骤执行：

1. 校验用户请求是否属于当前技能的触发场景；
2. 从 frontmatter 提取固定 base_url，结合 params.path 拼接完整请求路径；
3. 将 params.query 中的查询参数（如 pageNum、type、category）附加到 URL 后；
4. 按规范生成 Authorization 请求头，携带 params.headers 中的额外头信息；
5. 发送 GET 请求，获取接口返回的 IPage 数据并原样返回给上层 Agent。

适用边界与注意点

• 这个技能是最小颗粒度的原子技能，只负责 product_home 这一个接口动作。如果需要构建完整的商品浏览链路（比如先获取首页列表、再进入商品详情、最后加入购物车），需要由上层 Agent 按聚合 skill 或计划文档编排多个原子技能；
• 技能返回值完全以接口响应为事实来源，不会补造接口未返回的字段。若接口返回认证失败、权限不足、参数错误或业务异常，会将原始错误码和错误信息直接传给上层 Agent；
• 仅适用于 Kutesmart 海外运营平台的正式环境，调用时需遵守平台的登录态、租户和用户权限规则；若上层接口网关对请求体格式有特殊约定，需以网关契约为准调整参数提交方式。