Agent Skills
返回列表
海外运营平台工艺编码查询

海外运营平台工艺编码查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-craft-catalog-craft-by-ecode。

技能介绍

解决什么问题

在海外运营平台的工艺目录里,工艺记录通常以工艺编码(ecode)作为业务主键。当上层系统或运营人员手里只有一条编码、却需要拿到该工艺的完整档案时,直接翻库或拼查询语句既容易出错,也不便于在 Agent 链路里复用。这个 skill 只做一件事:把编码变成一条权威的工艺记录。

它适合嵌入到工艺查询、订单工艺校验、目录聚合等流程的某一环,而不是替代整条链路。

技能如何工作

技能暴露一个原子动作 craft_by_ecode,对应固定正式环境的接口调用:

  • 请求方式:GET https://www.kutetailor.com/api/craft/craft/craft/getCraftByEcode
  • Query 参数:ecode,即待查询的工艺编码
  • 返回:RS 结构,包含该编码对应的工艺信息

调用方通过统一的 params 嵌套对象传参:

  • params.query 中携带 ecode
  • 登录态通过 params.accessToken 生成 Authorization: Bearer;若传入值已包含 Bearer,不会重复拼接
  • 该接口是查询类动作,无需请求体;执行器会从 frontmatter 读取固定的正式环境地址,不接受调用方覆盖 base_url

拿到响应后,skill 将原始结果交给上层 Agent,由后续步骤继续解析或组合成完整业务链路。

适用边界与注意点

  • 只覆盖单点查询:如果用户需求涉及多个接口步骤,本 skill 只完成 craft_by_ecode 这一跳,关键返回字段交由后续 skill 处理
  • 不做数据补全:返回结果以接口响应为唯一事实来源,不会补造库存、价格、订单号、优惠金额或物流状态
  • 权限依赖登录态:查询仍受当前登录用户、租户与权限约束;认证失败、权限不足或参数错误时,会原样透传错误码与错误信息
  • 依赖上层编排:该接口属于 platform-craft-catalog 聚合下的原子 skill,需要组合使用时由上层 Agent 按计划文档编排多个 atomic skill

适合把它当作工艺目录读取链路中最小、最明确的一个环节来理解。

使用场景

  • 在海外运营平台的工艺目录中,需要根据工艺编码查询对应工艺记录的完整信息。
  • 订单或业务单据校验时,要根据工艺编码读取工艺档案,核对工艺是否匹配。
  • 多个原子接口需要串成完整流程时,由上层 Agent 先调用本接口按工艺编码查询工艺目录。
  • 接口返回认证、权限或参数错误时,需要将原始错误码和错误信息传给后续 skill。

适合人员

  • 对接海外运营平台工艺目录的开发工程师,需要按工艺编码稳定调用查询接口。
  • 负责工艺维护的运营人员,需要根据工艺编码快速找到对应工艺记录。
  • 构建多接口编排 Agent 的技术负责人,需要把按编码查询工艺目录作为最小原子步骤。
  • 排查接口认证、权限或参数错误的运维人员,需要按工艺编码调用并获取原始错误信息。