酷特海外面料字典
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-fabric-admin-fabric-dict。
技能介绍
要解决什么问题
在海外运营平台的面料后台里,业务侧经常需要面料字典——把某个 id 对应的标准化面料信息查出来,供选料、报价或下游接口对齐。若让 agent 直接拼 URL、混用测试/正式环境,或把多个后台动作揉在一个 skill 里,排查权限和参数错误会很痛苦。本 skill 只做一件事:在固定正式环境上调用 fabric_dict(GET /fabric-dict)。
技能如何工作
执行器读取 frontmatter 中的 base_url(正式环境为 https://www.kutetailor.com/api/fabric/fabric-dict),不接受用户输入覆盖。tool 参数统一放在嵌套的 params 对象里:最外层只有 params,不要用 params.xxx 这类点号顶层 key。
- Query:面料 id 写在
params.query.id - 登录态:通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再重复拼接 - 其它:Path 用
params.path,Body 用params.body,额外 Header 用params.headers(本接口为 GET,通常只需 query 与 token)
返回以接口响应为准;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent,而不是本地编造库存、价格或订单状态。
适用边界
这是最小颗粒度的原子 skill,只负责 fabric_dict 这一步。完整链路(例如先登录、再查列表、再改维护字段)应由上层 agent 按聚合 skill platform-fabric-admin 或计划文档编排多个原子 skill。用户一次提多个接口步骤时,本 skill 只完成本接口调用,并把关键返回字段交给后续 skill。
使用场景
- 海外运营 agent 在报价流程里已有面料 id,需调用 GET /fabric-dict 拉取标准字典字段再写入下游表单
- 面料维护对话中用户指定某个 id,需要先查面料字典确认名称与属性,再决定是否走后续编辑接口
- 编排 platform-fabric-admin 链路时,本步只负责 fabric_dict,把 RS 返回的关键字段交给下一个原子 skill
- 排查选料异常时,用正式环境固定地址按 id 复现接口原始响应,区分权限错误与业务错误
适合人员
- 负责酷特海外面料目录维护、常按 id 核对字典与前台展示是否一致的运营
- 把 kutetailor 面料接口接入内部 agent 的集成工程师,需要最小粒度的 fabric_dict 工具契约
- 编写 platform-fabric-admin 聚合计划、需拆分登录、列表与字典查询多步的原子 skill 编排者
- 客服或技术支持在工单里只有面料 id,需让 agent 查正式环境字典并回传原始错误码给人工