review-loop（HyperFrames 版）是一个针对动画影片的视觉自我审查循环技能，改编自 whaleyxbt/claude-motion 的 review-loop skill（MIT 许可）。其核心原则是：在未查看当前版本输出的 contact sheet 之前，不得宣称影片完成。
用途：用于动画影片制作过程中的质量自检，确保画面构图、文字可读性、节奏、一致性以及声音（如有）符合检查表要求。只要动画的视觉画面或时间发生任何修改，以及在最终宣告影片完成之前，都必须执行此循环。
主要能力：
- 机器检查：通过 npx hyperframes check 一次性执行 lint、执行期、版面溢出、动作和对比度检查。若遮罩揭示在进场途中报 container_overflow 属于刻意设计，可在遮罩容器加 data-layout-allow-overflow；若落定后仍报 text_box_overflow，则需加高容器。
- 输出草稿：运行 npx hyperframes render --quality draft --output renders/draft.mp4。
- 生成 contact sheet：取每个节拍落定时刻，以 4×2 拼成 beats-N.png，每格标注时间，默认 360px 宽（手机动态宽度）。节拍时间依项目类型而定：motion-explainer 系列（有 audio_meta.json）取每个旁白子句结束前 0.15 秒；用 timeline.js 管理节拍的项目取每个节拍后 0.3 秒。
- 逐张审查：打开每张 sheet，对照检查表逐项核对。可疑处可放大查看，如扫一段转场、看特定时刻、看单格全分辨率，或直接从 composition 截图拼图。
- 修正后回到第一步，完整跑一轮无问题才停止。
- 最终输出高品質成片后，再对成片跑一次审查，并做声音检查。
检查表涵盖：
- 构图：每格单一焦点、无非刻意碰撞或重叠、重要内容距边缘约 60px 以上、第 0 格为真实画面而非黑屏。
- 文字：未被遮挡或切边、手机宽度下关键信息可读、阅读时文字不运动；中文无错字、全繁体字形、全形标点、无字型缺字。
- 节奏：可读状态停留足够、场景重叠衔接、退场快于进场。
- 一致性：仅用 :root 色票颜色、同一元素各场景外观一致。
- 声音（如有）：用 ffmpeg 生成波形图检查峰值是否落在节拍上；用 ebur128 检查响度，目标 −14 LUFS ±1，true peak ≤ −1 dBFS；中文旁白的口音和情绪需用户亲耳判断。
使用方式：技能文件夹通常位于 ~/.claude/skills/review-loop（Claude Code）或 ~/.agents/skills/review-loop（Codex）。所有路径使用绝对路径。SHEET 指 python "<此技能資料夾>/scripts/sheet.py"。需要 Python + Pillow 和 ffmpeg。命令示例：SHEET --video <專案>/renders/draft.mp4 --at "$(python <motion-explainer 系列技能資料夾>/scripts/review_times.py --project <專案>)" --out <專案>/review --name draft；或 SHEET --video <專案>/renders/draft.mp4 --timeline <專案>/timeline.js --out <專案>/review。
适用场景：动画影片（尤其是 motion-explainer 系列和 motion-design 项目）的视觉质量审查与迭代修正。
限制：无法直接观看影片，只能通过截图审查画面；需要 Python、Pillow 和 ffmpeg 环境；声音的口音和情绪判断需用户亲自聆听，不能以分数替代。回報時需清楚说明检查了什么、修了什么、哪张 sheet 可见结果；未重新输出并亲眼查看的修正不得宣称已修好。