blender-creation

Crée des actifs 3D MuJoCo complets (calibrés physiquement, articulés, texturés PBR) à partir de zéro en utilisant Blender sans interface graphique (bpy, bmesh).

Qu'est-ce que blender-creation ?

Cette compétence permet à un agent IA de générer des actifs 3D pour MuJoCo à partir d'une simple URL, d'une image ou d'une description textuelle. Le pipeline complet est exécuté de manière autonome : recherche de références, modélisation précise avec Blender en mode headless, création de textures PBR, assemblage du fichier MJCF et audit physique rigoureux. L'agent orchestre plusieurs sous-agents spécialisés pour la modélisation, l'audit et le rendu de présentation, garantissant que l'actif final respecte les standards de coordonnées et d'unités SI de MuJoCo. Les utilisateurs peuvent demander des variantes comme une version rigide ou un audit accéléré, et le résultat inclut un lien interactif vers MuJoCo Studio pour une inspection visuelle immédiate.

Compatible avec✓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 Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Création d'Actifs 3D MuJoCo à partir de Zéro dans Blender (bpy / bmesh + PBR)

[!IMPORTANT]

Document complémentaire à rules/mujoco_asset_standards.md : Lisez d'abord rules/mujoco_asset_standards.md pour les règles obligatoires concernant le repère de coordonnées MuJoCo (UP_POSZ_FORWARD_POSX_RIGHT_NEGY), les unités SI, la séparation des groupes (group="2" visuel, group="3" collision, group="4" sites), et les exigences de physique/audit. Ce guide couvre la façon de rechercher, mesurer, modéliser, sculpter, déplier UV, texturer, cuire, exporter, vérifier et prévisualiser de nouveaux actifs à partir de zéro en utilisant Blender sans interface graphique (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), et mujoco-studio-sidecar/SKILL.md afin qu'ils aient un aspect, un comportement et une inspection précis dans le rendu Filament PBR de MuJoCo et MuJoCo Studio.


1. Point d'Entrée, Orchestration des Sous-Agents, Configuration Locale de Blender & Réception des Références

1.0 Invocation, Paramètres par Défaut & Orchestration des Sous-Agents

Les utilisateurs invoquent cette compétence en langage naturel avec une URL de produit, une(des) image(s) de référence ou des spécifications textuelles :

"Construis un actif 3D MuJoCo pour ces pinces de cuisine : <url>" "Suis blender-creation pour modéliser l'objet dans <image/lien>"

