酷特海外运营工艺目录
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的说明,在你的 AI 助手中安装 @kutesmart/kutesmart-platform-craft-catalog。
技能介绍
要解决什么问题
海外定制下单链路里,工艺不是静态字典:同一 ecode 在不同品类下含义不同,款式详情里往往只有工艺 id 列表,提交前还要算价并排除互斥组合。若把面料、权限、审批混在同一套工具里,模型很容易在「查工艺」和「改主数据」之间越界。
本技能由原 platform-fabric-craft 拆出,只对接正式环境根地址 https://www.kutetailor.com/api/craft,覆盖 按 id / 编码 / 品类 查询、批量补全、定价与冲突校验,以及按品类查衬类型、刺绣、商标组等附属信息。
技能如何工作
动作表按 action 映射到具体 HTTP 接口,常见组合如下:
- 用户给出工艺编码时,优先
craft_by_ecode或craft_by_ecode_category(需craftCode+category)。 - 从款式详情拿到多个工艺 id 时,用
craft_list(Query:craftIds)批量补齐名称与属性。 - 提交前:
craft_conflict_by_ids或craft_conflict_by_ecode拉冲突列表,再用craft_price/craft_price_by_ids按工艺 id 与币种算价。 - 刺绣、商标组、衬类型分别走
embroidery_by_category、trademark_group、lining_type_by_category,均以品类或categoryId为入口。
单条查询还可使用 craft_by_id(Path:id)。冲突相关接口在「简定制」场景下用于在下单前阻断非法组合。
边界与注意点
- 不维护工艺库、权限、审批、导入导出;任何「改库」类需求应走其它系统,不要在本技能内臆造接口。
- 一旦冲突校验返回互斥项,不得继续提交订单,应把冲突明细反馈给用户并引导重选工艺。
- 定价与冲突均为写单前的校验步骤,币种与请求体需符合各 POST 接口定义的
CalCraftPriceRequest等结构。
使用场景
- 客户报工艺编码 ecode 时,先按编码或「编码+品类」查工艺详情,再写入款式配置说明。
- 款式详情页只有一串工艺 id,需批量调用 craft_list 补全名称后再展示给业务或客户确认。
- 简定制下单前,按已选工艺 id 拉冲突列表并算价,冲突未清则停止提交并让用户改选。
- 用户选定西装等品类后,分别查询该品类的衬类型、刺绣列表与商标组供选配。
适合人员
- 对接 kutetailor 正式环境、要把工艺查询封装进对话式下单助手的后端或集成工程师
- 海外运营客服:在简定制流程里帮客户核对工艺编码、解释互斥冲突并引导重选
- 商品/工艺配置同学:按品类维护选配说明,需快速查刺绣、商标组与衬类型接口返回
- 负责海外 MTM 订单质检的业务:提交前复核工艺组合是否冲突、价格是否与币种一致