Agent Skills
返回列表
面料图片路径查询

面料图片路径查询

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-catalog-fabric-path

技能介绍

要解决的问题

海外运营平台的面料目录里,每一块面料都有对应的展示图片,但图片并不是直接内嵌在业务记录中的,而是以路径形式存放。运营人员在前台页面选面料,或下游系统生成面料展示物料时,手里通常只有面料编号(code),并不知道图片资源的具体位置。

本技能解决的正是这一步「从面料编号到图片路径」的查询:调用正式环境接口 GET /fabric/selectPathByCode,传入面料编号,拿回图片路径字符串,供上层系统拼接 CDN 地址或生成展示物料。

技能如何工作

这是一个最小颗粒度的原子技能,只封装一个动作:fabric_path。它的调用约定与平台其他接口 skill 保持一致:

  • 调用地址固定:正式环境地址写死在 SKILL.md frontmatter 的 base_url 中,执行器不允许被用户输入覆盖,避免误打到测试环境或第三方地址。
  • 参数统一走 params 嵌套对象:Query 参数写入 params.query,Path 参数写入 params.path,Body 写入 params.body,额外请求头写入 params.headers。最外层只允许出现 params 这一个 key。
  • 本接口只用到 Query:GET /fabric/selectPathByCode 接收 code 查询参数,返回值为字符串类型的图片路径。
  • 认证沿用登录态:调用方通过 params.accessToken 传入令牌,执行器自动生成 Authorization: Bearer 请求头;若传入值已包含 Bearer 前缀,不会重复拼接。
  • 返回以接口响应为准:技能不做任何补造,接口未返回的字段(如库存、价格、订单号)一律不生成。

在更大的业务链路中,它通常作为聚合 skill platform-fabric-catalog 的一个环节:上层 agent 先拿到面料编号,再调用本技能获取图片路径,最后交给后续 skill 完成物料生成或展示。

适用边界与注意点

  • 只做路径查询:本技能不负责下载图片、拼接 CDN 前缀,也不校验图片是否真实存在,这些应由上层逻辑完成。
  • 多步需求不覆盖:如果需求需要多次接口调用(比如先查面料列表再查图片路径),本技能只完成自己的这一步,并把关键返回字段交给后续 skill。
  • 权限与租户约束仍在:虽然是查询类接口,仍需遵守当前登录态、租户和用户权限,可能因权限不足而失败。
  • 错误原样上报:接口返回认证、权限、参数或业务错误时,技能会将原始错误码和错误信息透传给上层 agent,由上层决定如何处理,而不是自行吞掉或改写。

使用场景

  • 海外运营平台的运营人员,在准备面料展示页面时,需根据面料编号查询图片路径,用于拼接展示物料
  • 后端开发工程师,为面料详情接口补充图片地址,调用该技能传入面料编号获取路径返回前端
  • 内容运营团队制作面料宣传物料,拿到面料编号后用技能查询图片路径,提取素材用于设计稿
  • 第三方系统集成人员,将面料目录数据同步至外部系统时,需按编号调用技能获取图片路径一并同步

适合人员

  • 海外运营平台的运营人员,需要根据面料编号快速获取图片路径,用于前台展示或宣传物料制作
  • 后端开发工程师,负责面料相关接口开发,需集成该技能补充图片路径返回逻辑
  • 内容运营团队成员,制作面料宣传内容时,需通过面料编号查询图片路径提取素材
  • 第三方系统集成人员,对接面料目录数据时,需按编号调用技能获取图片路径完成数据同步