Communitygithub.com

紙偶動畫 QA

將紙偶動畫的影格與風格 DNA 和分鏡圖進行比對,檢查風格而非內容。產生數個時間點的連接觸控片,執行完整檢查清單,然後撰寫交付摘要。用於「QA 動畫」、「檢查我的場景看起來像紙偶」、「這可以發布了嗎」。

紙偶動畫 QA 是什麼?

Papercut QA 是一個專業技能,專為基於 Remotion 或 Kyfram 的動畫專案設計,旨在確保最終輸出的視覺風格與預先定義的「風格 DNA」和「分鏡圖」一致。它的核心功能是抽取影片的靜態影格(stills),並將其與風格指南、背景底圖等參考資料進行比對。此技能會生成包含多個時間點影格的接觸片(contact sheets),讓使用者能快速瀏覽整個場景或整部影片的視覺一致性。 此技能的主要價值在於將主觀的「看起來對不對」轉化為客觀、可重複執行的檢查流程。它特別強調「紙偶」風格的關鍵元素,例如:所有物體都需有紙張紋理、粗糙邊緣、投影和堆疊陰影;世界攝影機必須平滑移動;橫幅和標籤需有類似紙膠帶的固定效果等。支援 Remotion(標準或完整安裝)和 Kyfram 兩種專案類型。 在工作流程上,`motion-qa` 技能會要求使用者先透過 `qa.sh` 工具渲染接觸片,然後依序執行一套全面的檢查清單(包含物件、攝影機、橫幅、圖卡、剪輯、鉤子區塊、幽默感等 16 項),最後產生一份交付摘要。如果檢查失敗,使用者會被引導回 `motion-build` 或 `motion-voice` 修正場景或音訊,形成一個完整的 QA 迭代循環。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-qa

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

紙偶動畫 QA 是做什麼的?

將影格與風格 DNA 和分鏡圖進行比較,重點在於風格而非內容。建議在建立每個場景時執行,並在最終渲染前對整部影片再執行一次。

前置檢查

  • 安裝:標準 或完整安裝。靜態影格需要一個已建立 scaffold 且包含 Remotion 的專案,而接觸片則需要安裝了 numpy 和 Pillow 的 Python($MOTION_PY)。若缺少元件:執行 ./install.sh --doctor,然後再執行 motion-setup。
  • kyfram 專案不需要 Remotion:在檢查或修復 Kyfram 場景輸出前,請先呼叫 kyfram 技能。qa.sh 會從快取的每個場景片段(core/tools/kyfram_qa.py)中提取其靜態影格,因此請在 QA 前先使用 core/tools/render.sh 渲染一次。以下所有說明同樣適用。
  • 函式庫:使用 $MOTION_LIB,否則讀取 ~/.config/motion-explainer/config.env 中的 MOTION_LIB= 行,若仍無則於執行時詢問一次。
  • 首先閱讀:位於 $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md 第 2 節的風格 DNA,以及背景底圖 style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg。每張圖片約消耗 0.7-1.5k tokens,因此僅在需要時才開啟。
  • 關於密度,請參考 $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md(結尾處的「節奏統計」):每個場景平均 2.8 秒,包含 2-4 個離散的視覺事件,每個事件間隔 0.4-0.8 秒並落在重讀的單詞上,大約每 0.6 秒出現一個新的圖卡頁面。請複製其密度,而非內容。

1. 渲染靜態影格

從專案的 video/ 資料夾執行:

$MOTION_LIB/core/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
  • 每次檢查使用 4-6 個時間點。對於一個場景,NTH 約為其長度(以影格數計)除以 4。若要檢查整部影片,請省略 FROM-TO 並提高 NTH。
  • 輸出為 out/qa/NAME_0.jpg(以及較長範圍的 _1、_2),每張接觸片最多 45 個影格。請閱讀接觸片,並保持其小巧。
  • 每個場景只執行一個 QA 命令,且絕不同時執行兩個渲染任務。每個場景的修正保持在兩輪內。
  • 與分鏡圖比對:該場景的第 0 影格、關鍵事件發生的單詞上的影格,確保沒有內容被裁切,也沒有任何東西遮擋橫幅或圖卡區域。

2. 檢查清單

  • 每個物體看起來都像紙:具有紙張紋理、粗糙邊緣、投影、堆疊陰影,沒有輪廓線或漸層。
  • 世界攝影機移動流暢。只有橫幅和標籤會抖動(階梯式、細微)。
  • 橫幅固定在一個位置並用膠帶貼住,包含 3-7 個單詞,每個單詞一個事實,絕不重複 VO。僅憑橫幅就能讀懂為一張事實表。
  • 每個場景都說明了其 VO 行中的一個具體單詞,數字是實體道具,並且在 CTA 之前有一個回顧場景。
  • 每個數字和 UI 標籤都來自事實列表。腳本中至少有一個誠實的限制,並且功能堆疊恰好為三個。
  • 圖卡:每個單詞一個標籤,傾斜放置,在起始時彈出,每頁 1-3 個,位於畫面 68-80% 的區域,絕不覆蓋人臉。
  • 僅對角色、圖卡和信號進行飽和度調整。
  • 每個重讀的單詞上都有一個視覺事件,且環境動畫始終在運行。
  • 在橫幅變化處進行剪輯(導覽和新聞場景中為 1.5-3 秒,隱喻節拍中最多 5 秒),畫面底部 20% 保持清晰。
  • HOOK 區塊(SAY / WRITE / SHOW / ALIGN)必須完全按照腳本顯示在畫面上: 第 0 影格顯示 SHOW 時刻正在進行中的動作,並在其上疊加 WRITE 標題,且第一行 VO 是 SAY。
  • 每個場景都有一個攝影機運動、最多一個翻頁或撕頁效果、一個膠帶拉動或鞭打效果進入 CTA,且每個轉場都有其音效。
  • 幽默感在畫面中可見:全片使用一種格式,每個想法一個服裝道具,一個掙扎的節拍,第 0 影格的道具在 CTA 場景中發生變化後回歸,每個笑點在 1 秒內可被理解,且絕不覆蓋橫幅、圖卡或關鍵數字。
  • VO 和橫幅中的詞彙符合 SERIES.md 中定義的觀眾水平。
  • 旁白、圖卡和事件同步(在每個剪輯點仔細檢查 Studio)。

對於失敗的項目,請修正場景檔案(或函式庫中的套件,而非專案中的 src/lib/),然後重新執行該場景。使用 motion-build 重建場景。

3. 交付

開啟 Studio 預覽,列出各場景及其時間,並說明哪些是佔位符:語音、音樂、音效、素材。如果語音是佔位符,請說明如何重新配音(motion-voice)。發布後,數據將傳遞給 motion-strategy 進行後續分析。

原則審查

以 5 fps 的速度仔細檢查一個場景,並對照 $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md:每個大動作前的預備動作(2)、所有動作皆有緩入緩出(6)、撞擊後的尾隨效果(5)、一個焦點道具(3)、一個誇張的節拍(10)、堆疊陰影和一致的投影(11)。

交接

修正內容將回饋給 motion-build(場景或音效)或 motion-voice(同步)。一次乾淨的審查標誌著影片製作完成:當使用者要求時,使用 $MOTION_LIB/core/tools/render.sh 進行渲染。

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

相關技能