酷特海外工艺材质列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-admin-craft-material-page。
技能介绍
要解决什么问题
在海外运营平台的工艺后台里,材质是工艺配置的基础数据:排期、报价、工单往往都要先知道「当前有哪些材质、分页结果长什么样」。如果让大模型直接猜材质名或硬编码列表,和正式环境不一致,后续改价、选料、对账都会错。
本技能是最小颗粒度的原子接口 skill,只负责一件事:按平台契约调用 craft_material_page,拿到工艺材质分页列表的真实响应。
技能如何工作
- 固定正式环境:请求走 frontmatter 中的
base_url(GET /craft-material/page),执行器不接受用户输入覆盖域名。 - 参数结构:tool 参数统一放在嵌套对象
params里;Query 写在params.query,登录态用params.accessToken生成Authorization: Bearer(值里已有Bearer则不重复拼接)。 - 返回即事实:列表字段以接口 JSON 为准,不补造库存、价格、订单号等;若出现认证、权限、参数或业务错误,把原始错误码与信息交给上层 Agent 处理。
需要「查材质 + 改配置 + 提交审核」等多步链路时,由上层按聚合 skill platform-craft-admin 或计划文档编排多个原子 skill;本 skill 只完成列表查询这一步,并把关键返回字段交给后续步骤。
适用边界与注意点
- 这是查询类接口,仍受当前登录态、租户与用户权限约束;无 token 或权限不足时,应如实上报接口错误,而不是本地编造空列表。
- 最外层只放
params,不要使用params.xxx这类点号顶层 key。 - 若你的需求不止列表页(例如新增材质、上下架),请选用对应 action 的其他原子 skill,不要指望本接口顺带完成写操作。
使用场景
- Agent 编排工艺配置前,需先拉取正式环境工艺材质分页列表,核对材质编码与名称再选料
- 用户口述「查一下后台有哪些工艺材质」,由技能调用 `craft_material_page` 返回当前页真实数据
- 在聚合 skill `platform-craft-admin` 链路中,作为列表查询原子步骤,把分页结果交给后续改价或绑定工艺步骤
- 对接 kutetailor 工艺域时,仅完成 GET `/craft-material/page` 查询,避免模型自行编造材质清单
适合人员
- 负责海外工艺后台配置、需在对话式 Agent 里按正式环境材质列表选料绑定的工艺运营
- 编写 `platform-craft-admin` 多步计划的集成开发,需要可复用的材质分页查询原子 skill
- 维护 kutetailor 工艺接口契约的工程师,要把 Query 分页与 Bearer 登录态按平台规范交给执行器
- 工艺审核或报价前需对照线上材质主数据、禁止手工维护过期材质表的内部实施同学