Communitygithub.com

블렌더 모션 상태 검사

블렌더 캐릭터의 리깅, 포즈, 애니메이션 리타겟팅, 지면 접촉, 바라보는 방향 또는 모델과 모션 간 정렬 문제를 스크린샷만으로 판단하기 어려울 때 사용합니다.

블렌더 모션 상태 검사란 무엇인가요?

이 스킬은 블렌더에서 3D 캐릭터 애니메이션을 검사할 때, 스크린샷만으로는 알 수 없는 구조적 정보(본, 경계 상자, 접촉 상태, 방향 벡터 등)를 추출하여 분석하는 데 특화되어 있습니다. 사용자는 이 스킬을 통해 캐릭터의 비틀림, 미러링, 평탄화, 오프셋, 발 미끄러짐과 같은 문제를 진단하고, 모델이 캐릭터, 소품, 프록시 메시, 컨트롤 릭인지 판별할 수 있습니다. 블렌더 Python 스크립트나 상태 내보내기 도구를 통해 데이터를 수집하며, 결과를 프레임별 사실과 함께 보고서 형태로 제공합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 활용되며, 블렌더의 Python API(bpy)를 직접 사용하는 것이 중요합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

블렌더 모션 상태 검사은(는) 무엇을 하나요?

사용 시기

  • 블렌더 캐릭터가 애니메이션에서 비틀리거나, 미러링되거나, 평탄화되거나, 오프셋이 발생하거나, 발이 미끄러지는 경우
  • 사용자가 가져온 아바타, 아마추어 또는 리타겟팅된 모션이 예상 포즈와 일치하는지 묻는 경우
  • 렌더링된 증거와 뼈대, 경계 상자, 접촉, 바라보는 방향 벡터와 같은 구조화된 사실을 비교해야 하는 경우
  • 워크플로우가 모델이 캐릭터, 소품, 프록시 메시, 컨트롤 릭 또는 잘못 가져온 파일인지 판단해야 하는 경우

핵심 원칙

애니메이션 3D 에셋을 스크린샷만으로 판단하지 마십시오. 스크린샷은 검토 증거이지만, 축 규칙, 뼈대 이름, 오브젝트 스케일, 로컬 변환, 부모 관계, 머티리얼 슬롯, 프레임별 접촉 상태를 숨깁니다.

먼저 구조화된 블렌더 상태를 추출한 후, 뷰포트 스크린샷이나 렌더를 사용하여 해당 사실이 의미하는 바를 확인하십시오.

작동 방식

  1. 모션을 판단하기 전에 깨끗한 씬과 에셋 기준선을 확립합니다.
  2. 내보내기 도구 또는 블렌더 자체 인터프리터 내에서 실행되는 블렌더 Python을 사용하여 구조화된 사실을 추출합니다.
  3. 접촉, 방향, 스케일, 리타겟팅 오류가 가장 많이 노출될 가능성이 있는 프레임을 샘플링합니다.
  4. 측정된 사실을 사용자의 예상 포즈, 방향, 지면, 렌더 목표와 비교합니다.
  5. 확인된 사실, 가능한 원인, 필요한 수정 사항을 구분하는 간결한 보고서를 반환합니다.

검사 워크플로우

  1. 씬 인벤토리 작성

    • 메시, 아마추어, 엠프티, 카메라, 라이트, 모디파이어, 부모 관계, 숨겨진 오브젝트를 나열합니다.
    • 아바타를 판단하기 전에 캐릭터 메시를 헬퍼/프록시 지오메트리와 분리합니다.
    • 오브젝트 공간 및 월드 공간 경계 상자를 기록합니다.
  2. 스켈레톤 식별

    • 아마추어 이름, 포즈 본, 본 머리/꼬리, 롤, 부모 체인, 제약 조건, 휴식 포즈 축을 캡처합니다.
    • 엉덩이, 척추, 목, 머리, 어깨, 팔꿈치, 손, 허벅지, 무릎, 발목, 발과 같은 의미론적 본을 매핑합니다.
    • 누락된 왼쪽/오른쪽 쌍과 비정상적인 명명 체계에 플래그를 지정합니다.
  3. 전방, 상방, 측방 축 결정

    • 골반, 척추, 어깨, 엉덩이, 머리, 발을 함께 사용합니다. 단일 메시 노멀에 의존하지 마십시오.
    • 로컬 아마추어 축을 월드 축 및 glTF Y-up 대 Blender Z-up과 같은 가져온 파일 규칙과 비교합니다.
    • 얼굴/머리/발 방향이 루트 모션과 충돌할 때 미러링 또는 역방향 가져오기 가능성을 표시합니다.
  4. 애니메이션 프레임 샘플링

    • 첫 번째, 중간, 접촉, 공중, 극단 프레임을 검사합니다.
    • 루트 위치, 루트 방향, 골반 높이, 상체 기울기, 팔다리 방향, 발 간격, 메시 범위를 기록합니다.
    • 길거나 빠른 모션의 경우 뒤집기, 착지, 방향 전환, 충돌, 바닥 접촉 주변에서 더 조밀하게 샘플링합니다.
  5. 리타겟팅 비난 전에 모델 무결성 확인

    • 애니메이션을 적용하기 전에 깨끗한 기준선 형태를 확인합니다.
    • 사용자가 명시적으로 수리를 요청하지 않는 한 원래 메시, 머티리얼, 아마추어, 스키닝을 보존합니다.
    • 설명할 수 없는 구형 덩어리, 거대한 프록시 메시, 찌그러진 몸체는 입증될 때까지 가져오기/선택 문제로 처리합니다.
  6. 접촉 및 모션 문제 진단

    • 지면 관통: 프레임별로 가장 낮은 발 또는 신발 정점을 바닥 높이와 비교합니다.
    • 발 미끄러짐: 고정된 프레임에서 발의 월드 위치를 비교합니다.
    • 다리 교차: 왼쪽/오른쪽 허벅지, 무릎, 발목, 발의 측면 순서를 비교합니다.
    • 비틀림 손상: 뼈대의 스윙 방향과 팔다리 축을 중심으로 한 롤/트위스트를 별도로 비교합니다.
    • 스케일 드리프트: 깨끗한 기준선 범위와 애니메이션된 메시 범위를 비교합니다.
  7. 의견보다 사실을 먼저 보고

    • 프레임 번호, 오브젝트 이름, 뼈대 이름, 월드 좌표, 임계값을 포함합니다.
    • 확인된 실패와 시각적 의심을 분리합니다.
    • 구조화된 상태가 무엇을 찾아야 하는지 설명한 후에만 스크린샷을 첨부합니다.

