Agent Skills
返回列表
KuteSmart 款式后台简定制导入模板

KuteSmart 款式后台简定制导入模板

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-style-admin-style-info-template。

技能介绍

要解决的问题

后台维护「简定制」款式时,导入模板的字段结构会随业务调整,但调用方往往把模板拼在硬编码的常量里:前端写死一份 JSON,导出工具再写一份,两边结构一旦漂移,上传时报的错又指向解析阶段,很难定位到底是模板过期还是文件格式不对。把模板获取收敛成一个接口动作,可以让上层 agent 每次都以服务端返回为准,不再各自维护副本。

技能如何工作

这个 skill 只封装一个原子动作 style_info_template,对应的正式环境接口是 GET https://www.kutetailor.com/api/style/style-import/getDesignTemplate,请求路径 /style-import/getDesignTemplate,没有查询参数,返回结构由 RS 约定承载。

执行流程上有几个必须遵守的约定:

  • base_url 固定在 frontmatter 中,执行器只能读配置,不接受用户输入覆盖,避免有人把调用打到测试地址或第三方域名。
  • 参数统一收在 params 对象里:路径变量放 params.path,查询参数放 params.query,请求体放 params.body,额外 Header 放 params.headers。最外层不要再出现 params.xxx 这种点号 key。
  • 登录态接口从 params.accessToken 生成 Authorization: Bearer;传入值已经带 Bearer 前缀时,不要重复拼接,否则会得到畸形的 Header。
  • 它是查询类接口,但仍然会校验当前登录态、租户与用户权限,不是匿名可调用的公开资源。
  • 返回结果必须以接口响应为事实来源,不要在本地补造库存、价格、订单号、优惠金额或物流状态。

适用边界

它只负责「取模板」这一步,不包含模板解析、样衣数据映射或批量导入。如果业务链路需要先取模板、再按模板校验款式字段、最后提交导入,应当由上层 agent 按聚合 skill 或计划文档编排多个原子 skill,本 skill 完成调用后把关键返回字段交给后续步骤。

遇到认证、权限、参数或业务错误时,执行器要把原始错误码与错误信息原样透传给上层 agent,不要自行改写成「操作失败」这类模糊文案,否则排查链路会断在中间层。

来源

聚合 skill:platform-style-admin;聚合 skill 文档:doc/skill/platform-style-admin/SKILL.md;原始 action:style_info_template。

使用场景

  • 海外运营平台要新增简定制款式导入功能,开发先用这个 skill 拉取服务端模板,确认字段结构后再写上传逻辑。
  • 上层 agent 编排「取模板→校验款式→批量导入」链路,第一步调用本 skill,并把返回字段交给后续原子 skill。
  • 排查导入失败问题时,需要确认本地常量模板是否过期,可直接用本 skill 调一次生产接口拿最新模板做对比。
  • CI 里要生成一份简定制导入样例文件,执行器通过本 skill 获取真实模板结构,再填充测试数据。

适合人员

  • KuteSmart 海外运营平台的后端工程师,需要在接入层调用获取简定制导入模板接口并处理错误码。
  • 负责编排多个原子 skill 的 agent 工程师,要按 SKILL.md 约定传递 params 与关键返回字段。
  • 维护款式导入工具链的开发者,需要确认服务端模板结构是否变更,及时更新本地校验规则。
  • 搭建 CI 测试样例的工程负责人,依赖生产模板结构生成贴近真实的导入样例文件。