Communitygithub.com

Blender モーション状態検査

Blender キャラクターのリグ、ポーズ、アニメーションリターゲティング、接地、向き、モデルとモーションの整合性を、スクリーンショットだけでは不十分な場合に詳細に検査するスキルです。

Blender モーション状態検査 とは?

このスキルは、Blender で制作された3Dキャラクターのアニメーションやリグの状態を体系的に検査するためのものです。スクリーンショットだけでは判断できない、ボーンの軸設定、オブジェクトスケール、ローカルトランスフォーム、フレームごとの接地状態などの構造化された情報を抽出し、問題の診断と修正の方針を明確にします。具体的なワークフローとして、シーン内のオブジェクトの棚卸し、スケルトンの特定、進行方向の判定、アニメーションフレームのサンプリング、モデル整合性の確認、接地や接触の問題の診断を段階的に行います。最終的には、根拠のある事実に基づいたレポートを生成し、パス/フェイル判定、必要な修正、レンダリング準備状態を明確にします。このスキルはClaude Code等のAIエージェントが、Blenderプロジェクトの品質管理やトラブルシューティングを自動化する際に役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/503496348-ops/mischief-production/tree/HEAD/skills/ecc-blender-motion-state-inspection

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

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

ドキュメント

Blender モーション状態検査 は何をしますか?

使用タイミング

  • Blender のキャラクターがアニメーション中にねじれ、反転、押しつぶし、ずれ、または足の滑りを起こしているように見える場合。
  • ユーザーが、インポートしたアバター、アーマチュア、またはリターゲットしたモーションが期待するポーズと一致しているかどうかを尋ねる場合。
  • レンダリング結果と、ボーン、バウンディングボックス、接触点、向きベクトルなどの構造化された事実を比較する必要がある場合。
  • ワークフローが、モデルがキャラクター、プロップ、プロキシメッシュ、コントロールリグ、または破損したインポートのいずれであるかを判断することに依存している場合。

基本原則

アニメーション付きの3Dアセットをスクリーンショットだけで判断しないでください。スクリーンショットはレビューの証拠にはなりますが、軸の規則、ボーン名、オブジェクトスケール、ローカルトランスフォーム、ペアレント化されたメッシュ、マテリアルスロット、フレームごとの接触状態などは隠されています。

最初に Blender の構造化された状態を抽出し、次にビューポートのスクリーンショットやレンダリングを使用して、事実が示唆する内容を確認します。

仕組み

  1. モーションを判断する前に、クリーンなシーンとアセットのベースラインを確立します。
  2. エクスポーターまたは Blender 自身のインタプリタ内で実行する Blender Python を使用して、Blender から構造化された事実を抽出します。
  3. 接触、向き、スケール、リターゲティングエラーが最も発生しやすいと思われるフレームをサンプリングします。
  4. 測定された事実を、ユーザーの期待するポーズ、方向、地面、レンダリング目標と比較します。
  5. 確認された事実、考えられる原因、必要な修正を明確に分けた簡潔なレポートを返します。

検査ワークフロー

  1. シーンを棚卸しする。

    • メッシュ、アーマチュア、エンプティ、カメラ、ライト、モディファイア、ペアレント関係、非表示オブジェクトをリストアップする。
    • アバターを判断する前に、キャラクターメッシュをヘルパー/プロキシジオメトリから分離する。
    • オブジェクト空間とワールド空間のバウンディングボックスを記録する。
  2. スケルトンを特定する。

    • アーマチュア名、ポーズボーン、ボーンヘッド/テール、ロール、ペアレントチェーン、コンストレイント、およびリストポーズの軸を取得する。
    • 腰、背骨、首、頭、肩、肘、手、太もも、膝、足首、足などの意味的なボーンをマッピングする。
    • 左右のペアがないことや異常な命名規則にフラグを立てる。
  3. 前方、上方、側方の軸を決定する。

    • 骨盤、背骨、肩、腰、頭、足を一緒に使用する。単一のメッシュ法線に依存しないこと。
    • ローカルアーマチュア軸をワールド軸およびインポートされたファイルの規則(glTF の Y-up vs Blender の Z-up など)と比較する。
    • 顔/頭/足の方向がルートモーションと競合する場合、反転または逆向きでインポートされた可能性にフラグを立てる。
  4. アニメーションフレームをサンプリングする。

    • 最初、中間、接触、空中、および極端なフレームを検査する。
    • ルート位置、ルートの向き、骨盤の高さ、体幹の傾き、手足の方向、足のクリアランス、メッシュ範囲を記録する。
    • 長いモーションや速いモーションの場合は、反転、着地、方向転換、衝突、床接触の周辺をより密にサンプリングする。
  5. リターゲティングを非難する前にモデルの整合性を確認する。

    • アニメーションを適用する前に、クリーンなベースライン形状を確認する。
    • ユーザーが明示的に修復を要求しない限り、元のメッシュ、マテリアル、アーマチュア、スキニングを保持する。
    • 説明できない球形の塊、巨大なプロキシメッシュ、押しつぶされたボディは、そうでないと証明されるまでインポート/選択の問題として扱う。
  6. 接触とモーションの問題を診断する。

    • 地面へのめり込み: フレームごとに、最も低い足または靴の頂点と床の高さを比較する。
    • 足の滑り: 接地しているフレーム間での足のワールド位置を比較する。
    • 脚の交差: 左右の太もも、膝、足首、足の側面の順序を比較する。
    • ねじれ損傷: ボーンのスイング方向を、手足軸周りのロール/ツイストと別々に比較する。
    • スケールドリフト: アニメーション付きメッシュの範囲をクリーンなベースライン範囲と比較する。
  7. 意見の前に事実を報告する。

    • フレーム番号、オブジェクト名、ボーン名、ワールド座標、しきい値を含める。
    • 確認された失敗と視覚的な疑念を分ける。
    • 構造化された状態が何を探すべきかを説明した後にのみ、スクリーンショットを添付する。