권장 보고서 형식

## 블렌더 모션 검사

### 씬 인벤토리
- 캐릭터 후보:
- 아마추어:
- 헬퍼/프록시 오브젝트:
- 카메라/라이트:

### 방향
- 월드 상방:
- 캐릭터 전방:
- 루트 방향:
- 미러링/역방향 위험:

### 기준선 무결성
- 깨끗한 메시 범위:
- 애니메이션된 메시 범위:
- 머티리얼/스킨 보존:
- 의심스러운 비-캐릭터 메시:

### 프레임 결과
| 프레임 | 결과 | 증거 |
| --- | --- | --- |
| 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 (6프레임 동안)
30골반이 계속 앞으로 이동pelvis y = 1.14 -> 1.31

판정: 렌더 준비 실패. 모션에 발 고정 정리 또는 리타겟팅 제약 조건 검토가 필요함; 바디 메시 비율 변경은 필요하지 않음.

역방향 가져오기 캐릭터

시나리오: 정지 프레임에서 캐릭터는 올바르게 보이지만, 애니메이션은 예상 이동 방향과 반대로 움직입니다.

워크플로우 적용:

  • 전방, 상방, 측방 축 결정: 머리, 가슴, 발, 루트 모션을 비교합니다.
  • 애니메이션 프레임 샘플링: 프레임 1과 이동 경로의 중간점을 검사합니다.
  • 의견보다 사실 먼저 보고: 루트 방향과 모델이 바라보는 방향을 별도로 포함합니다.

추출된 사실:

프레임사실증거
1캐릭터 얼굴이 월드 -Y 방향을 가리킴neck에서 head로의 머리/가슴 벡터가 -Y로 확인됨
72루트 모션이 월드 +Y 방향으로 이동root y = 0.0 -> 2.8
72발이 이동 방향과 반대 방향을 시각적으로 가리킴발가락 뼈는 -Y를 가리키지만 변위는 +Y

판정: 역방향 가져오기 또는 리타겟팅 전방 축 불일치 가능성이 높음. 애니메이션 커브를 편집하기 전에 가져오기/리타겟팅 축 매핑을 수정하십시오.

실용적인 임계값

  • 씬 단위 스케일이 달리 명시되지 않는 한 블렌더의 기본 미터 스케일 단위를 가정합니다.
  • 바닥이 부드럽거나 의도적으로 스타일화되지 않은 경우 1-2cm 이상의 지면 관통을 가시적인 것으로 처리합니다.
  • 5% 이상의 갑작스러운 스케일 변화를 릭, 제약 조건 또는 변환 상속 문제 가능성이 있는 것으로 처리합니다.
  • 공중 역전 동작 중 왼쪽/오른쪽 발목 측면 순서 뒤집기를 나중에 복구되더라도 다리 교차 위험으로 처리합니다.
  • 소스 모션에 스냅 턴이 포함되지 않은 경우 프레임당 30도 이상의 루트 방향 점프를 의심스러운 것으로 처리합니다.

안티 패턴

  • 명시적으로 메시 수리가 작업이 아닌 이상 포즈 일치를 강제하기 위해 몸체 비율을 수정하지 마십시오.
  • 깨끗한 기준선을 기록하기 전에 베이크하지 마십시오.
  • 하나의 렌더링된 카메라 각도를 포즈가 올바르다는 증거로 사용하지 마십시오.
  • 헬퍼 오브젝트가 캐릭터의 일부가 아닌 이유를 기록하기 전에 삭제하지 마십시오.
  • 머리, 발, 몸통, 루트 모션을 함께 확인하지 않고 아바타가 +Y, -Y, +X, -X를 바라본다고 가정하지 마십시오.

도구 참고 사항

블렌더 상태 내보내기 도구를 사용할 수 있다면 메시, 아마추어, 포즈 본, 머티리얼, 접촉, 경계 상자, 샘플링된 애니메이션 프레임을 포함하는 JSON을 선호하십시오. 내보내기 도구가 없는 경우 블렌더 자체를 통해 작은 블렌더 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.

관련 스킬