kutesmart 海外面料目录查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-catalog-fabric-info-by-code。
技能介绍
要解决什么问题
海外运营平台里的面料目录常被多个入口使用:运营人员可能从品类页面进入,门店相关人员可能从门店视角查询。如果每个调用方都自己拼接口、处理登录态和路径参数,重复代码会变多,参数口径也容易漂移。这个技能把一个具体动作固定下来:fabric_info_by_code,即按 code、category、storeCode 查询面料信息。
技能如何工作
它面向最小颗粒度接口调用。上层 agent 可以先判断当前请求是否只需要“按品类/门店查面料信息”;如果是,就调用本技能;如果需要多步编排,则只把本接口的关键返回字段交给后续 skill。
调用时统一使用嵌套 params 对象:params.query 承载 GET 参数,params.headers 承载额外请求头,登录态通过 params.accessToken 生成 Authorization: Bearer 。若传入值已经包含 Bearer ,不应重复拼接。正式环境地址固定为 frontmatter 中的 base_url,请求方法为 GET,路径为 /fabric/selectFabricInfoByCode,不能由用户输入覆盖。
适用边界与注意点
这个技能只负责查询,不负责库存、价格、订单号、优惠金额或物流状态等字段的补齐;返回结果以接口响应为事实来源。它仍然受登录态、租户和用户权限约束。如果接口返回认证、权限、参数或业务错误,应把原始错误码和错误信息透传给上层 agent,由编排方决定如何处理。
使用场景
- 运营在品类页面整理面料资料,需要按品类 code 查询面料目录信息。
- 门店人员处理门店侧请求,需要按 storeCode 获取该店可用面料信息。
- 上层 agent 编排面料查询链路,先调用本接口获取面料详情再交给后续 skill。
- 接口调用返回认证或权限错误,需要把原始错误码和错误信息返回给上层 agent。
适合人员
- 海外运营平台的后端开发者,需要把面料目录查询接口接入现有服务。
- 负责面料资料整理的运营人员,需要按品类或门店快速查看面料信息。
- 编排多个接口动作的 AI agent 开发者,需要获取原子接口返回字段。
- 门店业务系统的对接人员,需要按门店维度验证面料查询结果。