酷特海外 3D 标准号信息
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-3d-product-config-select-3d-standard-size。
技能介绍
要解决什么问题
在酷特海外运营平台(C 站)做 3D 产品配置时,尺码与版型往往依赖平台侧的「3D 标准号」元数据,而不是前端硬编码。若 Agent 自行猜测标准号或拼装未经验证的字段,下游选款、报价或下单链路会直接对不上商品模型。
本技能是 最小颗粒度 的原子接口封装,只负责一次动作:select_3d_standard_size,把接口返回的 StandardSizeThreeVO 作为事实来源交给上层编排。
技能如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url,对应GET /product/product-three/public/select3DStandardSize,不接受用户输入覆盖域名。 - 统一参数形状:tool 参数最外层仅包含嵌套对象
params;Path 进params.path,Query 进params.query,Body 进params.body,额外 Header 进params.headers。 - 登录态:需要鉴权的场景通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer前缀则不再重复拼接。 - 返回约定:以接口响应为准,不补造库存、价格、订单号或物流状态;认证、权限、参数或业务错误时,将原始错误码与信息回传给上层 Agent。
适用边界与注意点
- 用户需求若涉及多步(例如先选商品再查标准号再改配置),本技能 只完成本接口;完整业务应由聚合 skill
platform-3d-product-config或计划文档串联多个原子 skill。 - 接口标注为查询/计算类,仍受当前 租户与用户权限 约束;缺少 C 站上下文或商品参数时,应在上层补齐后再调用。
- 与表内 action 一致:仅
select_3d_standard_size,不要在本技能内扩展其它 product-three 动作。
使用场景
- 海外 C 站 3D 定制页需要根据当前商品上下文拉取平台 3D 标准号列表,供尺码/版型选项展示
- 编排 `platform-3d-product-config` 链路时,在选款或改配置前先调用本接口拿到 `StandardSizeThreeVO`
- 客服或运营 Agent 回答「这件衣服有哪些 3D 标准号」时,用正式环境 GET 接口核对而非本地猜测
- 集成测试验证 C 站商品参数与 `select3DStandardSize` 返回是否一致,再交给下游报价或下单技能
适合人员
- 负责酷特海外 C 站 3D 商品上架,需在配置流程里对接标准号元数据的运营
- 把多个 kutesmart 原子接口串成 Agent 工作流的后端或集成工程师
- 维护 3D 定制前台选项,必须用平台返回的标准号驱动尺码联动的前端开发
- 为海外定制业务做接口联调,要单独验证 `select_3d_standard_size` 入参与权限的测试工程师