viettranx/3dviz-pro-max

3Dviz Pro Max – AI駆動の3Dシーン作成

何であるか – Claude Code、Codex、および類似のLLMエージェント向けの独立型スキルで、自然言語による意図（例：「動く生き物を備えた小さなファンタジー村を構築」）を完全かつレンダラブルなThree.jsシーンに変換できます。このスキルは10ステップのワークフロー、検索可能な223個の「レシピ」カタログ、440件の知識記録、22個の完成済みキットブループリント、スタイルプロファイル、およびレンダリングされたフレームをキャプチャしてエージェントが検査できるPythonヘルパーを提供します。

動作方法

1. 意図 → 推論 – エージェントはユーザーのリクエストを解析し、必要なオブジェクト、スタイル、挙動を決定します。
2. キットの再利用／適応 – カタログからキットブループリント（例：地形、小屋、ギアセット）を選択するか、独自に新規作成します。
3. 初回ビューの構築 – 選択されたアセット、照明装置、カメラ設定などを含むVite + Three.jsのスケルトンを埋め込みます。
4. 実行とキャプチャ – scripts/capture.pyがPlaywright経由でヘッドレスChromiumインスタンスを起動し、実際のGPU上でシーンをレンダリングし、PNGフレームとログを出力します。
5. 改善 – エージェントは観測されたフレームと意図した記述を比較し、パラメータを調整して、報告内容が証拠と一致するまで繰り返します。
6. レポート – 最終出力は、構築された内容の要約とキャプチャされた画像です。

提供されるもの

項目	数量	備考
レシピ	223	24のテーマ別方向（環境、解剖学、ロボット工学など）
知識記録	440	スタイル、照明、カメラ、素材のデフォルト設定
キットブループリント	22	SHA‑256検証済みキャプチャ付きの検証済みThree.jsモジュール（T0〜T3の階層；T4は提供せず）
スタイルプロファイル	37	数値デフォルト付きの名前付きスタイル
例題研究	37	完全に実行可能なデモ（心臓解剖、ギアメカニクス、ファンタジー村など）
ショーケースフレーム	21	実GPUキャプチャ（1920×1080）docs/demos/に保存

インストール – skills/3dviz-pro-max/フォルダ全体がプラグインです。

# Claude Code（プラグインディレクトリ）
ln -s $(pwd)/skills/3dviz-pro-max ~/.claude/skills/3dviz-pro-max
# またはzipとして読み込み
claude --plugin-dir 3dviz-pro-max-0.1.0-plugin.zip

Codexの場合、フォルダをCodexのスキルディレクトリにコピーしてください。キャプチャステップのみPlaywright（Chromium用）およびオプションでBlender 4.2+が必要です；残りは通常のNodeで動作します。

デモの実行方法

cd examples
pnpm install          # Vite + Three.jsの依存関係をインストール
pnpm dev               # http://localhost:4180/<demo-id>/ を提供

各デモフォルダにはプロンプト、生成されたシーン、ソース参照、制限事項が含まれます。

一般的な利用シーン

• 迅速なプロトタイピング：1文でゲームレベルのアセットや科学的可視化を素早く構築。
• 教育：学生がLLMに概念を図示させ（例：「3:2の比を持つギアペアを表示」）、実際に操作可能なThree.jsモデルを受け取る。
• LLMの接地性評価：スキル内に組み込まれたリトリーバル・テストにより、エージェントが意図を観測可能なグラフィックスに変換できる程度を研究者が測定可能。

正直な制限

• このスキルはフレームをキャプチャするのみで、すべてのレシピが成功裏にレンダリングされることを保証しません。
• 知識記録は実行時の観測からではなく、編集的にレビューされています。
• タイアT4のブループリントは提供されていません；最高品質のアセットは2つのBlender焼き込みGLB（タイアT3）です。
• 評価スコアは条件ごとに1回の実行に基づくため、指示的であり、決定的ではありません。
• Playwright/ChromiumまたはBlenderがなければ、キャプチャステップは中断され、エージェントは欠落したフレームを報告する必要があります。

ライセンス – リポジトリのコード、データ、作成されたメディアはMITライセンス。サードパーティアセットはそれぞれのオリジナルライセンスを保持（例：BodyParts3DメッシュはCC BY‑SA 2.1 JP下）。

---

すべての詳細はリポジトリのREADMEから直接取得；外部の仮定は一切追加されていません。