海外运营平台工艺编码查询
将以下提示词粘贴到你的 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 的技术负责人,需要把按编码查询工艺目录作为最小原子步骤。
- 排查接口认证、权限或参数错误的运维人员,需要按工艺编码调用并获取原始错误信息。