Communityコーディング&開発github.com

blender-creation

物理的に校正され、関節を持ち、PBRテクスチャされた3D MuJoCoアセット(MJCF model.xml, .mjz, mjSpec)をヘッドレスBlender(bpy, bmesh, blender_mesh_utils, asset_build_utils)を使用してゼロから作成します。凸衝突判定の合成、10シナリオの監査、Studioプレビューを実施します。

blender-creation とは?

このスキルは、ヘッドレスBlender(bpy/bmesh)を活用して、MuJoCo物理シミュレータ用の高品質な3Dアセットをゼロから生成するためのエンドツーエンドパイプラインです。メインのビルダーサブエージェントと親会話が協調して動作し、ユーザーが提供した商品URL、画像、またはテキスト仕様から自動的にアセットを構築します。スキルは、参照画像の取り込み、フォームブリーフの作成、Blenderスクリプトによるモデリング、PBRテクスチャのベイク処理、凸衝突メッシュのエクスポート、MJCFモデルの組み立て、10シナリオの物理監査、そしてインタラクティブなMuJoCo Studioプレビューの起動までをカバーします。これにより、開発者は複雑なMuJoCoアセット作成プロセスを自然言語で指示するだけで、視覚的にも物理的にも正確なアセットを入手でき、シミュレーションやロボットタスクの開発を大幅に効率化できます。

対応✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/google-deepmind/robotics-antigravity-plugin/tree/HEAD/plugins/robotics/skills/blender-creation

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Blenderでのゼロからの3D MuJoCoアセット作成(bpy / bmesh + PBR)

[!IMPORTANT]

rules/mujoco_asset_standards.mdとの併用: まず[rules/mujoco_asset_standards.md][asset-standards]を読み、必須のMuJoCo座標系(UP_POSZ_FORWARD_POSX_RIGHT_NEGY)、SI単位ルール、グループ分け(group="2"ビジュアル、group="3"衝突、group="4"サイト)、および物理/監査要件を確認してください。このガイドでは、ヘッドレスBlender(PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P ...)、scripts/blender_mesh_utils.py(bmu)、scripts/asset_build_utils.py(abu)、mujoco-audit/SKILL.md、mujoco-showcase-shot/SKILL.md(render_showcase_shot.py)、およびmujoco-studio-sidecar/SKILL.mdを使用して、新しいアセットをゼロから調査、計測、モデリング、スカルプト、UVアンラップ、テクスチャリング、ベイク、エクスポート、検証、およびインタラクティブにプレビューする方法をカバーしています。これらのアセットは、MuJoCoのFilament PBRレンダラーおよびMuJoCo Studioで正確に見え、動作し、検査できるように設計されています。


1. エントリーポイント、サブエージェントオーケストレーション、ローカルBlenderセットアップ、参照情報の取り込み

1.0 呼び出し、デフォルト、サブエージェントオーケストレーション

ユーザーは、商品URL、参照画像、またはテキスト仕様を自然言語でこのスキルを呼び出します。

"これらのキッチントング用の3D MuJoCoアセットを構築してください:<url>" "blender-creationに従って、<画像/リンク>内のオブジェクトをモデリングしてください"

