Communitygithub.com

motion-review: 品味把关器

为动态图形作品(HyperFrames / GSAP / HTML 或 Remotion)提供独立批评与质量门控。通过实际查看帧,根据9维工作室评价标准评分、检查硬性门控、12项工艺清单及反庸俗列表,返回“通过/润色/重做”结果及精确的帧级修复建议。在交付前的任何渲染之前、每次修改之后,以及当被要求审阅、批评、“改进”或“确认质量”时使用。最好作为全新上下文的子代理运行,避免构建者自己审核自己的作品。

motion-review: 品味把关器 是什么?

motion-review 是一个专业技术技能,用于对动态图形作品(如 HyperFrames、GSAP、HTML 或 Remotion 生成的上万帧动画)进行独立的质量评判和品味把关。它基于一份详细的9维度评价标准(概念、构图、排版、时间与缓动、编排、转场、深度与纹理、音画同步、完成度)评分(1–5分),并设置了硬性门控(例如代码检查失败、文字不可读、字体闪烁等问题直接阻断)和12项工艺清单(如自定义缓动、无默认淡入、纹理通道等)。该技能还包含一个反庸俗扫描列表(15项常见低级错误,如统一的淡入上滑、默认缓动、缺乏相机运动)。最终输出“通过/润色/重做”的判定,并在 review.md 文件中生成详细的修复建议表(含时间戳、帧选择器、前后对比和原因),指导开发者按优先级(删除、减少、调整缓动、修复构图/原点、重新计时、添加深度/模糊/纹理、打磨)修正问题。它支持所有主流平台(HyperFrames、Remotion、GSAP、HTML/CSS),且设计为不得编辑原作品,只能输出评审文件。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-review

在你喜欢的 AI 中提问

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

文档

motion-review: 品味把关器 是做什么的?

语法检查器捕捉有问题的代码。这个技能捕捉 品味。默认姿态:先标记问题;通过需要努力挣得。 一个“看起来还行”的作品只值3分,3分不能交付。

运行方式

  • 尽可能以全新的子代理运行。给它:本文件、项目文件夹和设计简报。不要告诉它这个构建有多难。
  • 审阅者绝不编辑合成文件。它只在项目文件夹中编写 review.md 并返回判定结果。
  • 看像素,而不仅仅是代码。每个分数必须指向一个时间戳、帧或选择器。
  • 每个作品只有一个审阅者。 两个审阅者同时运行会写入同一个 review.md 导致判定冲突。每轮结束时只有一个 verdict: 行;调用方轮询 review.md 获取它。重新审阅由同一个审阅者进行;仅当 review.md 长时间没有新的一轮时,才启动替换,在 review.md 中记录取消,并让替换者先阅读历史记录。如果多轮冲突,以 review.md 的最后一次写入为准。

流程

