Kutesmart 面料字典维护
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-admin-fabric-dict。
技能介绍
解决什么问题
在海外运营平台中,面料字典是贯穿商品管理、订单履约和供应链协同的基础数据源。后台运营人员在维护面料信息时,常面临字典条目分散、多语言名称不统一、属性值无法校验等问题;一旦面料名称或代码发生变化,前端商品页、采购单和质检报告都可能引用到过期数据,导致沟通成本上升和业务偏差。
技能如何工作
面料字典维护 将 GET /api/fabric/fabric-dict 封装为一个最小颗粒度的原子技能,只负责一次明确的接口调用,让上层 Agent 可以在完整业务链路中按需编排。
核心能力
- 精准查询:通过
fabric_dict动作获取面料字典的单条记录,仅需要传入id参数。 - 参数结构化:所有请求参数统一封装在
params对象内,避免顶层 key 混乱。 - 正式环境直连:接口地址固定为
https://www.kutetailor.com/api/fabric/fabric-dict,不接受用户输入覆盖。
关键执行步骤
- 执行器从
params.query中读取id,拼入 URL 查询字符串,按GET方法发起请求。 - 登录态通过
params.accessToken生成Authorization: Bearer,若传入值已含 Bearer 前缀,直接使用,不重复拼接。 - 接口响应作为唯一事实来源,将面料编号、名称、属性等字段返回给上层 Agent,不补造库存、价格或物流状态。
适用边界与注意点
- 这是单一接口技能,不能独立完成面料新增、审核或多步骤流程,需要与聚合技能或计划文档配合。
- 返回结果必须原样透传,若接口返回认证失败、权限不足或参数错误,只将原始错误码和错误信息上传,不做二次加工。
- 仅适用于 Kutesmart 海外运营平台已登录且拥有面料字典查看权限的租户和用户。
使用场景
- 运营人员需要查看指定面料编号的字典条目,核对名称和属性是否正确
- 客服接到面料咨询时,用面料编号查询字典返回的官方名称和参数
- 开发者在编排面料管理流程时,调用该接口获取单条字典记录作为上游步骤
- 运营团队批量整理面料清单前,先用接口按 id 查询确认每条记录的准确信息
适合人员
- 负责面料基础数据维护的运营,需要在后台核对和更新面料字典条目
- 海外运营平台的后端工程师,要将面料查询接口集成进业务流程
- 处理面料相关客诉的客服,需要快速获取面料的官方名称和属性参数
- 编写上层 Agent 编排方案的开发者,需要将该原子接口作为流程的一个节点