mint-threejs-skills

Mint Three.js スキル

ブラウザベースの Three.js 作業向けに、Mint のエージェントスキルをまとめたスイートです。オープンソースの Three.js ゲーム、アプリケーション、グラフィックスエージェントのワークフローを組み合わせて適応し、ゲーム向けの充実したワークフローを保ちながら、3D アプリ全般に対応します。

ルートを選択

• 主な成果物が、生成モデル、アニメーションモデル、一貫性のあるモデルアセットパック、マテリアル、マテリアルパック、または明示的にリクエストされた 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 モジュールをデフォルトにします。
• デフォルトでは Vanilla Three.js を使用します。プロジェクトまたはユーザーが選択した場合は、React Three Fiber やその他の Three.js ベースのスタックにも対応します。
• 生成アセットの制作パイプラインには Mint MCP のみを使用します。ブラウザーのランタイムコードから MCP を呼び出さないでください。
• 編集対象のローカルコードプロジェクト（フォルダーまたはリポジトリ）と、Mint のチャットやアセットを管理するリモートワークスペースである Mint Project を区別します。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を使用してください。