酷特海外平台工艺目录·商标组查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-catalog-trademark-group。
技能介绍
要解决什么问题
在酷特海外运营平台的工艺目录里,商标组是后续选品、工艺配置、会员维度筛选的前置数据。业务上常见需求是:已知 categoryId 或 memberId,先拉出当前租户下可用的商标组列表,再交给下游步骤做明细查询或下单编排。
本技能是最小颗粒度接口封装,只负责 trademark_group 这一动作,不替上层 Agent 串联库存、价格或订单类接口。
技能如何工作
- 固定正式环境:请求走 frontmatter 中的
base_url(GET …/craft-trademark-group/selectGroupList),执行器不得用用户输入覆盖域名或环境。 - 统一参数形态:tool 参数最外层仅使用嵌套
params;Query 写入params.query,常见字段为categoryId、memberId。 - 登录态:需登录的调用在
params.accessToken传入 token;生成Authorization: Bearer …,若值已含Bearer则不再重复拼接。 - 返回以接口为准:成功时把接口原始响应交给上层;若出现认证、权限、参数或业务错误,应透传错误码与错误信息,便于 Agent 重试或改参。
上层若需完整「工艺目录」链路,应参考聚合 skill platform-craft-catalog,按文档编排多个原子 skill。
适用边界与注意点
- 仅覆盖查询商标组;多步骤流程(例如先类目、再组、再明细)需由上层计划或其它 skill 组合完成。
- 仍受当前租户与用户权限约束;无权限时以接口错误为准,不要本地臆造组名或 ID。
- GET 查询参数必须落在 URL query,不要误放到 body。
使用场景
- 海外运营 Agent 在选工艺前,需按 categoryId 拉取当前类目下可用商标组供用户点选
- 会员维度配置工艺时,用 memberId 查询该会员可见的商标组列表再跳转明细接口
- 编排 platform-craft-catalog 链路时,本步只负责 selectGroupList,把组 ID 交给后续 craft 查询
- 客服或内部工具根据用户提供的类目 ID,核对租户内商标组是否与后台一致
适合人员
- 负责酷特海外工艺目录对接的后端,要把商标组查询封装成 Agent 可重复调用的原子 tool
- 搭建海外运营多步对话的 Agent 工程师,需要在类目/会员筛选后插入商标组列表这一步
- 维护 platform-craft-catalog 聚合 skill 的维护者,需对齐 trademark_group 的参数与 Bearer 登录约定
- 海外运营或商品同学,通过 Agent 查 memberId 对应商标组以核对前台展示与后台数据