Communitygithub.com

edit-motion-graphics

設計、構建和審查基於 HyperFrames/GSAP 的動態圖形影片,適用於產品或應用程式發布、功能公告、動態文字排版、標誌動畫、UI 說明和動態截圖。

edit-motion-graphics 是什麼?

這是一個專門用於創建動態圖形影片(MP4 格式)的 AI 代理技能,其核心工作流程是圍繞 HyperFrames HTML 和 GSAP 時間軸構建。此技能的獨特之處在於,它堅持「先有框架級別 PROMPT.md,後有程式碼」的嚴格原則,並要求人類批准該提示文件後才能開始編碼。它旨在為各種註冊模式(如產品發布、動態排版、標誌動畫、解釋器和平靜風格)提供結構化、可重複的動畫製作流程。該技能強制執行一套詳盡的守門檢查(Gates),涵蓋從最初的腳本攝入(G0)到最終的渲染品質保證(G10),涵蓋規格完整性、運動流暢度、密度、3D 資產決策、調色板鎖定、資源來源檢查、尋址安全性和音訊混合等方面。每個檢查都需要通過特定的可重複測試,否則會阻止進一步的進程。此技能支援 Claude Code、Cursor 和 Codex 等平台,並透過詳細的參考文件和腳本(如 `motion_spec_check.py` 和 `palette_audit.py`)提供指導,以確保自動化和高品質的輸出,同時避免昂貴的 API 呼叫或非授權資產。它專注於技術生成,而非人工編輯或純 AI 生成內容,並包含針對「無聊 / 看起來像 AI / 靜態」等使用者反饋的具體處理程序,要求替換創意概念而非進行微調。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/edit-motion-graphics

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

edit-motion-graphics 是做什麼的?

一個完成動態影片(MP4)的成果負責人,該影片建構為 HyperFrames HTML 加上一個暫停的 GSAP 時間軸。框架級別的 PROMPT.md 是產品;程式碼僅用於渲染它。

不可協商的規則(請先閱讀)

  1. 在批准的框架級別 PROMPT.md 之前無程式碼 - 即使在自主執行中:代理起草,人類批准(決策預設 Q6)。批准是檔案中的一行記錄 APPROVAL: <who> <date>。變更順序始終是:分類帳 -> PROMPT.md -> 程式碼。
  2. 此處無花費。 AI-3D、AI 靜態圖片或任何付費生成都需通過 paid-generation-gate;此技能不進行任何付費呼叫。目錄清單不等於帳戶存取權限。
  3. 審查順序: Studio 預覽 -> hf_segment 範圍 -> 每輪意見一次完整渲染 -> 最終渲染的逐幀 QA。一次只處理一個繁重任務 (render_lock)。批次處理意見;在使用者仍在編寫時進行診斷,但不要渲染。
  4. 常見陷阱: 不要在 HyperFrames 根元素上使用 dir="rtl"(僅在文字元素上使用 RTL,在 <html> 上使用 lang="he");從檔案載入字體(hf/fonts/ 中的 @font-face);hyperframes snapshot --describe false,每次呼叫不超過 5 個時間戳;使用 ASCII 工作根目錄 (new_project)。
  5. 故障關閉: 無法執行的閘道狀態為 blocked (not_run),絕非 pass。超時、空樣本或遺失的渲染永遠不會通過。成功的工具呼叫是執行證據;已檢視的渲染是外觀證據;靜態圖片無法證明動態。
  6. 規則 vs. 品味: 規則 1-5 是規則。以下標記為 studio style 的項目(預設無字幕、禁止清單、「禁止粉紅色」、Higgsfield 語法、21st-first)是擁有者的品味,並附有理由說明;與之衝突的簡報在品味上優先,但絕不繞過閘道。
  7. 數字攜帶其幀率(除非簡報另有說明,否則為 30)和測量時間攜帶機器資訊(擁有者的 Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB)。NVIDIA/Apple 時間未經測量。限制花費、安裝或發佈的專案會覆蓋此技能。

輸入 -> 輸出

