Communitygithub.com

Blender动作状态检查

在检查Blender角色、骨骼绑定、姿态、动作重定向、地面接触、朝向或模型与动作对齐时使用,仅靠截图不足以判断的场合。

Blender动作状态检查 是什么?

该技能提供了一套系统化的结构化数据检测方法,用于诊断Blender中角色的动作问题。它解决了单纯依赖截图无法发现的深层问题,如轴约定、骨骼命名、对象缩放、局部变换、父子关系蒙皮以及逐帧接触状态。工作流程包括建立场景清关基线、通过Python导出器提取结构事实、采样关键帧、比较测量结果与用户期望,最终输出包含已确认事实、可能原因及修复方案的报告。该技能支持Blender的原生Python环境,推荐使用JSON导出器或通过`blender --background`运行Python脚本来获取数据。它适用于任何处理3D角色动画的用户,尤其是从事动作重定向、骨胳绑定、角色导入和动画检查的开发者。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/blender-motion-state-inspection

在你喜欢的 AI 中提问

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

文档

Blender 动作状态检查

使用时机

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

核心原则

不要仅凭截图判断动画3D资源。截图是检查证据,但它们隐藏了轴约定、骨骼名称、物体缩放、局部变换、父子关系网格、材质槽和逐帧接触状态。

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

工作原理

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

检查工作流

  1. 编目场景。

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

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

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

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

    • 在应用动画前确认干净的基线形状。
    • 除非用户明确要求修复,否则保留原始网格、材质、骨架和蒙皮。
    • 将无法解释的球状物体、巨大代理网格或压扁的身体视为导入/选择问题,直到证明并非如此。
  6. 诊断接触和动作问题。

    • 地面穿透:逐帧比较最低的脚或鞋顶点与地面高度。
    • 脚部滑动:比较跨接触帧的脚部世界位置。
    • 腿部交叉:比较左右大腿、膝部、踝部和足部的侧向顺序。
    • 扭曲损伤:将骨骼摆动方向与绕肢体轴的滚动/扭曲分开比较。
    • 缩放漂移:将动画网格边界与干净的基线边界进行比较。
  7. 先报告事实,再给出意见。

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

推荐报告格式

## Blender 动作检查

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

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

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

### 帧发现
| 帧 | 发现 | 证据 |
| --- | --- | --- |
| 1 | 干净基线姿态 | 髋部/脊柱/足部对齐 |
| 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左脚着地时滑动六帧内 foot.L x = 0.21 -> 0.28
30骨盆持续向前移动pelvis y = 1.14 -> 1.31

结论:渲染就绪失败。动作需要脚部锁定清理或重定向约束审查;身体网格无需比例调整。

反向导入的角色

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

应用工作流:

  • 确定向前、向上和侧向轴:比较头部、胸部、足部和根骨运动。
  • 采样动画帧:检查第一帧和行进路径的中点。
  • 先报告事实,再给出意见:分别包括根骨朝向和模型面向方向。

提取的事实:

帧事实证据
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 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

相关技能