执行每一步。命令假设是 HyperFrames 项目(npx hyperframes …);对于其他技术栈,使用等效命令(Remotion:用 npx remotion still 获取帧,用 npx remotion render 获取条状图)。

  1. 结构检查。 npx hyperframes check . 任何错误都是阻断性问题。也要读取警告。其对比度审计即为对比度门控。装饰性文字(模糊幽灵、幽灵轨迹克隆、溶解碎片、乱码填充等)通过在节点上添加 data-layout-ignore 来排除;绝不能用它隐藏真实文案。

  2. 运动映射。 读取时间线代码(或动画映射文件,如果你的 HyperFrames 技能提供了 animation-map.mjs)。注意:

    • 持续1秒或更长的没有任何移动的死区;
    • 时间过短(< 0.2 秒,太快无法阅读)或过长(> 2 秒,漂移)的空间移动;
    • 不规则或机械的错开;
    • 意外离开画面或碰撞的元素。

    通过代理/setter 对象(自定义相机、three.js、计数器)驱动的运动对基于补间的映射不可见;对这些移动使用帧条状图(步骤5)。

  3. 联系表。 根据故事板或节拍列表,获取场景和衔接时间。截图:

    • 第0帧、英雄时刻和最后一帧;
    • 每个场景的25%、50%、75%处;
    • 每个衔接点在第-2帧、第0帧和第+2帧处。

    npx hyperframes snapshot --at <t1,t2,…>。传入精确的帧时间(t = 帧/帧率,例如30帧/秒下的第316帧 → 10.5333);--at 不会自动补齐,因此一个取整的时间会显示出渲染中不存在的中间姿势。snapshot 会保留之前运行的过期 PNG,因此每次运行前将旧的 snapshots/ 目录移开(例如 node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())"),而不是用 rm 通配符删除;--at 也可能添加一个你未要求的额外帧,所以忽略多余的帧。打开图片并查看。仅在元素可见的时间点放大文字(放大隐藏元素可能导致卡死)。

  4. 深度证明。 对于相机或英雄运动,执行 npx hyperframes keyframes --ghost --angle。沿 Z 轴分离的平面表示真实深度;一切一起缩放表示虚假深度。英雄运动上的均匀鬼影间距表示线性缓动,不合格。如果 --ghost 无法运行,取一个副本,为世界的父级添加一个证明相机(推远 + 俯仰 + 偏航,例如 translateZ(-900px) rotateX(-28deg) rotateY(64deg);仅偏航会将相机置于深场景内部),在运动过程中截图 4–6 个帧时间并叠加(ffmpeg … -filter_complex blend=all_mode=lighten)。对于嵌套透视(snapshot --angle side 会将其扁平化)和 JS 投影相机(3D 投影到一个 SVG/canvas 上),在副本中手动构建此洋葱效果:在投影函数中交换一个侧视相机。

  5. 实时观看。 如果已有渲染文件:

    • 制作条状图:ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg;
    • 用 ffprobe 检查时长以及第一帧和最后一帧;
    • 如果有音频,对照提示单检查每个拍子(±1帧),最终 AAC 文件真峰值 ≤ −1 dBTP(ffmpeg -i … -af ebur128=peak=true -f null -);
    • 透明 .webm 叠加:ffprobe 会将 VP9-alpha 显示为 yuv420p;通过在 -i 前使用 -c:v libvpx-vp9 解码验证(流读取为 yuva420p)或检查 ALPHA_MODE=1 标签。
  6. 代码阅读。 对合成文件执行 grep,查找:

    • ease:(列出使用的每一个缓动)及其持续时间;
    • 纯不透明度进入和小 y: 偏移(20–40 像素);
    • Math.random / Date.now(非确定性);
    • back.out|elastic|bounce、yoyo、repeat: -1;
    • 空间移动上的线性或 power1;不在允许列表(mg.*、power3.out、expo.out、power3.in、power4.out、power2.inOut、none、烘焙弹簧)内的缓动;
    • 共享同一个缓动的并发补间(仅当作为锁定组时才正常:一个多目标补间,或一个带有 defaults 的子时间线;setter 驱动的代理计数一次,由其补间上的缓动决定);
    • 从低于 yPercent 130 开始的模糊线条遮罩上升(模糊会渗入遮罩);
    • 被禁用的字体;
    • 缺失的颗粒、暗角或运动模糊。
  7. 对9个维度打分(参考下面的锚点),1–5分,每个维度附带一行原因,指明时间或帧。

  8. 工艺清单(12项,通过/不通过;表格见下文)。

  9. 反庸俗扫描(下方前15项列表)。记录 ID。

  10. 许可。 每个非原创资产(字体、音效、音乐、图片、第三方代码)都有来源和兼容的许可书面记录。字体:OFL 或类似。代码:MIT 或 Apache 并保留头部。任何未知的:标记出来。

评价标准锚点(评分 1–5)

