Communitygithub.com

503496348-ops/mischief-production

使用此技能檢查 Blender 角色、骨架、姿勢、動作重定位、地面接觸、面對方向,或模型與動作比對問題,當僅靠螢幕截圖不足以判斷時。

mischief-production 是什麼?

此技能提供一個結構化的工作流程,用於檢查 Blender 中的角色動畫、骨架和動作重定位問題。它強調整澈的場景基準線建立和結構化資料提取,而非依賴可能隱藏軸向慣例、骨骼名稱和逐幀接觸狀態等關鍵資訊的螢幕截圖。支援多個平台(包括 Claude Code),並透過詳細的清單清點場景、識別骨架、確定方向軸、取樣動畫幀,以及診斷接觸與運動問題(如腳部滑動、腿部交叉和扭曲損傷)。該技能還包含一個推薦的報告格式,以事實和證據(包括幀號、物件名稱和世界座標)來分離已確認的失敗與視覺上的可疑點。它旨在透過提供基於事實的診斷和明確的修復建議,幫助使用者決定角色、道具、代理網格或匯入失敗的模型是否可用於渲染,從而加速動畫工作流程。

相容平台~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 |

### 結論
- 通過/失敗:
- 所需修正:
- 渲染就緒狀態:

範例

帶有腳部滑動的走路循環

情境:一個重定位後的角色在走路循環中看起來像在滑冰,但正面攝影機角度使得腳部接觸難以判斷。

套用工作流程:

  • 清點場景:角色網格 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.

相關技能