---

name: blender-motion-state-inspection description: Use this skill when inspecting Blender characters, rigs, poses, animation retargeting, ground contact, facing direction, or model-vs-motion alignment where screenshots alone are not enough. origin: ECC tools: Read, Write, Edit, Bash, Grep, Glob

Blender 运动状态检查

何时使用

• Blender 角色在动画中看起来扭曲、镜像、压扁、偏移或脚部滑动。
• 用户询问导入的虚拟形象、骨架或重定向动作是否匹配预期姿势。
• 你需要将渲染证据与结构化事实（如骨骼、包围盒、接触点和朝向向量）进行比较。
• 工作流需要判断模型是角色、道具、代理网格、控制骨架还是损坏的导入。

核心原则

不要仅从截图判断动画 3D 资产。截图是审查证据，但它们隐藏了轴约定、骨骼名称、对象缩放、局部变换、父级网格、材质槽和逐帧接触状态。

首先从 Blender 提取结构化状态，然后使用视口截图或渲染来确认事实所暗示的内容。

工作原理

1. 在判断运动之前建立干净的场景和资产基线。
2. 使用导出器或在 Blender 自身解释器中运行的 Blender Python 从 Blender 提取结构化事实。
3. 采样最可能暴露接触、方向、缩放和重定向错误的帧。
4. 将测量的事实与用户预期的姿势、方向、地面平面和渲染目标进行比较。
5. 返回简洁的报告，将已确认的事实、可能的原因和所需的修复分开。

检查工作流

1. 清点场景。

   • 列出网格、骨架、空对象、相机、灯光、修改器、父级关系和隐藏对象。
   • 在判断虚拟形象之前，将角色网格与辅助/代理几何体分开。
   • 记录对象空间和世界空间包围盒。

2. 识别骨骼系统。

   • 捕获骨架名称、姿势骨骼、骨骼头/尾、滚动、父级链、约束和静止姿势轴。
   • 映射语义骨骼，如臀部、脊柱、颈部、头部、肩膀、肘部、手部、大腿、膝盖、脚踝和脚部。
   • 标记缺失的左/右对和不寻常的命名方案。

3. 确定前方、上方和侧方轴。

   • 综合使用骨盆、脊柱、肩膀、臀部、头部和脚部；不要依赖单个网格法线。
   • 将局部骨架轴与世界轴和导入文件约定（如 glTF Y-up 与 Blender Z-up）进行比较。
   • 当面部/头部/脚部方向与根运动冲突时，标记可能的镜像或反向导入。

4. 采样动画帧。

   • 检查第一帧、中间帧、接触帧、空中帧和极端帧。
   • 记录根位置、根朝向、骨盆高度、躯干倾斜、肢体方向、脚部间隙和网格边界。
   • 对于长时间或快速运动，在翻转、着陆、转弯、碰撞和地面接触附近更密集地采样。

5. 在归咎重定向之前检查模型完整性。

   • 在应用动画之前确认干净的基线形状。
   • 除非用户明确要求修复，否则保留原始网格、材质、骨架和蒙皮。
   • 将无法解释的球形斑点、巨大代理网格或压碎的身体视为导入/选择问题，直到另有证明。

6. 诊断接触和运动问题。

   • 地面穿透：比较每帧最低脚部或鞋子顶点与地面高度。
   • 脚部滑动：比较站立帧之间脚部的世界位置。
   • 腿部交叉：比较左/右大腿、膝盖、脚踝和脚部的侧向排序。
   • 扭曲损坏：将骨骼摆动方向与沿肢体轴的滚动/扭曲分开比较。
   • 缩放漂移：将动画网格边界与干净基线边界进行比较。

7. 先报告事实再给出意见。

   • 包含帧号、对象名称、骨骼名称、世界坐标和阈值。
   • 将已确认的失败与视觉怀疑分开。
   • 仅在结构化状态解释了要查找的内容之后才附加截图。

推荐报告格式

## Blender Motion Inspection

### Scene Inventory
- Character candidates:
- Armatures:
- Helper/proxy objects:
- Cameras/lights:

### Orientation
- World up:
- Character forward:
- Root heading:
- Mirrored/backwards risk:

### Baseline Integrity
- Clean mesh bounds:
- Animated mesh bounds:
- Materials/skin preserved:
- Suspicious non-character meshes:

### Frame Findings
| Frame | Finding | Evidence |
| --- | --- | --- |
| 1 | Clean baseline pose | hips/spine/feet aligned |
| 96 | Foot penetrates floor | left_foot min_z = -0.04 |

### Verdict
- Pass/fail:
- Required fix:
- Render readiness:

示例

带脚部滑动的行走循环

场景：重定向的角色在行走循环中出现滑冰现象，但正面摄像机角度使脚部接触难以判断。

应用工作流：

• 清点场景：角色网格 HeroBody，骨架 HeroRig，地面平面 Floor，无隐藏对象