SuperAPI AI 工具集

mint-threejs-skills

编程与开发

查看项目

更新于 10-15 14:38

技能介绍

用途

Mint Three.js Skills 是 Mint 提供的智能体技能套件,用于浏览器端 Three.js 相关工作。它整合并改编了开源 Three.js 游戏、应用与图形智能体工作流,将其泛化到通用 3D 应用,同时保留深度游戏工作流。

主要能力

套件覆盖构建、修改、调试与验证浏览器端 Three.js 应用、游戏、资产查看器,以及模型、模型资产包、材质与材质包交付等任务。

使用方式:选择路线

  • 若请求的主要交付物是一个生成模型、动画模型、连贯的模型资产包、一个材质、一个材质包,或一个明确请求的 Mint 世界:先阅读 references/asset-viewer.md,然后使用应用导演。此时资产即产品,查看器是其检查与下载外壳。
  • 通用 3D 应用、查看器、配置器、仿真、漫游、编辑器或交互体验:阅读 skills/threejs-app-director/SKILL.md。
  • 带目标、挑战、计分、失败、进阶或游戏手感的游戏或类游戏请求:阅读 skills/threejs-game-director/SKILL.md。
  • 混合体验:先使用应用导演,再仅添加相关的游戏专家。

两条路线共享视觉系统、交互、调试、QA 与 references/mint-mcp-assets.md。在首次对某代码库执行 Mint MCP 写入前,阅读 references/mint-project-workspaces.md,为该工作确定一个 Mint Project。使用 Mint 资产的项目还需使用 references/asset-pipeline.md 中的持久注册表。

已有应用或游戏上下文优先于资产交付:应将请求的资产生成并集成到该项目中,而不是搭建独立查看器。

不变量

  • 已有项目架构优先。绿地方案默认使用 TypeScript、Vite 与 Three.js 模块。
  • 默认使用原生 Three.js;当项目或用户选择时,支持 React Three Fiber 或其他基于 Three.js 的技术栈。
  • Mint MCP 是唯一生成资产生产管线。MCP 调用不得进入浏览器运行时代码。
  • 区分本地代码项目(正在编辑的文件夹或仓库)与其 Mint Project(拥有 Mint 聊天与资产的远程工作区)。为每个代码库确定或创建一个 Mint Project,持久化到 mint-assets.json,并在该代码库的每次独立生成中复用。
  • 对每个导入 Mint 文件或远程世界配置的项目,通过 scripts/sync-mint-assets.mjs 维护项目根目录的 mint-assets.json。复用稳定的逻辑键,并保留现有项目的资产根约定。
  • 对每条加载 Mint 生成 GLB 的 Three.js 路径,阅读 references/gltf-runtime-compatibility.md 并使用支持 Draco 的共享加载器。Mint 优化过的 GLB 与裸 GLTFLoader 不兼容。
  • 优先使用离散的生成模型并在 Three.js 中组合。仅当用户明确选择生成环境时,才生成 Mint 世界;此时阅读 references/mint-world-splats.md。
  • 当程序化或用户提供的资产是正确设计选择,或 Mint MCP 缺少所需能力时,使用它们。绝不为 Mint 已成功生成的主体创建竞争性的程序化版本。
  • 验证前阅读 references/verification-policy.md。运行其自动最低要求,扩展桌面/浏览器 QA 前先询问,移动端 QA 需单独二次批准。其批准边界优先于更广泛的专家完成门槛。
  • 不要将目标、压力、奖励或失败等游戏概念强加到通用 3D 应用上。

用户自有 UI

将交付的应用视为用户的产品,而非资产生成管线的演示。除非用户明确要求,运行时 UI 中不得出现提供商名称、品牌、徽章、生成链接、资产 ID 与来源信息。生成来源与交接链接仅在最终回复或开发者文档中提及。默认使用体验所需的最小 UI:加载与错误状态、必要控件与明确请求的操作。除非被要求,不添加页眉、标题栏、导航、营销文案、署名或装饰性应用外壳。对于规范资产查看器,保持画布主导,通过信息按钮打开紧凑居中的详情对话框,并配底部居中的检查控件;不要保留永久侧边栏空间。对于其他简单查看器与漫游,使用紧凑的底部居中控件组,并在其正上方以相同紧凑视觉语言放置加载、就绪或错误状态。

当用户要求可复用提示时,使用 references/request-templates.md。

适用场景

适用于浏览器端 Three.js 应用、游戏、资产查看器、配置器、仿真、漫游、编辑器、交互体验,以及模型、模型资产包、材质与材质包交付。

限制

资料未提供收费、价格、平台支持范围、具体效果指标等事实,暂未提供。