技能介绍

要解决什么问题

在海外运营平台里，商品往往分散在大量 SKU 与多币种场景下。业务同学或上层 Agent 若要在已登录前提下快速定位某个商品，通常需要走「商品浏览」链路里的分页查询接口，而不是手工拼 URL 或猜测 query 字段含义。

本技能是 product_search 这一原子动作：只负责在登录态下，按商品名称或编码（以及分页参数）向正式环境发起一次 GET 查询，并把接口返回的分页结构交给后续步骤使用。

技能如何工作

固定端点：执行器使用 frontmatter 中的正式环境 base_url，对应路径 GET /product/product/cProductPage，不接受用户输入覆盖域名。
鉴权：通过 params.accessToken 生成 Authorization: Bearer；若传入值已含 Bearer 前缀则不再重复拼接。
参数约定：tool 参数统一放在嵌套 params 对象内；分页与筛选写在 params.query，例如 pageNum、pageSize，以及可选的 code、name、userId、currency。
返回事实：以接口响应为准构造结果；不要自行补造库存、价格、订单号、优惠或物流状态。认证、权限、参数或业务错误时，应把原始错误码与信息向上层 Agent 透传。

适用边界

这是最小颗粒度接口 skill，只完成单次 product_search。若用户需求涉及多步（例如先选租户再搜商品再下单），需要由上层 Agent 按聚合 skill platform-product-browse 或计划文档编排多个原子 skill。查询类接口仍受当前登录态、租户与用户权限约束。