推奨レポート形式

## Blender モーション検査

### シーン在庫
- キャラクター候補:
- アーマチュア:
- ヘルパー/プロキシオブジェクト:
- カメラ/ライト:

### 向き
- ワールド上方:
- キャラクター前方:
- ルートの向き:
- 反転/逆向きのリスク:

### ベースラインの整合性
- クリーンメッシュ範囲:
- アニメーションメッシュ範囲:
- マテリアル/スキンが保持されているか:
- 疑わしい非キャラクターメッシュ:

### フレーム所見
| フレーム | 所見 | 証拠 |
| --- | --- | --- |
| 1 | クリーンベースラインポーズ | hips/spine/feet が整列 |
| 96 | 足が床にめり込む | left_foot min_z = -0.04 |

### 判定
- 合格/不合格:
- 必要な修正:
- レンダリング準備状態:

例

足の滑りを伴う歩行サイクル

シナリオ: リターゲットされたキャラクターが歩行サイクル中に滑っているように見えるが、正面からのカメラアングルでは足の接触が判断しにくい。

ワークフローを適用する:

  • シーンを棚卸し: キャラクターメッシュ HeroBody、アーマチュア HeroRig、地面 Floor、非表示のプロキシメッシュなし。
  • スケルトンを特定: 意味的な足は foot.L と foot.R、腰は pelvis、ルートボーンは root。
  • アニメーションフレームをサンプリング: 接地している足の瞬間の周辺でフレーム 1、18、24、30、42、48 を検査。
  • 接触とモーションの問題を診断: 接地しているフレーム間での足のワールド空間位置を比較。

抽出された事実:

フレーム事実証拠
18左足が接地しているfoot.L min_z = 0.004、つま先とかかとの両方が床付近
24接地中に左足が滑る6フレーム間で foot.L x = 0.21 -> 0.28
30骨盤が前進し続けるpelvis y = 1.14 -> 1.31

判定: レンダリング準備状態は不合格。モーションにはフットロックのクリーンアップまたはリターゲティングコンストレイントの見直しが必要。ボディメッシュのプロポーション変更は不要。

逆向きにインポートされたキャラクター

シナリオ: キャラクターは静止フレームでは正しく見えるが、アニメーションは期待される移動方向と逆に動く。

ワークフローを適用する:

  • 前方、上方、側方の軸を決定: 頭、胸、足、ルートモーションを比較。
  • アニメーションフレームをサンプリング: フレーム 1 と移動経路の中間点を検査。
  • 意見の前に事実を報告: ルートの向きとモデルの向いている方向を別々に含める。

抽出された事実:

フレーム事実証拠
1キャラクターの顔がワールド -Y を向いているneck から head へのベクトルが -Y に解決される
72ルートモーションがワールド +Y へ移動root y = 0.0 -> 2.8
72足は視覚的に移動方向と逆向きを保つつま先ボーンは -Y を指し、変位は +Y

判定: インポートまたはリターゲティングの前方軸不一致の可能性が高い。アニメーションカーブを編集する前に、インポート/リターゲットの軸マッピングを修正すること。

実用的なしきい値

  • シーンの単位スケールが別途指定されていない限り、Blender のデフォルトのメートル単位を想定する。
  • 地面へのめり込みが 1~2 cm を超える場合は、床が柔らかいか意図的にスタイリングされていない限り、可視とみなす。
  • スケールの急激な変化が 5% を超える場合は、リグ、コンストレイント、またはトランスフォーム継承の問題の可能性が高いとみなす。
  • 空中での反転モーション中に左右の足首の側面順序が入れ替わる場合は、後に回復しても脚交差のリスクとして扱う。
  • ルートの向きが1フレームあたり30度を超えてジャンプする場合は、ソースモーションにスナップターンが含まれていない限り疑わしいとみなす。

アンチパターン

  • 明示的にメッシュ修復タスクでない限り、ポーズを合わせるためにボディプロポーションを変更しない。
  • クリーンベースラインを記録する前にベイクしてしまわない。
  • 単一のレンダリングカメラアングルをポーズが正しい証明として使用しない。
  • ヘルパーオブジェクトがキャラクターの一部ではない理由を記録するまで、削除しない。
  • 頭、足、体幹、ルートモーションを一緒に確認せずに、アバターが +Y、-Y、+X、-X を向いていると想定しない。

ツールに関する注意

Blender の状態エクスポーターが利用可能な場合は、メッシュ、アーマチュア、ポーズボーン、マテリアル、接触点、バウンディングボックス、サンプリングされたアニメーションフレームを含む JSON を優先してください。エクスポーターがない場合は、Blender 自体を通じて小さな Blender Python スクリプトを実行します。例: blender --background scene.blend --python collect_motion_state.py (bpy は通常のシステム Python インタプリタでは利用できないため)。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

503496348-ops/mischief-production

Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider HCP video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.

503496348-ops/mischief-production

Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.

503496348-ops/mischief-production

Motion tokens, spring presets, performance rules, device adaptation, accessibility enforcement, and SSR safety for React / Next.js using motion/react. Foundation layer — all other motion skills depend on this.

503496348-ops/mischief-production

Production-ready animation patterns for React / Next.js — button, modal, toast, stagger, page transitions, exit animations, scroll, and layout — built on motion-foundations tokens and springs.

503496348-ops/mischief-production

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

503496348-ops/mischief-production

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

503496348-ops/mischief-production

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

関連スキル