维度135
概念没有想法;文字堆在背景上;任何品牌都能随意替换清晰的一句话理念;部分场景中动效支持该理念从始至终一个强有力的想法,有一个令人惊讶且可拥有的时刻,可以用一句话描述
构图所有元素居中、统一尺寸、杂乱或空虚没有意图有网格,每帧一个主角,合理的负空间每一帧都像海报级:考究的裁剪、深度层次、负空间;布局有变化
排版系统或通用字体、默认字间距、整块淡入淡出正确的拆分单位(行/单词/字符)、遮罩揭示、清晰可读文字就是动画:可变字体轴、动态布局、裁剪/缩放游戏、无瑕的节奏
时间与缓动线性或默认缓动、统一持续时间、没有停顿英雄运动使用自定义缓动、持续时间变化、停顿可读非对称速度、恰到好处的超调、逐帧感觉理所当然的停顿
编排所有元素同时移动或均匀错开英雄引导,支持元素带偏移跟随,有重叠指挥式:一个手势流入下一个,次级动画响应主动画
转场交叉淡入淡出或无关的切设计过的遮罩/擦拭、踩点一个连续的镜头/想法;令人难忘,从不突兀
深度与纹理平面矢量在平面或渐变的背景上,静态帧相机漂移/推进、2个以上深度平面、一些颗粒或光照真实3D或令人信服的2.5D,光照讲述故事,纹理统一而不炫耀
音画同步无声或无关的音频主要剪辑落在节拍上画面和声音一起创作;静音作为重音使用;混音干净
完成度瑕疵、抖动、爆音、锯齿、未加载资源干净、一致、设计过的最后一帧工作室可交付;每一帧都被仔细检查;最后一帧保持并解决

2分和4分位于锚点之间。要打4分:

  • 时间: 按角色划分的缓动调色板,“快出、长停留”的进入,加速的退出。
  • 编排: 预期、跟随动作和基于缓动或距离的错开。
  • 转场: 至少一个匹配剪辑或变形,以及在峰值速度处带模糊的剪辑。
  • 深度: 3层视差和快速运动上的运动模糊。
  • 构图: 至少5倍的比例对比。

一个安静、无音效的作品,在简报中声明为静音的,应根据其静音和视觉节奏来评分音画同步维度;不要惩罚一个有意的选择。

硬性门控(任何一项 = 阻断)

  • check 失败、渲染不确定,或寻找时出现闪烁。
  • 无法阅读的文字:
    • 保持时间短于 0.5 秒 + 每个单词 0.3 秒;
    • 对比度低于 4.5:1;
    • 文字超出安全区域。
  • 字体闪烁、缺失资源、衔接处有破损或空白帧,或首帧/末帧出现跳动。
  • 反庸俗命中3条或以上且无书面理由。
  • 英雄空间运动上使用线性或默认缓动。
  • 工艺清单项缺失且简报中无书面豁免。
  • 每秒超过3次闪烁。
  • 第三方资产无出处或许可记录。

工艺清单(12项)

  1. 概念。 一句话创意,以及大约在运行时40%处的一个标志性时刻。
  2. 英雄帧。 一个设计过的英雄帧(构图 ≥ 4,至少3个深度层)。
  3. 相机。 至少一次真实的相机或深度运动,通过鬼影或侧视检查证明。
  4. 自定义缓动。 至少3种不同的缓动特性,且没有两个并发补间意外共享同一个。
  5. 无默认淡入。 任意位置不得出现 opacity 0→1 + y 20–40→0。
  6. 命名衔接。 衔接命名且速度匹配;至多一个简单交叉淡入淡出。
  7. 运动模糊 在1–3个快速节拍上(在文字被阅读时绝不能用)。
  8. 纹理通道。 颗粒、暗角和径向(光照驱动的)渐变。
  9. 光效事件。 至少一项:扫光、光泽、扫描带、光芒或漏光。
  10. 声音。 如果有音频则音画同步;否则作品声明为静音。
  11. 节奏。
    • 最慢的故事板节拍至少是最快的3倍(节拍是故事板行,不是子补间)。
    • 所有补间中,最大/最小持续时间至少为4。
    • 最后一帧保持至少0.8秒。
    • 最后一帧作为缩略图有效。
  12. 评价分标准 已达成(见交付标准)。

反庸俗前15项

