edit-motion-graphics 是做什麼的?
一個完成動態影片(MP4)的成果負責人,該影片建構為 HyperFrames HTML 加上一個暫停的 GSAP 時間軸。框架級別的 PROMPT.md 是產品;程式碼僅用於渲染它。
不可協商的規則(請先閱讀)
- 在批准的框架級別 PROMPT.md 之前無程式碼 - 即使在自主執行中:代理起草,人類批准(決策預設 Q6)。批准是檔案中的一行記錄
APPROVAL: <who> <date>。變更順序始終是:分類帳 -> PROMPT.md -> 程式碼。 - 此處無花費。 AI-3D、AI 靜態圖片或任何付費生成都需通過
paid-generation-gate;此技能不進行任何付費呼叫。目錄清單不等於帳戶存取權限。 - 審查順序: Studio 預覽 ->
hf_segment範圍 -> 每輪意見一次完整渲染 -> 最終渲染的逐幀 QA。一次只處理一個繁重任務 (render_lock)。批次處理意見;在使用者仍在編寫時進行診斷,但不要渲染。 - 常見陷阱: 不要在 HyperFrames 根元素上使用
dir="rtl"(僅在文字元素上使用 RTL,在<html>上使用lang="he");從檔案載入字體(hf/fonts/中的@font-face);hyperframes snapshot --describe false,每次呼叫不超過 5 個時間戳;使用 ASCII 工作根目錄 (new_project)。 - 故障關閉: 無法執行的閘道狀態為
blocked(not_run),絕非pass。超時、空樣本或遺失的渲染永遠不會通過。成功的工具呼叫是執行證據;已檢視的渲染是外觀證據;靜態圖片無法證明動態。 - 規則 vs. 品味: 規則 1-5 是規則。以下標記為 studio style 的項目(預設無字幕、禁止清單、「禁止粉紅色」、Higgsfield 語法、21st-first)是擁有者的品味,並附有理由說明;與之衝突的簡報在品味上優先,但絕不繞過閘道。
- 數字攜帶其幀率(除非簡報另有說明,否則為 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(無參考 -> 詢問哪個時間範圍是「風格」)。
步驟
- 註冊 + 攝入。 選擇一個註冊模式(
launch | kinetic | logo | explainer | calm)並鎖定長度、比例、旁白、音樂、交付檔案名稱(references/launch-register-and-pace.md)。一個 30 秒的密集發布感覺快了 1.7 倍;批准的長度是 45 秒:先決定長度。 - 草擬 PROMPT.md + DESIGN.md(6 個區塊;攝影機、接縫和事件表;任何 3D 的節拍卡)。執行
python scripts/motion_spec_check.py hf/PROMPT.md --register <r>;修復;請求批准。 - 來源節拍(
references/ui-sources-and-port.md):目錄 -> hf-blocks -> shadcn 註冊表(預設)-> 僅在有帳戶時使用 21st.dev -> 手動構建;為每個節拍決定 3D(references/three-d-decision.md)。 - 構建一個
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>]。 - 視覺上批准: 四張靜態圖片 + 每個接縫的快照 +
sheet聯絡表;Studio 預覽;意見批次。 - 聲音(
references/sound-and-captions.md):hf_mix --report;在每個品牌事件上使用品牌音效;混合並測量最終檔案。 - 一次完整渲染,在鎖定下,並附上預計完成時間;
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_segmentAMD 閘道; - 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 個問題);blocked | video-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)。