Communitygithub.com

Parrass/mograf-public

獨立的動態圖形評論與品質把關工具。根據九維度工作室評分標準為 HyperFrames / GSAP / HTML(或 Remotion)作品評分,檢查硬性門檻、12 項工藝標準與反抄襲清單,實際分析影格後返回 APPROVE / POLISH / REWORK 並附上精確的影格級修正建議。建議在每次交付前渲染、每次修訂後,以及被要求審查、評論、『讓它更好』或『這好嗎?』時使用。最好以全新脈絡的子代理執行,以避免創作者為自己的作品評分。

mograf-public 是什麼?

motion-review 是一個專業的動態圖形評論技能,旨在為使用 HyperFrames、GSAP、HTML 或 Remotion 等技術堆疊的作品提供客觀的品質把關。與傳統的程式碼檢查不同,此技能專注於『品味』與美學品質,採用嚴格的九維度評分標準(包括概念、構圖、字體、時間與緩動、編排、轉場、深度與質感、聲音同步、完成度),以及額外的 12 項工藝標準與反抄襲清單。 該技能透過實際檢查影格、分析時間線程式碼、生成聯絡表與深度校驗圖片來評估作品。它支援 HyperFrames(使用 npx hyperframes 指令)與 Remotion(使用 npx remotion 指令)等平台,並提供詳細的 review.md 報告,包含分數、硬性門檻檢查結果以及精確的影格級修正建議。分級系統包括 APPROVE(平均分 ≥ 4.0)、POLISH(平均分 3.5-3.9)與 REWORK(平均分 < 3.5),確保只有高品質的作品才能通過。 為了避免偏見,強烈建議將此技能作為全新脈絡的子代理執行,讓評論者不會受到創作過程的影響。這確保了客觀、嚴格的評估,最終提升最終作品的品質與專業度。

相容平台~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 並傳回 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)。

  1. 結構。 npx hyperframes check . 任何錯誤都是 Block。也要閱讀警告。其對比度稽核即為對比度門檻。永遠不打算被閱讀的裝飾性文字(模糊鬼影、鬼影軌跡複製、溶解碎片、亂碼填充)應透過在每個節點上使用 data-layout-ignore 來排除;切勿用它來隱藏真正的文字。

  2. 動作地圖。 閱讀時間線程式碼(或動畫地圖,如果您的 HyperFrames 技能提供了 animation-map.mjs)。請注意:

    • 超過 1 秒沒有任何物件移動的死區;
    • 少於 0.2 秒(太快以至於無法閱讀)或超過 2 秒(飄移)的空間移動;
    • 不規則或機械式的錯開;
    • 意外離開畫面或碰撞的元素。

    透過代理/setter 物件(自訂攝影機、three.js、計數器)驅動的動作,對於以 tween 為基礎的地圖是不可見的;對於這類移動,請使用影格 strip(步驟 5)。

  3. 聯絡表。 從分鏡表或節拍清單中,取得場景與接縫時間。快照:

    • 影格 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())"),而不是使用 rm glob 來刪除;--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. 真實速度觀看。 如果存在渲染結果:

    • 製作 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 標籤。
  6. 程式碼閱讀。 在作品中 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 開始的模糊線條遮罩升起(模糊會滲入遮罩);
    • 禁止使用的字型;
    • 缺少顆粒、暗角或動態模糊。
  7. 評分 9 個維度(錨點如下),1-5 分,每個維度附上一行與時間或影格相關的理由。

  8. 工藝標準(12 項,通過/失敗;表格如下)。

  9. 反抄襲掃描(前 15 名清單如下)。記錄 ID。

  10. 授權。 每個非原創資產(字型、音效、音樂、圖片、第三方程式碼)都必須有記錄的來源與相容的授權。字型:OFL 或類似。程式碼:MIT 或 Apache 並保留標頭。任何未知項目:標記它。

評分標準錨點(1-5 分)

