motion-review:品味把關
程式碼檢查工具能找出錯誤的程式碼。這項技能則能找出品味問題。預設態度:先標記問題;批准需要努力爭取。 一件『看起來不錯』的作品只能獲得 3 分,而 3 分不能交付。
執行方式
- 盡可能以全新子代理身分執行。提供:此檔案、專案資料夾與簡報。不要告訴它建置過程有多困難。
- 評論者絕不編輯作品。它會在專案資料夾中寫入
review.md並傳回 verdict。 - 要觀察像素,而不只是程式碼。每個分數都必須指向一個時間戳記、影格或選取器。
- 每件作品只由一位評論者負責。 兩位評論者同時執行會寫入同一個
review.md,導致 verdict 衝突。每個回合以一個verdict:行結束;呼叫者輪詢review.md以取得 verdict。重新審查會交給同一位評論者;只有在review.md長時間未顯示新回合時,才啟動替代評論者,在review.md中註明取消,並讓替代評論者先閱讀歷史記錄。如果回合衝突,review.md的最後一次寫入具有權威性。
程序
執行每個步驟。指令假設為 HyperFrames 專案(npx hyperframes …);其他技術堆疊請使用等效指令(Remotion:用 npx remotion still 取得影格,用 npx remotion render 取得 strip)。
-
結構。
npx hyperframes check .任何錯誤都是 Block。也要閱讀警告。其對比度稽核即為對比度門檻。永遠不打算被閱讀的裝飾性文字(模糊鬼影、鬼影軌跡複製、溶解碎片、亂碼填充)應透過在每個節點上使用data-layout-ignore來排除;切勿用它來隱藏真正的文字。 -
動作地圖。 閱讀時間線程式碼(或動畫地圖,如果您的 HyperFrames 技能提供了
animation-map.mjs)。請注意:- 超過 1 秒沒有任何物件移動的死區;
- 少於 0.2 秒(太快以至於無法閱讀)或超過 2 秒(飄移)的空間移動;
- 不規則或機械式的錯開;
- 意外離開畫面或碰撞的元素。
透過代理/setter 物件(自訂攝影機、three.js、計數器)驅動的動作,對於以 tween 為基礎的地圖是不可見的;對於這類移動,請使用影格 strip(步驟 5)。
-
聯絡表。 從分鏡表或節拍清單中,取得場景與接縫時間。快照:
- 影格 0、高潮時刻與最後一個影格;
- 每個場景的 25 / 50 / 75 %;
- 每個接縫在 −2 影格、0 影格與 +2 影格的位置。
npx hyperframes snapshot --at <t1,t2,…>。傳入精確的影格時間(t = frame / fps,例如在 30 fps 下的影格 316 →10.5333);--at不會進行快照,因此四捨五入的時間會顯示一個渲染從未包含的中間姿勢。snapshot會留下先前執行的過時 PNG,因此請在每次執行前將舊的snapshots/目錄移開(例如node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())"),而不是使用rmglob 來刪除;--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 上),請手動構建此洋蔥圖層:在臨時副本中將側攝影機交換到投影函數中。 -
真實速度觀看。 如果存在渲染結果:
- 製作 strip:
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進行解碼來驗證 alpha(串流讀取為yuva420p)或檢查ALPHA_MODE=1標籤。
- 製作 strip:
-
程式碼閱讀。 在作品中 grep 尋找:
ease:(列出使用的每個緩動)與持續時間;- 僅透明度的進場與小的
y:偏移(20-40 px); Math.random/Date.now(非確定性);back.out|elastic|bounce、yoyo、repeat: -1;- 空間移動上的 linear 或
power1;允許清單之外的緩動(mg.*、power3.out、expo.out、power3.in、power4.out、power2.inOut、none、烘焙的 spring); - 共用一個緩動的並發 tween(僅在作為鎖定群組時才可接受:一個多重目標 tween 或一個帶有
defaults的子時間線;setter 驅動的代理只計一次,根據其 tween 的緩動); - 從低於
yPercent 130開始的模糊線條遮罩升起(模糊會滲入遮罩); - 禁止使用的字型;
- 缺少顆粒、暗角或動態模糊。
-
評分 9 個維度(錨點如下),1-5 分,每個維度附上一行與時間或影格相關的理由。
-
工藝標準(12 項,通過/失敗;表格如下)。
-
反抄襲掃描(前 15 名清單如下)。記錄 ID。
-
授權。 每個非原創資產(字型、音效、音樂、圖片、第三方程式碼)都必須有記錄的來源與相容的授權。字型:OFL 或類似。程式碼:MIT 或 Apache 並保留標頭。任何未知項目:標記它。
評分標準錨點(1-5 分)
| 維度 | 1 | 3 | 5 |
|---|---|---|---|
| 概念 | 沒有想法;背景上的文字;任何品牌都可以替換 | 清楚的一行想法;動作在一定程度上支持它 | 從頭到尾一個強烈的主意,帶有令人驚訝、獨特的時刻,可以用一句話描述 |
| 構圖 | 所有東西都置中,大小一致,擁擠或空無一物 | 網格,每個畫面一個主角,適當的留白 | 每個靜止畫面都像海報:刻意裁剪、深度圖層、留白;佈局會演變 |
| 字體 | 系統或通用字型,預設字距,整個區塊淡入淡出 | 正確的分割單位(行/字/字元),遮罩揭示,清晰可讀 | 字型就是動畫:可變軸線、動態佈局、裁切/縮放遊戲、無可挑剔的節奏 |
| 時間與緩動 | 線性或預設緩動,統一持續時間,沒有暫停 | 主角移動使用自訂緩動,持續時間變化,暫停可讀 | 不對稱速度、品味恰到好處的 overshoot、讓每個影格都感覺無可避免的暫停 |
| 編排 | 所有東西一起移動或以統一的錯開方式移動 | 主角領先,輔助元素跟隨並帶有偏移,有重疊 | 指揮若定:一個手勢流入下一個,次要動作對主要動作做出反應 |
| 轉場 | 交叉淡出或不相關的剪接 | 設計過的遮罩/擦拭,對準節拍 | 一個連續的攝影機/想法;令人難忘,絕不無謂 |
| 深度與質感 | 平坦的向量加上平坦的漸層,靜態畫面 | 攝影機推近/漂移,2 個以上深度平面,一些顆粒或光線 | 真正的 3D 或令人信服的 2.5D,光線說故事,質感統一而不炫耀 |
| 聲音同步 | 無聲或不相關的音訊 | 主要剪接對準節拍 | 畫面與聲音共同創作;沉默作為一種強調;乾淨的混音 |
| 完成度 | 錯誤、抖動、爆音、鋸齒、未載入的資產 | 乾淨、一致、設計過的結束畫面 | 可交付工作室等級;每個影格都經過仔細檢查;結束畫面維持且得到解決 |
2 分和 4 分位於錨點之間。要獲得 4 分:
- 時間: 依角色區分的緩動調色板,「快速出場,長時間穩定」的進場,加速出場。
- 編排: 預期動作、跟隨動作以及基於距離或緩動的錯開。
- 轉場: 至少一個匹配剪接或變形,以及在最高速度下的剪接帶有模糊。
- 深度: 三平面視差以及快速移動上的動態模糊。
- 構圖: 至少 5 倍的尺寸對比。
一個在簡報中宣告自己為沉默、無音效的作品,應根據其沉默與視覺節奏來評分「聲音同步」;不要處罰一個刻意的選擇。
硬性門檻(任何一項 = Block)
check失敗,渲染結果是非確定性的,或 seek 顯示出錯誤。- 無法閱讀的文字:
- 停留時間少於 0.5 秒 + 每個單字 0.3 秒;
- 對比度低於 4.5:1;
- 文字跨越安全區域。
- 字型閃爍、缺少資產、接縫處有破損或空影格,或第一個或最後一個影格有爆點。
- 3 個或更多反抄襲命中,且沒有書面理由。
- 主角空間移動使用線性或預設緩動。
- 工藝標準項目缺失,且未在簡報中有書面豁免。
- 每秒超過 3 次閃爍。
- 第三方資產沒有記錄的來源或授權。
工藝標準(12 項)
- 概念。 一句話的主意,以及在大約 40 % 的執行時間內出現的標誌性時刻。
- 主角靜止畫面。 一個設計過的主角影格(構圖 ≥ 4,至少 3 個深度圖層)。
- 攝影機。 至少一個真實的攝影機或深度移動,透過 ghost 或側角檢查證明。
- 自訂緩動。 至少 3 種不同的緩動特性,且沒有兩個並發的 tween 意外共用一個。
- 無預設淡入。 任何地方都沒有
opacity 0→1+y 20-40→0。 - 命名接縫。 接縫已命名且速度匹配;最多一個普通交叉淡出。
- 動態模糊 在 1-3 個快速節拍上(絕不在文字被閱讀時應用)。
- 質感處理。 顆粒、暗角與放射狀(光線驅動的)漸層。
- 光線事件。 至少一項:掃掠、光澤、掃描帶、光暈或漏光。
- 聲音。 如果有音訊則為聲音同步;否則作品宣告為沉默。
- 節奏。
- 最慢的分鏡表節拍至少是最快的 3 倍(節拍指分鏡表行,而非子 tween)。
- 在所有 tween 中,最大/最小持續時間至少為 4。
- 最終靜止畫面至少維持 0.8 秒。
- 最後一個影格適合作為縮圖。
- 評分標準已滿足(請參閱交付標準)。
反抄襲前 15 名
| id | 特徵 | 修正 |
|---|---|---|
| S1 | 每個元素都淡入並向上滑動 20-40 px | 依角色決定進場方式:文字用遮罩/分裂,形狀用從點縮放,場景用攝影機攜帶 |
| 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 | 所有東西都使用 elastic/back/bounce | 每件作品最多一次 overshoot,≤ 6%,僅限於 transforms |
| S9 | 閒置的「呼吸」脈衝(scale/opacity yoyo) | 靜止,或一個有動機的環境,或一個有結束姿勢的攝影機漂移 |
| S10 | 快速移動沒有動態模糊 | 在 1-3 個最快的節拍上使用快門式或方向性模糊 |
| S11 | 置中堆疊:標題 / 副標題 / 按鈕 | 不對稱網格,邊緣錨定文字,30-50 % 留白 |
| S12 | 靜態畫面,沒有攝影機 | 推近、漂移、視差圖層、在節拍上 punch-in |
| 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: <路徑或無>
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」都是一個精確的值:
| # | 位置 (t / 影格 / 選取器) | Before | After | Why |
|---|---|---|---|---|
| 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。庫中的每件作品都附有其提示、技能、原始碼與副本。