Communitygithub.com

503496348-ops/mischief-production

在检查Blender角色、骨骼、姿势、动画重定向、地面接触、朝向或模型与运动对齐时使用,仅凭截图不足以判断。

mischief-production 是什么?

此技能用于分析Blender中的动画状态,超越静态截图。它通过提取骨骼姿势、边界框、地面接触点和朝向向量等结构化数据,帮助判断角色动画是否出现扭曲、镜像、偏移或脚滑动等问题。该技能支持Blender原生环境,通过Python脚本或状态导出器收集数据,并与用户预期姿势进行对比。它提供了一套完整的检查工作流:从场景清单、骨骼识别、轴向确定,到动画帧采样和接触/运动问题诊断。最终生成结构化报告,明确事实、可能原因和修复建议,避免基于截图的猜测。适用于需要严谨动画审核的开发者或技术艺术家。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Blender 运动状态检查

何时使用

  • Blender角色在动画中看起来扭曲、镜像、压扁、偏移或出现脚滑动。
  • 用户询问导入的化身、骨架或重定向运动是否符合预期姿势。
  • 你需要将渲染证据与结构化事实(如骨骼、边界框、接触点和朝向向量)进行比较。
  • 工作流程依赖于判断模型是角色、道具、代理网格、控制骨架还是损坏的导入。

核心原则

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

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

工作原理

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

检查工作流

  1. 清点场景。

    • 列出网格、骨架、空对象、相机、灯光、修改器、父级关系和隐藏对象。
    • 在判断化身之前,将角色网格与辅助/代理几何体分开。
    • 记录对象空间和世界空间的边界框。
  2. 识别骨骼。

    • 捕获骨架名称、姿势骨骼、骨骼头/尾、倾斜、父级链、约束和休息姿势轴。
    • 映射语义骨骼,如髋、脊柱、颈、头、肩、肘、手、大腿、膝、踝和脚。
    • 标记缺失的左右配对和不寻常的命名方案。
  3. 确定前方、上方和侧方轴向。

    • 同时使用骨盆、脊柱、肩膀、髋、头和脚;不要仅依赖单个网格法线。
    • 将局部骨架轴与世界轴以及导入文件约定(如glTF的Y轴向上与Blender的Z轴向上)进行比较。
    • 当面部/头部/脚方向与根运动冲突时,标记可能的镜像或反向导入。
  4. 采样动画帧。

    • 检查第一帧、中间帧、接触帧、空中帧和极端帧。
    • 记录根位置、根朝向、骨盆高度、躯干倾斜、肢体方向、脚离地间隙和网格边界。
    • 对于长或快速运动,围绕翻转、落地、转弯、碰撞和地面接触点进行更密集的采样。
  5. 在归咎于重定向之前检查模型完整性。

    • 在应用动画前确认清晰的基线形状。
    • 保留原始网格、材质、骨架和蒙皮,除非用户明确要求修复。
    • 在证实之前,将无法解释的球形斑点、巨大的代理网格或压扁的身体视为导入/选择问题。
  6. 诊断接触和运动问题。

    • 地面穿透:逐帧比较最低的脚或鞋顶点与地板高度。
    • 脚滑动:在落地帧之间比较脚的世界位置。
    • 腿交叉:比较左右大腿、膝、踝和脚的侧面排序。
    • 扭曲损伤:将骨骼摆动方向与围绕肢体轴的旋转/扭曲分开比较。
    • 比例漂移:将动画网格边界与干净的基线边界进行比较。
  7. 先报告事实,再给观点。

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

推荐报告格式

## Blender 运动检查

### 场景清单
- 角色候选:
- 骨架:
- 辅助/代理对象:
- 相机/灯光:

### 朝向
- 世界向上轴:
- 角色前方:
- 根朝向:
- 镜像/反向风险:

### 基线完整性
- 干净网格边界:
- 动画网格边界:
- 材质/蒙皮保留:
- 可疑的非角色网格:

### 帧发现
| 帧 | 发现 | 证据 |
| --- | --- | --- |
| 1 | 干净的基线姿势 | 髋/脊柱/脚对齐 |
| 96 | 脚穿透地板 | left_foot min_z = -0.04 |

###  verdict
- 通过/失败:
- 所需修复:
- 渲染就绪:

示例

带有脚滑动的行走循环

场景:一个重定向的角色在行走循环中看起来像是在滑冰,但正面相机角度使得脚接触难以判断。

应用工作流:

  • 清点场景:角色网格 HeroBody,骨架 HeroRig,地面 Floor,无隐藏代理网格。
  • 识别骨骼:语义脚是 foot.L 和 foot.R;髋是 pelvis;根骨是 root。
  • 采样动画帧:在脚落地时刻附近检查帧1、18、24、30、42和48。
  • 诊断接触和运动问题:在落地帧之间比较脚的世界位置。

提取的事实:

帧事实证据
18左脚落地foot.L min_z = 0.004,脚趾和脚跟都接近地面
24左脚在落地时滑动六帧内 foot.L x = 0.21 -> 0.28
30骨盆持续向前移动pelvis y = 1.14 -> 1.31

结论:渲染就绪失败。运动需要脚锁定清理或重定向约束检查;身体网格不需要比例更改。

反向导入的角色

场景:角色在静止帧看起来正确,但动画朝着与预期运动方向相反的方向移动。

应用工作流:

  • 确定前方、上方和侧方轴向:比较头、胸部、脚和根运动。
  • 采样动画帧:检查帧1和运动路径的中点。
  • 先报告事实,再给观点:分别包括根朝向和模型面对方向。

提取的事实:

帧事实证据
1角色面部朝向世界 -Y从 neck 到 head 的头/胸向量解析为 -Y
72根运动朝向世界 +Yroot y = 0.0 -> 2.8
72脚在视觉上保持与运动相反的前向脚趾骨骼指向 -Y 而位移是 +Y

结论:很可能是反向导入或重定向前向轴不匹配。在编辑动画曲线之前修复导入/重定向轴映射。

实用阈值

  • 除非场景单位比例另有说明,否则假设Blender默认的米尺度单位。
  • 将大于1-2厘米的地面穿透视为可见,除非地面是柔软的或有意风格化的。
  • 将大于5%的突然比例变化视为可能的骨架、约束或变换继承问题。
  • 在倒置空中运动中,将左右踝侧顺序翻转视为腿交叉风险,即使后来恢复。
  • 将每帧大于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.

相关技能