デフォルトとオプションのオーバーライド: デフォルトでは、スキルはエンドツーエンドのパイプライン(自動検出された関節、中間診断レンダリング、10シナリオの動的物理シミュレーション監査(§7.3)、および360° Filamentターンテーブルショーケースビデオ(§7.4))を実行します。ユーザーは、平易な英語または箇条書きでオプションのオーバーライドをリクエストできます。

  • Fast / No Turntable: ステップ7.4のショーケースビデオレンダリングをスキップします(レンダリング時間を節約)。
  • Rigid-Only: ジョイントを0に強制し、オブジェクトを単一の剛体として作成します。
  • Skip Physics Audit / Fast Audit: ステップ7.3の10シナリオ動的物理シミュレーションスイートをスキップします(ステップ7.1の静的衛生チェックと衝突アライメントチェックのみに依存)。
  1. あなたがトップレベル/親会話の場合:

    • ビルドと検証のために、Model: "inherit"のselfサブエージェントをinvoke_subagent経由で生成します。すべてのユーザー指定の指示、URL、オーバーライド、Parent Conversation ID: <parent_conv_id>、およびターゲットアセット出力親ディレクトリを渡し、サブエージェントにこのblender-creationスキル、[rules/mujoco_asset_standards.md][asset-standards]、mujoco-audit/SKILL.md、およびmujoco-showcase-shot/SKILL.mdを読むように指示します。サブエージェントに親会話のbrain/<parent_conv_id>/ディレクトリ内にスクラッチ/取り込みファイルを書き込むように指示しないでください(macOS Seatbeltサンドボックスは、PermissionErrorで会話間のbrain/アクセスをブロックします)。サブエージェントに独自の<ArtifactDir>/scratch/を使用させ、完成したアセットとプレビューパスを返させます。
    • サブエージェントが完了したとき: トップレベル会話でステップ7.6(mujoco-studio-sidecar/SKILL.md)に従い、MuJoCo Studio Webサイドカーデーモン(studiod.py)を完成したアセットディレクトリを指定して起動(または再利用)し(--workspace_dir=<asset_dir>)、/_studio/status("ok": true、"daemon_connected": true)を確認します。studiod.pyは、バックグラウンドデーモンがサブエージェント終了時に強制終了されないように、トップレベル会話から起動します。最終的な応答では、最初に完成したアセットパス、モデルサマリー(寸法、質量、ジョイント、ビジュアル/衝突の内訳、監査ステータス)、比較画像、ターンテーブルビデオ(Fast (No Turntable)でスキップされていない場合。リールが360°テクスチャ付きビジュアルスピンとそれに続く半透明の物理衝突ハル検査を示すことを1行のキャプションで簡単に記載)を提示し、応答の最後の項目として[MuJoCo Studio](sidecar://robotics/mujoco_studio/)(Nodeサイドカープロキシがアクティブでない場合はhttp://127.0.0.1:<http_port>/を$SESSION_FILEから取得)を配置して、インタラクティブなサイドカーピルが見逃されないようにします。
  2. あなたがすでに生成されたメインビルダーサブエージェントの場合:

    • ネストされたビルドサブエージェントを生成しないでください。セクション1.1から7.5を直接実行してください(ステップ1.1で、商品URLがクライアントサイドJSレンダリングを必要とする場合は、読み取り専用のbrowserサブエージェントを呼び出しても構いません)。すべてのスクラッチ/取り込みファイルは、このサブエージェント自身の<ArtifactDir>/scratch/に保持し、サンドボックス化されたrun_commandステップがPermissionErrorなしでローカルに読み取り/書き込みアクセスできるようにします。サブエージェント内でステップ7.6(studiod.py)を実行しないでください。代わりに、完成した<asset_dir>パス、モデルサマリー、比較画像、ターンテーブルビデオパスを親会話に返し、親会話がstudiod.pyを起動してStudioリンクを提示できるようにします。
    • uvとヘッドレスBlender(4.2+)がローカルにインストールされていることを確認する(macOS & Linux):
      uv --version
      if [ -x "/Applications/Blender.app/Contents/MacOS/Blender" ]; then
        BLENDER_BIN="/Applications/Blender.app/Contents/MacOS/Blender"
      else
        BLENDER_BIN="blender"
      fi
      "$BLENDER_BIN" --version || (sudo apt-get update && sudo apt-get install -y blender)
      
      BlenderスクリプトをPYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P <ArtifactDir>/scratch/build_asset.pyで実行し、Blenderスクリプト内で<PLUGIN_DIR>/skills/blender-creation/scriptsをsys.pathに追加してimport blender_mesh_utils as bmuします。
    • MuJoCoコンパイル、Filamentショーケースレンダリング、参照情報の取り込み(uv run):
      uv run --with mujoco --with numpy --with scipy --with trimesh --with Pillow \
        python3 <ArtifactDir>/scratch/script.py
      
      スクラッチスクリプト内で、プラグインスクリプトディレクトリ(<PLUGIN_DIR>/skills/blender-creation/scripts、<PLUGIN_DIR>/skills/mujoco-audit/scripts、<PLUGIN_DIR>/skills/mujoco-showcase-shot/scripts)をsys.pathに追加して、import asset_build_utils as abu、import audit_scenarios、import render_showcase_shotします。
    • スコープとワークスペースの衛生:
      • デフォルトでaudit_scenariosの10シナリオ物理ドロップ/チップ/グラスプシミュレーション(ステップ7.3)を実行し、すべてのシナリオが合格することを確認します(または、mujoco-audit/SKILL.mdに従って失敗したチェックを修正します)。ユーザーが明示的にSkip Physics AuditまたはFast Auditを指定した場合のみ、動的シミュレーションをスキップします。リクエストがない限り、2番目の<asset_name>_mechanical/バンドルは生成しないでください。クリーンな静的MjModelコンパイル、ゼロ裏面法線(abu.render_blender_diagnostic_sheet)、衝突アライメント(audit_scenarios.compute_collision_alignment_summary)、キネマティックジョイントポーズ(Articulations: Auto)、およびすべての動的物理ドロップ/チップ/セトルシナリオを検証します。
      • すべてのスクラッチスクリプト、ダウンロードした参照写真、中間メッシュ、診断用.jpg/.pngシート、.blendファイル、仮想環境(.venv)、キャッシュを<ArtifactDir>/scratch/、~/.venvs/、~/.cache/mujoco_pbr_cacheに保持します。最終的なアセット成果物(model.xml、meshes/*.obj、textures/*.png)のみをターゲットアセットディレクトリに書き込み、.pyc / __pycache__、.venv、またはstudiodのスキャフォールド/ランタイムファイルをアセットディレクトリに書き込まないでください。
    • ノブオーバーライドを尊重します: Articulations: Rigid-Only -> 0ジョイント; Depth: Fast (No Turntable) -> ステップ7.4をスキップ; Skip Physics Audit / Fast Audit -> ステップ7.3をスキップ。

1.1 取り込み、参照コンタクト/詳細シート、フォームブリーフ

  1. 商品URLと参照情報の取り込み(<= 8 画像読み取り):
    • URLパススラッグから製品の同一性、カテゴリ、寸法を推測しないでください(例:/Walnut-Elegant-Design-Coffee-Products/dp/...はコーヒーテーブルではなく、切り詰められたSEOスラッグである可能性があります)。
    • 商品URLが提供された場合:
      1. ユーザーに代わって、読み取り専用のbrowserサブエージェントを呼び出し、<product_url>に移動します。人間のデザイナーが行うように、ライブレンダリングされたページを検査します。
        • 検証済みの製品タイトル、素材、メカニズムの説明、寸法仕様(mm単位のL × W × Hと裸製品質量のkg。小売りのItem Weightとパッケージ出荷重量をクロスチェック)を抽出します。
        • 高解像度の製品ギャラリー/カルーセル画像URLを特定します。
      2. アクセスがインタラクティブなCAPTCHAまたはセキュリティゲートによってブロックされた場合: ゲートを回避しようとせずに停止し、ユーザーに製品の寸法、仕様、または参照写真を直接尋ねます。
      3. 収集した高解像度ギャラリー画像を<ArtifactDir>/scratch/intake/ref_*.jpgにダウンロードします(例:curlまたは最小限のインラインダウンロードスクリプトを使用)。
    • URLが提供されていない場合(テキストのみのクエリ): search_webを介して裸製品のL x W x H(mm)と質量(kg)を検索します(search_webがスニペットなしのベアリダイレクトリンクのみを返す場合は、browserサブエージェントを呼び出します)。小売りのItem Weightを寸法と素材密度とクロスチェックします。
    • コンポジットシート(<= 8 画像読み取り): 数十の個別フレームに対してread_fileを呼び出さないでください。ダウンロードしたref_*.jpg写真とサブフィーチャーのクロップをabu.build_ref_contact_and_detail_sheetsを介してref_contact_sheetとref_details_gridにステッチし、それらのコンポジットシートをread_fileで検査します。
  2. 参照クロップからの直接的な測光RGBパーセンタイルサンプリング(rgb_sample_boxes):
    • 口頭でのカテゴリ名("赤いプラスチック"、"黒いゴム"、"緑のぬいぐるみ")からRGB値を発明しないでください。rgb_sample_boxes=[('main_shell', ref_path, (x0, y0, x1, y1)), ...]をabu.build_ref_contact_and_detail_sheetsに渡して、均一な内部表面パッチ(鏡面ハイライトとキャストシャドウを除く)から直接[p25, p50, p75] sRGBタプルを測定します。
  3. <= 25行のフォームブリーフと名前付きパラメータブロックP(<= 40 名前付き寸法)を書く:
    • Blender bmeshコードを書く前に、簡潔なフォームブリーフを書き、名前付きパラメータディクショナリP = dict(...)(<= 40 のmm / mとdeg単位の名前付き寸法。出典コメント付き)を定義します。何百ものマジック座標タプルをハードコーディングしないでください。
      • 名前付き主要サーフェスとそれらの結合方法: サイドシルエットファセット/角度、平面図テーパー、クラウン断面、パーツ間のネガティブスペース/オープンデイライトギャップ、および面一 vs. 段差のある接合部。
      • 左右(+Y vs. -Y)および前後(+X vs. -X)の非対称性: どのレバー、クリップ、ボタン、ラベル、またはポートが各側に現れるかを明示的に記述します。
      • 素材領域とパーティングライン: 例:リジッドABSが内部コアと露出した面一リムを形成し、マットTPEが外側のグリップスキンを形成するツーショットオーバーモールド、または凹型ブランディングポケット。
      • メカニズムと可動域: 移動するサブパーツ(ヒンジ付き蓋、スライダー、クリップ、ブレード、ボタン、ノブ)と、それらの実際の物理ピボット/軸、mまたはradでの可動域。

2. ツールリファレンスとターゲットレンダラールール

2.1 クイックヘルパーAPIリファレンス(blender_mesh_utils、asset_build_utils、render_showcase_shot)

  • blender_mesh_utils as bmu (ヘッドレスBlinner "$BLENDER_BIN" -b -P内、scripts/blender_mesh_utils.pyより):
    • bmu.clear_scene() -> None
    • bmu.assign_pbr_material(objects, name=None, *, base_color=None, base_color_srgb=(200, 200, 200), roughness=0.4, metallic=0.0, normal_bump_mm=0.0, bump_height_mm=0.0, bump_scale=250.0) -> bpy.types.Material
    • bmu.skin_skeleton(name, nodes_xyzr, edges=None, *, subsurf_levels=2) -> obj
    • bmu.metaball_sdf(name, elements, *, resolution=0.002) -> obj
    • bmu.swept_tube(name, points_xyzr, *, bevel_resolution=6) -> obj
    • bmu.voxel_smooth_union(name, objects, *, voxel_size=0.0015, smooth_iterations=6) -> obj
    • bmu.apply_boolean_cutter(target_obj, cutter_obj, *, operation='DIFFERENCE', solver='MANIFOLD') -> obj
    • bmu.smart_seam_unwrap(target_obj, *, angle_limit_deg=66.0, margin=0.005) -> obj
    • bmu.smart_uv_project(objects, *, angle_limit_deg=66.0, island_margin=0.01, margin=None) -> list[obj]
    • bmu.pack_shared_uv_atlas(objs, *, margin=0.005, rotate=True, align_minimal_bbox=True, match_3d_area=True) -> None
    • bmu.finalize_and_export_obj(target_obj, out_obj_path, *, crease_deg=None, world_pos=None, body_pos=None, ensure_uvs=True) -> {'verts', 'quads', 'tris', 'earclipped_ngons'}
    • bmu.export_convex_hull_col(source_obj_or_points, out_obj_path, *, clip_bounds_world_m=None, clip_bounds_m=None, max_verts=64, name=None, world_pos=(0,0,0), body_pos=None) -> col_obj
    • bmu.bake_pbr_maps(out_dir, *, material_groups=None, resolution=1024, samples=8) -> {key: {'basecolor', 'roughness', 'metallic', 'normal'}}
  • asset_build_utils as abu (uv runスクリプト内、scripts/asset_build_utils.pyより):
    • abu.build_ref_contact_and_detail_sheets(ref_paths, detail_crops, out_contact_png, out_details_png, *, raw_crops_dir=None, rgb_sample_boxes=None, cols=3, cell_size=440, include_shadow_lift=False) -> dict
    • abu.fetch_ambientcg_maps(asset_id, *, cache_dir=None, resolution='1K') -> {'color', 'roughness', 'normal_gl', 'metallic', 'ao', 'opacity', ...}
    • abu.rasterize_uv_world_fields(obj_paths, canvas_size=1024, *, part_offsets=None) -> dict
    • abu.dilate_uv_gutters(arr, valid_mask, *, max_dist_px=12) -> np.ndarray
    • abu.triplanar_project_map(map_2d, xyz, world_normal, *, texels_per_meter=4000.0, sharpness=4.0) -> np.ndarray
    • abu.height_to_normal_rgb(height_map, strength=3.5, *, smooth_sigma=0.0, valid_mask=None) -> (H,W,3) uint8
    • abu.normal_rgb_from_3d_height_fn(height_fn, uv_world_fields, *, step_mm=0.15, strength=1.0) -> (H,W,3) uint8
    • abu.fbm_noise_3d(xyz, *, base_freq=25.0, wavelength_mm=None, octaves=4, per

…

[truncated for translation]

関連スキル