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 获取条状图)。
-
结构检查。
npx hyperframes check .任何错误都是阻断性问题。也要读取警告。其对比度审计即为对比度门控。装饰性文字(模糊幽灵、幽灵轨迹克隆、溶解碎片、乱码填充等)通过在节点上添加data-layout-ignore来排除;绝不能用它隐藏真实文案。 -
运动映射。 读取时间线代码(或动画映射文件,如果你的 HyperFrames 技能提供了
animation-map.mjs)。注意:- 持续1秒或更长的没有任何移动的死区;
- 时间过短(< 0.2 秒,太快无法阅读)或过长(> 2 秒,漂移)的空间移动;
- 不规则或机械的错开;
- 意外离开画面或碰撞的元素。
通过代理/setter 对象(自定义相机、three.js、计数器)驱动的运动对基于补间的映射不可见;对这些移动使用帧条状图(步骤5)。
-
联系表。 根据故事板或节拍列表,获取场景和衔接时间。截图:
- 第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也可能添加一个你未要求的额外帧,所以忽略多余的帧。打开图片并查看。仅在元素可见的时间点放大文字(放大隐藏元素可能导致卡死)。 -
深度证明。 对于相机或英雄运动,执行
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 上),在副本中手动构建此洋葱效果:在投影函数中交换一个侧视相机。 -
实时观看。 如果已有渲染文件:
- 制作条状图:
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标签。
- 制作条状图:
-
代码阅读。 对合成文件执行 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开始的模糊线条遮罩上升(模糊会渗入遮罩); - 被禁用的字体;
- 缺失的颗粒、暗角或运动模糊。
-
对9个维度打分(参考下面的锚点),1–5分,每个维度附带一行原因,指明时间或帧。
-
工艺清单(12项,通过/不通过;表格见下文)。
-
反庸俗扫描(下方前15项列表)。记录 ID。
-
许可。 每个非原创资产(字体、音效、音乐、图片、第三方代码)都有来源和兼容的许可书面记录。字体:OFL 或类似。代码:MIT 或 Apache 并保留头部。任何未知的:标记出来。
评价标准锚点(评分 1–5)
| 维度 | 1 | 3 | 5 |
|---|---|---|---|
| 概念 | 没有想法;文字堆在背景上;任何品牌都能随意替换 | 清晰的一句话理念;部分场景中动效支持该理念 | 从始至终一个强有力的想法,有一个令人惊讶且可拥有的时刻,可以用一句话描述 |
| 构图 | 所有元素居中、统一尺寸、杂乱或空虚没有意图 | 有网格,每帧一个主角,合理的负空间 | 每一帧都像海报级:考究的裁剪、深度层次、负空间;布局有变化 |
| 排版 | 系统或通用字体、默认字间距、整块淡入淡出 | 正确的拆分单位(行/单词/字符)、遮罩揭示、清晰可读 | 文字就是动画:可变字体轴、动态布局、裁剪/缩放游戏、无瑕的节奏 |
| 时间与缓动 | 线性或默认缓动、统一持续时间、没有停顿 | 英雄运动使用自定义缓动、持续时间变化、停顿可读 | 非对称速度、恰到好处的超调、逐帧感觉理所当然的停顿 |
| 编排 | 所有元素同时移动或均匀错开 | 英雄引导,支持元素带偏移跟随,有重叠 | 指挥式:一个手势流入下一个,次级动画响应主动画 |
| 转场 | 交叉淡入淡出或无关的切 | 设计过的遮罩/擦拭、踩点 | 一个连续的镜头/想法;令人难忘,从不突兀 |
| 深度与纹理 | 平面矢量在平面或渐变的背景上,静态帧 | 相机漂移/推进、2个以上深度平面、一些颗粒或光照 | 真实3D或令人信服的2.5D,光照讲述故事,纹理统一而不炫耀 |
| 音画同步 | 无声或无关的音频 | 主要剪辑落在节拍上 | 画面和声音一起创作;静音作为重音使用;混音干净 |
| 完成度 | 瑕疵、抖动、爆音、锯齿、未加载资源 | 干净、一致、设计过的最后一帧 | 工作室可交付;每一帧都被仔细检查;最后一帧保持并解决 |
2分和4分位于锚点之间。要打4分:
- 时间: 按角色划分的缓动调色板,“快出、长停留”的进入,加速的退出。
- 编排: 预期、跟随动作和基于缓动或距离的错开。
- 转场: 至少一个匹配剪辑或变形,以及在峰值速度处带模糊的剪辑。
- 深度: 3层视差和快速运动上的运动模糊。
- 构图: 至少5倍的比例对比。
一个安静、无音效的作品,在简报中声明为静音的,应根据其静音和视觉节奏来评分音画同步维度;不要惩罚一个有意的选择。
硬性门控(任何一项 = 阻断)
check失败、渲染不确定,或寻找时出现闪烁。- 无法阅读的文字:
- 保持时间短于 0.5 秒 + 每个单词 0.3 秒;
- 对比度低于 4.5:1;
- 文字超出安全区域。
- 字体闪烁、缺失资源、衔接处有破损或空白帧,或首帧/末帧出现跳动。
- 反庸俗命中3条或以上且无书面理由。
- 英雄空间运动上使用线性或默认缓动。
- 工艺清单项缺失且简报中无书面豁免。
- 每秒超过3次闪烁。
- 第三方资产无出处或许可记录。
工艺清单(12项)
- 概念。 一句话创意,以及大约在运行时40%处的一个标志性时刻。
- 英雄帧。 一个设计过的英雄帧(构图 ≥ 4,至少3个深度层)。
- 相机。 至少一次真实的相机或深度运动,通过鬼影或侧视检查证明。
- 自定义缓动。 至少3种不同的缓动特性,且没有两个并发补间意外共享同一个。
- 无默认淡入。 任意位置不得出现
opacity 0→1+y 20–40→0。 - 命名衔接。 衔接命名且速度匹配;至多一个简单交叉淡入淡出。
- 运动模糊 在1–3个快速节拍上(在文字被阅读时绝不能用)。
- 纹理通道。 颗粒、暗角和径向(光照驱动的)渐变。
- 光效事件。 至少一项:扫光、光泽、扫描带、光芒或漏光。
- 声音。 如果有音频则音画同步;否则作品声明为静音。
- 节奏。
- 最慢的故事板节拍至少是最快的3倍(节拍是故事板行,不是子补间)。
- 所有补间中,最大/最小持续时间至少为4。
- 最后一帧保持至少0.8秒。
- 最后一帧作为缩略图有效。
- 评价分标准 已达成(见交付标准)。
反庸俗前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”必须是精确值:
| # | 位置(时间/帧/选择器) | 之前 | 之后 | 原因 |
|---|---|---|---|---|
| 1 | 3.40–3.90 s #title | opacity + 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。库中每个作品都附带其提示词、技能、源代码和文案。