Communitygithub.com

纸偶剪辑质量检查

对照风格DNA和故事板检查纸偶剪辑的静帧。在几个时间点生成联系表,运行完整检查清单,然后撰写交付摘要。用于“质量检查剪辑”、“检查我的场景是否看起来像纸偶”、“这个可以发布了吗”。

纸偶剪辑质量检查 是什么?

这个技能用于对纸偶动画项目的视觉输出进行系统化质量检查,确保它们符合预定义的风格DNA和故事板。它通过渲染静帧生成联系表,并实现一个全面的检查清单,涵盖色彩、排版、摄像机运动、动画原则和叙事连贯性。在构建过程中按场景运行此检查,并在最终渲染前对整个剪辑运行一次。它支持基于Remotion的项目,也支持托管的kyfram设置,并通过集成工具(qa.sh)自动化渲染和比较过程。

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

在你喜欢的 AI 中提问

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

文档

纸偶剪辑质量检查 是做什么的?

对比静帧的风格(而非内容)与风格DNA和故事板。在构建过程中按场景运行一次,在最终渲染前对整个剪辑运行一次。

预检

  • 安装:标准或完整。静帧需要一个已搭建好的项目(带Remotion),联系表需要Python,并安装numpy和Pillow($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个token,因此只打开步骤所需的文件。
  • 关于密度:$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个词,每个一个事实,绝不重复画外音。仅凭横幅就能阅读为事实表。
  • 每个场景描绘其画外音行中的一个具体单词,数字是实体道具,并且在行动号召前有一个回调场景。
  • 每个数字和UI标签都溯源到事实列表。脚本至少有一个诚实的限制,并且功能堆叠恰好为三个。
  • 字幕:每个单词一个标签,倾斜,在起始处弹出,每页1-3个,位于68-80%高度区域,绝不在面部上。
  • 仅角色、字幕和信号有饱和度。
  • 每个重读单词上有一个视觉事件,环境运动始终运行。
  • 在横幅变化处剪切(游览和新闻场景中持续1.5-3秒,隐喻节拍中最多5秒),底部20%区域保持清晰。
  • HOOK块(SAY / WRITE / SHOW / ALIGN)完全按书面显示: 第0帧显示SHOW时刻在动作中,WRITE标题位于其上,第一行画外音是SAY。
  • 每个场景有一次摄像机运动、最多一次翻页或撕纸、一次胶带拉动或鞭击进入行动号召,并且每个转场都有其音效。
  • 幽默感在屏幕上可见:全程一种格式、每个想法一个服装道具、一个挣扎节拍、第0帧的道具在行动号召场景中变化回归、每个笑点在一秒内可理解且绝不覆盖横幅、字幕或关键数字。
  • 画外音和横幅中的词汇与 SERIES.md 中的受众水平匹配。
  • 画外音、字幕和事件同步(在每个剪切点仔细检查Studio)。

对于失败的项,修复场景文件(或库中的工具包,而非项目中的 src/lib/)并重新运行该场景。使用 motion-build 重建场景。

3. 交付

打开Studio预览,列出带时间的场景,并说明哪些是占位符:语音、音乐、音效、资源。如果语音是占位符,说明如何重新配音(motion-voice)。发布后,数字将提供给 motion-strategy 用于事后分析。

原则检查

以5帧/秒的速度逐场景查看,并根据 $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.

相关技能