酷特海外平台工艺目录查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-catalog-craft-by-ecode-category。
技能介绍
要解决什么问题
在海外运营或商品配置场景里,工艺信息往往挂在工艺编码与品类两个维度上。人工在后台翻目录、或让 Agent 猜测工艺名称,既容易错配,也难和平台侧主数据对齐。本技能只做一件事:用平台正式环境的查询接口,按 craftCode 与 category 拉取工艺记录,把结果交给上层编排继续用。
技能如何工作
- 接口动作:
craft_by_ecode_category,对应GET /craft/craft/getCraftByEcodeAndCategory。 - 调用约定:工具参数统一放在嵌套的
params里;查询条件写入params.query(craftCode、category);需登录态时通过params.accessToken生成Authorization: Bearer(值里已有Bearer则不再拼接)。 - 环境与地址:正式环境
base_url固定在技能 frontmatter,执行时不得用用户输入覆盖。 - 返回处理:以接口响应为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与信息向上传递,便于 Agent 重试或改参。
适用边界与注意点
这是最小颗粒度的原子 skill,不包含登录、列表翻页、下单等步骤;完整业务需由上层 Agent 按聚合 skill 或计划文档组合多个接口。若用户一次描述里需要多步操作,本技能只完成「按编码和品类查工艺」这一步,关键字段留给后续 skill 使用。
使用场景
- 客服或运营收到客户提供的工艺编码,需在同一品类下核对平台工艺名称与属性后再回复
- 商品配置 Agent 在生成海外 SKU 说明前,必须按 `craftCode` 与 `category` 拉取官方工艺定义
- 编排 `platform-craft-catalog` 多步流程时,在选品或报价前先校验编码与品类是否对应有效工艺
- 集成测试脚本模拟用户提问「某编码在某品类下是什么工艺」,只调用本原子接口并记录原始响应
适合人员
- 负责酷特海外运营后台、经常按编码核对工艺与品类是否一致的运营专员
- 对接 kutetailor.com 正式环境、把工艺查询拆成原子 skill 供 Agent 调用的后端或集成工程师
- 维护海外商品工艺主数据、需要在对话或工单里即时查平台工艺目录的商品配置同学
- 设计多 skill 编排方案、需明确「按编码和品类查工艺」只由本技能完成的 Agent 方案设计者