輸入:簡報/分類帳(來自 video-intake)、品牌套件、UI 截圖或元件、音樂/旁白。輸出:hf/PROMPT.md(框架級別)、hf/DESIGN.md(一個鎖定的調色板 + 類型 + 動態令牌)、hf/cues.js(圖片和聲音的單一時間來源)、hf/SOURCES.md、合成檔案、mix.wav、最終 MP4、QA 報告。交接:意見 -> revision-round;其他比例 -> multi-video-variants(完全重新佈局,絕非裁切);交付閘道 -> render-qa-deliver;給定參考 -> 先通過 reference-style-transfer(無參考 -> 詢問哪個時間範圍是「風格」)。

步驟

  1. 註冊 + 攝入。 選擇一個註冊模式(launch | kinetic | logo | explainer | calm)並鎖定長度、比例、旁白、音樂、交付檔案名稱(references/launch-register-and-pace.md)。一個 30 秒的密集發布感覺快了 1.7 倍;批准的長度是 45 秒:先決定長度。
  2. 草擬 PROMPT.md + DESIGN.md(6 個區塊;攝影機、接縫和事件表;任何 3D 的節拍卡)。執行 python scripts/motion_spec_check.py hf/PROMPT.md --register <r>;修復;請求批准。
  3. 來源節拍(references/ui-sources-and-port.md):目錄 -> hf-blocks -> shadcn 註冊表(預設)-> 僅在有帳戶時使用 21st.dev -> 手動構建;為每個節拍決定 3D(references/three-d-decision.md)。
  4. 構建一個 index.html + cues.js;移植的元件需重新編寫為尋址安全的。然後執行 hf_preflight --strict、python scripts/seek_safe_scan.py hf/、python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D renders>]。
  5. 視覺上批准: 四張靜態圖片 + 每個接縫的快照 + sheet 聯絡表;Studio 預覽;意見批次。
  6. 聲音(references/sound-and-captions.md):hf_mix --report;在每個品牌事件上使用品牌音效;混合並測量最終檔案。
  7. 一次完整渲染,在鎖定下,並附上預計完成時間;frame_qa、motion_qa、hf_deliver;使用一個單獨的評論者根據 agent-content/benchmarks/motion-graphics.rubric.md 評分;呈現檔案、編號的變更、已核對的分類帳和誠實的差距。

註冊模式一覽(詳細資訊:references/launch-register-and-pace.md)

註冊模式新畫面事件節奏攝影機聲音
launch每 2-6 秒,>= 2 個深度層<= 0.5-1 秒;手動計數 45-110 次/分鐘永不停止(漂移 2-4 %/s,推入 8-15 %)音樂即為音效;每個品牌事件使用品牌音效;尾音淡出
kinetic每 1-3 秒最高約 200 次/分鐘(單詞交換也算)文字即攝影機關鍵字在說出後 0..+7 幀處落下
logo一個想法,3-8 秒結果在 0.4-0.75 秒內可見一個動作 + 穩定在揭示時使用品牌音效;三步驟結尾
explainer每個想法,3-6 秒30-110 次/分鐘有目的,朝向被解釋的物體以旁白為主;僅在可見變化時使用音效
calm允許停留稀疏即可緩慢或鎖定一個均勻的背景音樂 + 微妙的效果音;無漸強/漸弱

每個節拍的 3D(五行描述)

為每個節拍決定,並在 PROMPT.md 中寫下理由:

  • Blender:適用於螢幕上顯示超過 2 秒的真實幾何圖形 / 主要材質(優先使用 EEVEE;在 384-640 px 下測量為 1.2-2.25 秒/幀,每次發布增加 1-1.5 分鐘);
  • Three.js:適用於資料驅動、實例化、帶有即時文字的 3D-UI、可迭代編輯或確切十六進制節拍的場景,需先通過 1 秒 hf_segment AMD 閘道;
  • AI-3D:僅在 paid-generation-gate 和許可證檢查之後使用;
  • 2.5D(depth_25d,Depth Anything V2 Small,每 2 秒片段 8.1-9.9 秒):適用於需要小動畫的靜態圖片;
  • 無:適用於 UI/訊息節拍。3D 物體永遠不應遮擋資訊,並需對文字做出反應。