維度135
概念沒有想法;背景上的文字;任何品牌都可以替換清楚的一行想法;動作在一定程度上支持它從頭到尾一個強烈的主意,帶有令人驚訝、獨特的時刻,可以用一句話描述
構圖所有東西都置中,大小一致,擁擠或空無一物網格,每個畫面一個主角,適當的留白每個靜止畫面都像海報:刻意裁剪、深度圖層、留白;佈局會演變
字體系統或通用字型,預設字距,整個區塊淡入淡出正確的分割單位(行/字/字元),遮罩揭示,清晰可讀字型就是動畫:可變軸線、動態佈局、裁切/縮放遊戲、無可挑剔的節奏
時間與緩動線性或預設緩動,統一持續時間,沒有暫停主角移動使用自訂緩動,持續時間變化,暫停可讀不對稱速度、品味恰到好處的 overshoot、讓每個影格都感覺無可避免的暫停
編排所有東西一起移動或以統一的錯開方式移動主角領先,輔助元素跟隨並帶有偏移,有重疊指揮若定:一個手勢流入下一個,次要動作對主要動作做出反應
轉場交叉淡出或不相關的剪接設計過的遮罩/擦拭,對準節拍一個連續的攝影機/想法;令人難忘,絕不無謂
深度與質感平坦的向量加上平坦的漸層,靜態畫面攝影機推近/漂移,2 個以上深度平面,一些顆粒或光線真正的 3D 或令人信服的 2.5D,光線說故事,質感統一而不炫耀
聲音同步無聲或不相關的音訊主要剪接對準節拍畫面與聲音共同創作;沉默作為一種強調;乾淨的混音
完成度錯誤、抖動、爆音、鋸齒、未載入的資產乾淨、一致、設計過的結束畫面可交付工作室等級;每個影格都經過仔細檢查;結束畫面維持且得到解決

2 分和 4 分位於錨點之間。要獲得 4 分:

  • 時間: 依角色區分的緩動調色板,「快速出場,長時間穩定」的進場,加速出場。
  • 編排: 預期動作、跟隨動作以及基於距離或緩動的錯開。
  • 轉場: 至少一個匹配剪接或變形,以及在最高速度下的剪接帶有模糊。
  • 深度: 三平面視差以及快速移動上的動態模糊。
  • 構圖: 至少 5 倍的尺寸對比。

一個在簡報中宣告自己為沉默、無音效的作品,應根據其沉默與視覺節奏來評分「聲音同步」;不要處罰一個刻意的選擇。

硬性門檻(任何一項 = Block)

  • check 失敗,渲染結果是非確定性的,或 seek 顯示出錯誤。
  • 無法閱讀的文字:
    • 停留時間少於 0.5 秒 + 每個單字 0.3 秒;
    • 對比度低於 4.5:1;
    • 文字跨越安全區域。
  • 字型閃爍、缺少資產、接縫處有破損或空影格,或第一個或最後一個影格有爆點。
  • 3 個或更多反抄襲命中,且沒有書面理由。
  • 主角空間移動使用線性或預設緩動。
  • 工藝標準項目缺失,且未在簡報中有書面豁免。
  • 每秒超過 3 次閃爍。
  • 第三方資產沒有記錄的來源或授權。

工藝標準(12 項)

  1. 概念。 一句話的主意,以及在大約 40 % 的執行時間內出現的標誌性時刻。
  2. 主角靜止畫面。 一個設計過的主角影格(構圖 ≥ 4,至少 3 個深度圖層)。
  3. 攝影機。 至少一個真實的攝影機或深度移動,透過 ghost 或側角檢查證明。
  4. 自訂緩動。 至少 3 種不同的緩動特性,且沒有兩個並發的 tween 意外共用一個。
  5. 無預設淡入。 任何地方都沒有 opacity 0→1 + y 20-40→0。
  6. 命名接縫。 接縫已命名且速度匹配;最多一個普通交叉淡出。
  7. 動態模糊 在 1-3 個快速節拍上(絕不在文字被閱讀時應用)。
  8. 質感處理。 顆粒、暗角與放射狀(光線驅動的)漸層。
  9. 光線事件。 至少一項:掃掠、光澤、掃描帶、光暈或漏光。
  10. 聲音。 如果有音訊則為聲音同步;否則作品宣告為沉默。
  11. 節奏。
    • 最慢的分鏡表節拍至少是最快的 3 倍(節拍指分鏡表行,而非子 tween)。
    • 在所有 tween 中,最大/最小持續時間至少為 4。
    • 最終靜止畫面至少維持 0.8 秒。
    • 最後一個影格適合作為縮圖。
  12. 評分標準已滿足(請參閱交付標準)。

反抄襲前 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 %
S15Inter/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 / 影格 / 選取器)BeforeAfterWhy
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.

相關技能