ID表现修复方式
S1每个元素都淡入并上滑20–40像素按角色进入:文字用遮罩/拆分,形状用从点缩放,场景由相机携带
S2所有持续时间相同(都是0.5秒/1秒)持续时间由距离和质量决定;英雄进入0.8–1.5秒,退出快约30%
S3空间运动上使用默认缓动(power1、CSS ease、ease-in-out)或线性使用命名的自定义缓动;非对称“快出、长停留”
S4统一的0.1秒错开从有意义的原点(中心、焦点、阅读顺序)进行缓动错开
S5所有元素同时移动,速度相同一个引导;支持元素晚2–8帧跟随,幅度更小
S6无停顿:进入然后直接退出阅读停留 ≥ 0.5 秒 + 每个单词 0.3 秒
S7死停:到达后冻结长停留、在停留期间微微漂移
S8处处使用弹性/后退/弹跳每个作品至多一个超调,≤ 6%,且仅限于变换
S9无聊的“呼吸”脉冲(缩放/不透明度往复)静止,或一个有动机的环境动画,或一个带最终位姿的相机漂移
S10快速运动没有运动模糊在1–3个最快节拍上使用快门式或方向性模糊
S11居中叠放:标题/副标题/按钮非对称网格、边缘锚定文字、30–50%负空间
S12静态帧,无相机推进、漂移、视差层、在节拍上推进放大
S13“幻灯片”:场景淡出,下一个淡入有动机的衔接:匹配剪辑、动量、遮罩、变形
S14紫色-蓝色/粉红-橙色渐变、玻璃拟态、霓虹全用梯度应像来自光源的光;2–3种色调 + 中性色,强调色 ≤ 10%
S15使用 Inter/Roboto/Poppins 常规体作为“设计”;表情符号或库存图标富有表现力的展示字体、紧密的字间距、重量对比;自定义标记或无

同时注意:

  • 打字机 + 光标作为整个创意;
  • 通用计数数字;
  • Lorem 式文案(“解锁未来的…”);
  • 一个只是停止或淡出的结尾;
  • 没有高潮的平坦能量曲线;
  • 适合任何信息的运动。

交付标准

  • 通过 (APPROVE): 平均分 ≥ 4.0,没有任何维度低于3,零硬性门控。
  • 润色 (POLISH): 平均分 3.5–3.9,或一个维度为3。提供修复列表,然后重新审阅。
  • 重做 (REWORK): 平均分低于 3.5。返回概念和风格帧;打磨无法挽救。

review.md 格式

piece: <名称> · reviewed: <日期> · render: <路径或none>
concept: N — …            composition: N — …        typography: N — …
timing_easing: N — …      choreography: N — …       transitions: N — …
depth_texture: N — …      sound_sync: N — …         finish: N — …
average: N.N
hard_gates: [ … ]
craft_bar: [1 ✓, 2 ✗ (原因), …]
anti_slop_hits: [S1, S7, …]
verdict: APPROVE | POLISH | REWORK   → route fixes to: concept | composition | motion build
contact_sheet: <路径>

然后是一个 Before | After | Why 表格。按影响力排序(影响/工作量),每个“After”必须是精确值:

#位置(时间/帧/选择器)之前之后原因
13.40–3.90 s #titleopacity + y 30, power2.out 0.5 s拆分为行,遮罩揭示,缓动 cubic-bezier(0,.65,.51,.99) 0.9 s,行间隔 +4 帧默认淡入 (S1);无停留 (S7)

修复顺序:删除 → 减少 → 修复缓动 → 修复构图/原点 → 重新计时 → 添加深度/模糊/纹理 → 打磨。 永远不要写“让它更有动感”;始终给出带有数字的配方。

重新审阅

重新审阅由同一个审阅者进行。修复后,重新执行步骤1、步骤3(变更区域及其衔接)和步骤7。任何时间调整都重新运行 check:其对比度样本会随计时移动。保留 review.md 中的旧分数,以便可见改进,并以自己的 verdict: 行结束每一轮。经过3轮润色后停止;如果平均分仍低于4.0,返回 REWORK。


作为免费 mograf 技能的一部分(MIT)。查看完整工作室管线,请访问 mograf.si。库中每个作品都附带其提示词、技能、源代码和文案。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能