在時間戳處感到「無聊 / 看起來像 AI / 靜態」

替換節拍概念,而非修飾它。從選單中選擇:由真實旁白頻譜驅動的聲音球體;資料驅動的構建(長條圖、計數器、路線地球儀);在程式碼中重建 UI 並作為物體拍攝(透視、景深、150-300% 放大倍率);承載內容的共享元素變形;原地進行的數字或單詞交換;落在關鍵字上的 3D 主角。絕不使用小角落的「功能膠囊」、帶有小推入的平面截圖,或黑底上的點。將此筆記添加到「禁止」行,並在每次出現時修復(重複時的全局規則)。

時間預算(在擁有者的機器上建模或測量;非學生測量)

目標:在約 3-4 小時內,經過 1-2 輪修正,呈現 30-45 秒發布版本的第一個可展示草稿(第一個真正的發布花了 10 個草稿、7 輪評論者、4 輪擁有者意見);每輪恰好一次完整渲染。渲染參考(HyperFrames 0.8.98,E11,繁重 40 秒 / 1200 幀):1 個工作線程 132.6 秒,4 個工作線程 92.8 秒,8 個工作線程 88.1 秒;瀏覽器 GPU -12%;擷取是瓶頸(CPU 僅使用 16 個邏輯核心中的 2-3 個)。早期的高級渲染:通常 8-14 分鐘,觀測範圍 4-21 分鐘(0.8.79-0.8.93)。始終對一個單元進行基準測試,並在超過 3 分鐘的任務前發布預估完成時間(ETA)行。

閘道

狀態:pass | fail | blocked | n/a,始終附有理由。

閘道條件證據若為假負責人重新檢查
G0 攝入已記錄註冊模式、長度、比例、交付檔案名稱、旁白/音樂來源、參考答案hf/BRIEF.md詢問(每輪 3-4 個問題);blockedvideo-intake簡報變更
G1 框架級別規格6 個區塊;每個節拍都有幀數、像素、緩動、聲音、轉場;「禁止」行;十六進制調色板;APPROVAL: 行motion_spec_check.py 退出碼 0(2 = 缺少批准 = blocked)修復規格;在程式碼之前停止此技能 + 人類批准者任何重定時或新節拍
G2 清晰流暢每個場景一條樣條曲線,每個移動 >= 1.2 秒,反向移動 >= 1 秒且 <= 1.3 倍,文字在每個關鍵幀內;接縫出口 = 入口,主角持續存在,無重複技術,無淡入淡出PROMPT 中的表格 + 檢查器;渲染上的 motion_qa 無卡頓範圍重新定時 / 重新路徑;替換節拍概念而非修飾此技能任何攝影機或接縫變更
G3 密度每個註冊模式:發布 = 每 2-6 秒新畫面,事件間隔 <= 0.7 秒(聲明的呼吸除外),45-110 事件/分鐘(手動計數)事件表 + 每個場景 3 個幀樣本添加或替換節拍;拉伸長時間移動 1.6 倍而非塞入此技能任何重定時後
G4 每個節拍的 3D每個 3D 節拍有一張卡片:路線(Blender / Three.js / AI-3D / 2.5D / 無)、一句話理由、預估時間、閘道證據、許可證節拍卡表格;Three.js 行:1 秒 hf_segment 幀不為空白重新決定;AI-3D 行需要 paid-generation-gate此技能新節拍或資產
G5 調色板鎖定一個調色板表格;來源中的每個十六進制值和其中的每個 3D 渲染palette_audit.py 退出碼 0(+ --png)重新著色 / 重新渲染;若無表格則 blocked此技能新資產、新渲染、顏色備註
G6 UI 來源每個 UI/效果節拍在 SOURCES.md 中有一行(來源、許可證、版本、日期)和一個尋址安全的移植;專案中無 npx shadcn add;無複製 21st 預覽/媒體SOURCES.md + 掃描交換來源或附理由手動構建此技能新元件
G7 尋址安全hf_preflight --strict 0 錯誤;seek_safe_scan.py 0 錯誤;非連續時間的快照一致報告 + 快照對修復;絕不透過抑制來「修復」而無理由此技能每次程式碼修補後
G8 聲音每個品牌事件有品牌音效;旁白下的音效在 -18..-26 dB 範圍內,且在圖片前 1-3 幀;音樂尾音淡出;最終檔案 -14 LUFS +-0.5,TP <= -1(house preset v1,Q5)hf_mix --report,hf_deliver 在最終檔案上驗證重新混合和重新封裝(無需重新渲染)render-qa-deliver 測量任何音訊或圖片重定時
G9 字幕除非簡報要求,否則無字幕元素對 id/class 進行 grep + <direction> 行移除 / 一行內詢問此技能簡報變更
G10 渲染 + QA本輪一次完整渲染;frame_qa 0 標記;評分標準平均 >= 4.0,無維度 < 3,M1/M3/M7 >= 3;分類帳每一行已核對QA 報告 + 評論者輸出返回失敗的閘道;在升級前最多一輪修正render-qa-deliver每次完整渲染