Paramètres par Défaut & Surcharges Optionnelles : Par défaut, la compétence exécute le pipeline complet de bout en bout : détection automatique des articulations, rendus de diagnostic intermédiaires, simulation physique dynamique sur 10 scénarios (§7.3) et une vidéo de présentation tournante Filament à 360° (§7.4). Les utilisateurs peuvent éventuellement demander des surcharges en anglais simple ou par points :

  • Fast / No Turntable : Ignore l'étape 7.4 de rendu vidéo de présentation (économise du temps de rendu).
  • Rigid-Only : Force 0 articulations, créant l'objet comme un seul corps rigide.
  • Skip Physics Audit / Fast Audit : Ignore la suite de simulation physique dynamique sur 10 scénarios de l'étape 7.3 (en se fiant uniquement aux vérifications d'hygiène statique et d'alignement des collisions de l'étape 7.1).
  1. Si vous êtes la conversation parente / de premier niveau :

    • Créez un sous-agent self (Model: "inherit") via invoke_subagent pour construire et vérifier l'actif, en transmettant toutes les instructions, URLs et surcharges spécifiées par l'utilisateur, l'ID de la conversation parente : <parent_conv_id>, et le répertoire parent de sortie de l'actif cible, et en instruisant le sous-agent de lire cette compétence blender-creation, rules/mujoco_asset_standards.md, mujoco-audit/SKILL.md, et mujoco-showcase-shot/SKILL.md. N'instruisez pas le sous-agent d'écrire des fichiers d'ébauche/d'entrée dans le répertoire brain/<parent_conv_id>/ de la conversation parente (le sandboxing macOS Seatbelt bloque l'accès brain/ entre conversations avec PermissionError) ; laissez le sous-agent utiliser son propre <ArtifactDir>/scratch/ et renvoyer les chemins de l'actif fini et de l'aperçu.
    • Quand le sous-agent a terminé : Suivez l'étape 7.6 (mujoco-studio-sidecar/SKILL.md) dans la conversation de premier niveau pour lancer (ou réutiliser) le démon sidecar Web MuJoCo Studio (studiod.py) pointant vers le répertoire de l'actif terminé (--workspace_dir=<asset_dir>) et vérifiez /_studio/status ("ok": true, "daemon_connected": true). Lancez studiod.py depuis la conversation de premier niveau plutôt qu'à l'intérieur du sous-agent constructeur afin que le démon d'arrière-plan ne soit pas terminé lorsque le sous-agent se ferme. Dans votre réponse finale, présentez d'abord le chemin de l'actif terminé, le résumé du modèle (dimensions, masse, articulations, répartition visuelle/collision, statut d'audit), la comparaison côte à côte et la vidéo de présentation (sauf si ignorée via Fast (No Turntable), en notant brièvement dans une légende d'une ligne que la bobine montre une rotation visuelle texturée complète à 360° suivie d'une inspection translucide de l'enveloppe de collision physique), et placez [MuJoCo Studio](sidecar://robotics/mujoco_studio/) (plus http://127.0.0.1:<http_port>/ depuis $SESSION_FILE si le proxy sidecar Node n'est pas actif) comme tout dernier élément en bas de votre réponse afin que la pilule sidecar interactive ne soit jamais manquée en haut.
  2. Si vous êtes déjà le Sous-Agent Constructeur Principal créé :

    • Ne créez pas de sous-agent constructeur imbriqué—exécutez les sections 1.1 à 7.5 directement (vous pouvez toujours invoquer le sous-agent browser en lecture seule pendant l'étape 1.1 si une URL de produit nécessite un rendu JS côté client). Conservez tous les fichiers d'ébauche/d'entrée dans le propre <ArtifactDir>/scratch/ de ce sous-agent afin que les étapes run_command sandboxées aient un accès local en lecture/écriture sans PermissionError. N'exécutez pas l'étape 7.6 (studiod.py) à l'intérieur du sous-agent ; renvoyez plutôt le chemin <asset_dir> de l'actif terminé, le résumé du modèle, les images de comparaison et le chemin de la vidéo de présentation à la conversation parente afin que la conversation parente lance studiod.py et présente le lien Studio.
    • Assurez-vous que uv et Blender sans interface graphique (4.2+) sont installés localement (macOS et 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)
      
      Exécutez les scripts Blender avec PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P <ArtifactDir>/scratch/build_asset.py et ajoutez <PLUGIN_DIR>/skills/blender-creation/scripts à sys.path à l'intérieur du script Blender pour import blender_mesh_utils as bmu.
    • Compilation MuJoCo, Rendu de Présentation Filament & Réception des Références (uv run) :
      uv run --with mujoco --with numpy --with scipy --with trimesh --with Pillow \
        python3 <ArtifactDir>/scratch/script.py
      
      À l'intérieur de votre script d'ébauche, ajoutez les répertoires des scripts du plugin (<PLUGIN_DIR>/skills/blender-creation/scripts, <PLUGIN_DIR>/skills/mujoco-audit/scripts, et <PLUGIN_DIR>/skills/mujoco-showcase-shot/scripts) à sys.path pour importer asset_build_utils as abu, audit_scenarios, et render_showcase_shot.
    • Périmètre & Hygiène de l'Espace de Travail :
      • Exécutez les simulations physiques de chute/bascule/préhension sur 10 scénarios audit_scenarios (Étape 7.3) par défaut, en vérifiant que tous les scénarios réussissent (ou en corrigeant les vérifications échouées en suivant mujoco-audit/SKILL.md). Ne sautez les simulations dynamiques que si l'utilisateur spécifie explicitement Skip Physics Audit ou Fast Audit. Ne générez pas de deuxième bundle <asset_name>_mechanical/ sauf demande explicite. Vérifiez la compilation MjModel statique propre, les normales arrière nulles (abu.render_blender_diagnostic_sheet), l'alignement des collisions (audit_scenarios.compute_collision_alignment_summary), les poses d'articulation cinématiques (Articulations: Auto), et tous les scénarios dynamiques de chute/bascule/établissement.
      • Conservez tous les scripts d'ébauche, photos de référence téléchargées, maillages intermédiaires, feuilles de diagnostic .jpg/.png, fichiers .blend, environnements virtuels (.venv), et caches dans <ArtifactDir>/scratch/, ~/.venvs/, et ~/.cache/mujoco_pbr_cache. Écrivez uniquement les livrables finaux de l'actif (model.xml, meshes/*.obj, textures/*.png) dans le répertoire de l'actif cible, et n'écrivez jamais .pyc / __pycache__, .venv, ou les fichiers d'échafaudage/d'exécution studiod dans le répertoire de l'actif.
    • Honorez les surcharges de réglage : Articulations: Rigid-Only -> 0 articulations ; Depth: Fast (No Turntable) -> ignorez l'étape 7.4 ; Skip Physics Audit / Fast Audit -> ignorez l'étape 7.3.

1.1 Réception, Fiches de Contact/Référence & Cahier des Charges

  1. Réception URL Produit & Références (<= 8 Lectures d'Images) :
    • Ne devinez jamais l'identité, la catégorie ou les dimensions du produit à partir d'un slug de chemin d'URL (par exemple, /Walnut-Elegant-Design-Coffee-Products/dp/... peut être un slug SEO tronqué plutôt qu'une table basse).
    • Lorsqu'une URL de produit est fournie :
      1. Invoquez le sous-agent browser en lecture seule pour naviguer vers <product_url> au nom de l'utilisateur. Inspectez la page rendue en direct comme le ferait un designer humain :
        • Extrayez le titre vérifié du produit, les matériaux, les descriptions de mécanisme et les spécifications dimensionnelles (L × l × H en mm et masse nue du produit en kg, en recoupant le Poids de l'article du commerce de détail par rapport au poids d'expédition emballé).
        • Identifiez les URLs des images de la galerie / du carrousel haute résolution du produit.
      2. Si l'accès est bloqué par un CAPTCHA interactif ou une passerelle de sécurité : arrêtez-vous sans tenter de contourner la passerelle et demandez directement à l'utilisateur les dimensions, spécifications ou photos de référence du produit.
      3. Téléchargez les images de galerie haute résolution collectées dans <ArtifactDir>/scratch/intake/ref_*.jpg (par exemple en utilisant curl ou un script de téléchargement minimal en ligne).
    • Lorsqu'aucune URL n'est fournie (requête textuelle uniquement) : Recherchez les dimensions L x l x H (mm) et la masse (kg) nues du produit via search_web (ou invoquez le sous-agent browser si search_web renvoie uniquement des liens de redirection sans extraits). Recoupez le Poids de l'article du commerce de détail par rapport aux dimensions et à la densité du matériau.
    • Fiches composites (<= 8 Lectures d'Images) : N'appelez jamais read_file sur des dizaines d'images individuelles. Assemblez les photos ref_*.jpg téléchargées et les recadrages de sous-caractéristiques en ref_contact_sheet et ref_details_grid via abu.build_ref_contact_and_detail_sheets, puis inspectez ces fiches composites avec read_file.
  2. Échantillonnez directement les centiles RVB photométriques à partir des recadrages de référence (rgb_sample_boxes) :
    • N'inventez pas de valeurs RVB à partir de noms de catégories verbaux ("plastique rouge", "caoutchouc noir", "peluche verte"). Passez rgb_sample_boxes=[('main_shell', ref_path, (x0, y0, x1, y1)), ...] à abu.build_ref_contact_and_detail_sheets pour mesurer les tuples sRGB [p25, p50, p75] directement à partir de patchs de surface intérieure uniformes (en excluant les points chauds spéculaires et les ombres projetées).
  3. Rédigez un Cahier des Charges de <= 25 Lignes & un Bloc de Paramètres Nommés P (<= 40 Dimensions Nommées) :
    • Avant d'écrire du code Blender bmesh, rédigez un Cahier des Charges concis et définissez un dictionnaire de paramètres nommés P = dict(...) (<= 40 dimensions nommées en mm / m et deg avec des commentaires de provenance) plutôt que de coder en dur des centaines de tuples de coordonnées magiques :
      • Surfaces primaires nommées et leur jonction : facettes/angles de silhouette latérale, inclinaison en vue de dessus, section transversale de la couronne, espaces négatifs / interstices de lumière du jour entre les pièces, et jonctions affleurantes ou étagées.
      • Asymétrie gauche/droite (+Y vs. -Y) et avant/arrière (+X vs. -X) : notez explicitement quels leviers, clips, boutons, étiquettes ou ports apparaissent de chaque côté.
      • Régions de matériau et lignes de séparation : par exemple, surmoulage bi-matière où l'ABS rigide forme le noyau interne et les bords affleurants exposés tandis que le TPE mat forme la peau de préhension externe, ou les poches de marquage en retrait.
      • Mécanismes et course : sous-parties mobiles (couvercles articulés, curseurs, clips, lames, boutons, molettes) avec un véritable pivot/axe physique et une course en m ou rad.

2. Référence des Outils & Règles du Rendu Cible

2.1 Référence Rapide de l'API des Assistants (blender_mesh_utils, asset_build_utils, render_showcase_shot)

  • blender_mesh_utils as bmu (à l'intérieur de Blender sans interface graphique "$BLENDER_BIN" -b -P, depuis 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 (à l'intérieur des scripts uv run, depuis 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

Skills associés