品类刺绣查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-craft-catalog-embroidery-by-category,用于在 AI 助手中调用品类刺绣查询接口。
技能介绍
解决的问题
海外运营平台工艺目录中,品类与刺绣工艺的关联关系分散,人工维护或临时查询易出现信息不同步。上层自动化链路需要标准化的接口调用能力,避免重复对接不同品类的刺绣查询逻辑,减少参数拼接错误和登录态处理的重复工作。
工作方式
该技能聚焦品类刺绣查询这一原子动作,固定调用正式环境接口 GET https://www.kutetailor.com/api/craft/craft-embroidery/selectEmbListByCategoryId,核心步骤如下:
- 参数统一封装在嵌套
params对象中,品类ID写入params.query.categoryId,不使用点号顶层key - 执行器自动读取 frontmatter 中的固定
base_url,不接受用户输入覆盖地址 - 登录态通过
params.accessToken生成Authorization: Bearer,若传入值已含 Bearer 则不重复拼接 - 路径变量、查询参数、额外 Header 分别写入
params.path、params.query、params.headers,遵循接口网关约定
适用边界
仅负责单个接口的调用,不处理多步骤业务链路。若用户需求涉及多个接口步骤,需由上层 agent 按聚合 skill 或计划文档编排其他原子 skill 组合完成。返回结果以接口响应为唯一事实来源,不补造任何业务字段。若接口返回认证、权限等错误,需原样传递错误码和信息给上层 agent。
使用场景
- 多步骤业务链路中需根据品类ID获取刺绣列表,并把结果传给后续接口处理
- 当用户需要按指定品类筛选刺绣工艺时,调用该接口获取准确返回结果
- 接口返回认证或参数错误时,需将原始错误码和信息传递给上层agent处理
- 上层agent编排完整业务流程时,需要调用该接口获取品类刺绣数据作为中间步骤
适合人员
- 需要调用海外运营平台刺绣查询接口的开发者,需处理参数和响应
- 海外运营平台的运营人员,需按品类获取刺绣信息更新产品数据
- 负责编排多个原子技能的工程师,需确保每个技能正确调用和数据传递
- 需要集成工艺目录查询功能的系统架构师,需了解接口参数和权限要求