記錄閘道結果(hf/QA.md,每個閘道一行)

G1 pass   motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02"  (re-run after r2 retime: pass)
G5 blocked  3D render coin_r2.png not readable by palette_audit (not_run) - install Pillow or downscale
G7 fail   seek_safe_scan SS02 index.html:211 Math.random -> seeded hash; rescan pending

沒有行的閘道是 not_run。永遠不要根據先前輪次的記憶編寫 pass:重定時、新資產或修補會使其失效(請參閱「重新檢查」欄)。

呈現草稿(render-qa-deliver 擁有交付閘道)

訊息 = 立即提供檔案 + 編號的變更(根據使用者自己的備註編號)+ 每行都已核對的分類帳 + 來自單獨評論者的評分標準分數 + 差距(未驗證的內容:希伯來文校對、設備覆蓋、手機上的響度)+ Studio 連結。切勿呈現帶有標記的幀、失敗的閘道或未核對的分類帳行。

參考文件(載入時機)

  • references/seam-camera-event-tables.md - 在編寫或審查 PROMPT.md 時始終載入;也參考 agent-content/techniques/frame-spec-prompt.md 和 clean-smooth-motion.md。
  • references/launch-register-and-pace.md - 選擇註冊模式、節奏投訴、禁止清單、緩動數字。
  • references/three-d-decision.md - 任何涉及深度或 3D 的節拍;agent-content/techniques/2-5d.md 用於 2.5D。
  • references/ui-sources-and-port.md - UI 卡片、效果、截圖動畫;agent-content/techniques/screenshot-rebuild.md。
  • references/seek-safe-and-render-traps.md - 編寫程式碼、修補、渲染差異。
  • references/palette-lock.md、references/typography-hebrew-kinetic.md、references/sound-and-captions.md - DESIGN.md、希伯來文字型、聲音計劃。
  • references/dated-versions.md - 固定版本和許可證(已註明日期;過期 = 未知)。
  • 腳本(先執行 python <script> --self-check):motion_spec_check.py、palette_audit.py、seek_safe_scan.py。它們檢查文字和模式,而非外觀。

停止並升級

遇到阻塞(blocked),而非猜測:無批准行;無法渲染;閘道輸入缺失;價格或許可證未知;Three.js 節拍在 AMD 上的 1 秒段為空白(回退到 Blender 精靈)。在任何花費、安裝、發佈或向第三方發送訊息之前詢問。切勿向其他代理會話發送訊息。使用者在時間戳處的「無聊 / 看起來像 AI / 靜態」備註意味著從註冊模式的選單中替換節拍概念,並用一句話解釋。

維護

易變的事實僅存在於 references/dated-versions.md 和全局已註明日期的模組中(hyperframes-traps.md、three-d-routes.md、audio-mix.md)。將每個新的擁有者備註添加到「禁止」行,而非此檔案。僅執行指定的、確定性檢查;不執行模型評估(決策預設 Q4)。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

相關技能