Communitygithub.com

影片審查與交付

這是一個將建置完成的影片轉化為可交付成品的循環流程:檢查影格、測量聲音、執行檢測、向委託人展示草稿與樣本、根據反饋行動、渲染主版本、驗證最終檔案、撰寫專案記錄,並回報結果。在每次建置或變更後、每次渲染前,以及每當收到反饋時使用。

影片審查與交付 是什麼?

這個技能定義了一套完整的「影片審查與交付」工作流程,專為使用 Hyperframes 等 CLI 工具的 AI 代理或開發者設計。它詳細說明了從建置後 linting 和快照檢查開始的迭代循環,然後進行低品質草稿渲染、響度測量,並向委託人展示選項以獲取設計決策(例如字體或色調)。該技能明確闡述了如何處理簡短且非正式的反饋:將模糊的評論(如「緩慢」或「看起來像 AI」)轉化為可操作的任務,應用於整個影片,記錄所有決定,並管理優先級衝突。最後,它涵蓋了交付級主渲染、使用 ffprobe 等工具進行的嚴格檔案驗證、維護四份關鍵專案文件(SCRIPT.md、SPEC.md、CREDITS.md、REVIEW.md),並撰寫一份結構化的交接訊息。此技能旨在透過優先進行廉價檢查、及早展示選項,以及系統化地處理反饋,來節省時間並減少昂貴的重新渲染,最終產出更可靠的成品。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

在你喜歡的 AI 中提問

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

說明文件

審查與交付

1. 每次變更後的循環

  1. npx hyperframes lint。零錯誤。
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,...,在你變更的時刻,加上前後各一個時刻。 打開聯絡表並確實閱讀:每張卡片是否完整?任何臉孔是否被遮蓋?任何文字是否超出其框線?是否有任何應該完成的部分只畫了一半?
  3. 修正並重複,直到影格正確為止。
  4. npx hyperframes check --json(或搭配 4K 素材使用 scripts/check.sh)。修正錯誤。閱讀警告一次,然後決定:修正它,或者保留它並在 REVIEW.md 中說明原因。值得處理的警告:超過三秒沒有任何變化、第一個影格為空白、文字超出容器。

快照成本低廉;渲染則不然。在渲染前,盡可能做好所有檢查。

2. 草稿

草稿是以低品質渲染的整部影片:npx hyperframes render --quality draft -o renders/draft-01.mp4,一部 100 秒的 1080p 影片約需一到三分鐘。接著:

  • 製作一份渲染檔案的圖片表(scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5)並閱讀它。它顯示了編碼後的影片,包含素材,這點快照可能會出錯。
  • 測量響度:ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -。
  • 每兩秒測量一次電平(scripts/levels.py draft.mp4 2)並與計劃比較:安靜的部分是否安靜?情緒高點是否在產品出現時到來?

將草稿交給委託人,並附上一段簡短說明,註明內容為何,以及你希望他們注意觀看和聆聽的重點。第一版草稿的存在就是為了被修正;盡早交給他們,而不是等它完善。

3. 展示選項

當問題是關於視覺效果(例如高光樣式、字型、佈局、顏色)時,展示靜止圖片,而非渲染影片。

  • 建置每個選項,對相同的三四個時刻拍攝快照,並將聯絡表並排保存,使用簡潔的名稱(A-underline.jpg、B-band.jpg)。
  • 用一行說明分別描述 A 和 B 是什麼,以及你會選擇哪一個及其原因。
  • 僅在這一點上等待答案;繼續處理所有不依賴此決定的事項。

當他們的話語可能意味著兩種意思時,這就是你找出答案的方式。這只花費一分鐘。一個錯誤的完整渲染則花費十分鐘以及他們的耐心。

4. 根據反饋行動

反饋通常簡短、非正式,有時甚至帶點惱怒。請這樣處理:

  • 在行動前,將其重新表述為一個行動,用一句話:「新加坡照片:與其他照片相同的小字印刷,在問題和結尾處都要。」
  • 在所有適用之處應用它。 如果一個元素錯了,它在影片中其他相同位置的同類元素也以同樣方式錯了。
  • 將品味視為既定事實。 「緩慢」、「無聊」、「看起來廉價」、「太粗」:改變它;不要為其辯護。如果你在事實問題上不同意(例如它會遮住一張臉、某個說法不真實),說一次,並附上理由。
  • 常見意見及其含義:
他們說這麼做
緩慢、想睡、無聊更短的鏡頭、更快的語速、刪減台詞、更有活力的音樂;不要增加特效
看起來不真實、像 AI使用真實人物拍攝的真實素材;減少虛構圖形
看起來像拼湊的庫存素材對所有內容進行統一調色;出現重複的人物;使用一致的卡片
我無法產生共鳴使用姓名、職務、具體需求;用他們自己的話描述問題
聲音很平、單一調性按情緒配樂;在高潮前保持安靜
讓它更吸引人改寫鉤子和總結句;加入一個呼應
這個和其他不一樣讓它與其同系列作品完全一致
對這些詞語投入更多關注每行一個重點標記,先以靜止圖片方式展示
  • 同時收到的多條訊息: 處理每一條;用一句話說明如何處理。後來的訊息覆蓋先前的。
  • 記錄決定 於 REVIEW.md 和記憶中:他們選擇了什麼、拒絕了什麼,用他們的原話記錄。

5. 主渲染

當草稿獲得批准,或剩餘的修改很小時:

  1. 檢查可用磁碟空間。一個 4K 渲染,每 100 秒大約需要 11 GB 的暫存空間。
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<名稱>-4k.mp4,在背景執行。如果他們想要速度或要求使用 GPU,則加入 --gpu;並說明其代價(約一半的位元率)。
  3. 如果他們詢問需要多久,讀取渲染進度並用數字回答。

版本命名要簡潔(-v2、-v3)。當一個版本被拒絕時,刪除它,以免有人誤開。

6. 驗證最終檔案

對你即將交付的檔案執行此操作,而非專案檔。

  • ffprobe:解析度、影格率、時長、大小。
  • 完整檔案的圖片表:每個片段都存在,沒有空白或凍結的部分,最後一個影格正確。
  • 文字和一張臉的全尺寸裁切:字體清晰,素材沒有出現方塊狀模糊。
  • 響度:整合 LUFS 約 -16,真實峰值等於或低於 -1 dBFS。
  • 從接近結尾的一個影格中解碼的 QR Code(scripts/scan.py):確切的連結,分別測試全尺寸和半尺寸。
  • 片尾卡上的地址在要求時能夠回應。

7. 專案記錄

在回報前更新這四個檔案。templates/ 目錄中有每個檔案的骨架。

  • SCRIPT.md:劇本表格(時間、畫面、旁白)、人物、每句台詞的來源、數字。
  • SPEC.md:目標、輸出、時間與聲音計畫、視覺效果、字型、動態效果、含有影格的鏡頭列表、品質保證列表。
  • CREDITS.md:每個素材來源及其授權。
  • REVIEW.md:所做的決定;已測量、已查看、未檢查的項目;未決的決定;最弱的鏡頭;特意保留的警告;如何變更影片(哪個檔案、哪個指令)。

8. 交接訊息

簡短,按此順序:

  1. 檔案:路徑、解析度、長度、大小。
  2. 自上一版本以來的變更,以簡短列表形式呈現。
  3. 你檢查了什麼以及如何檢查;你未檢查什麼(例如你從未聽過它)。
  4. 需要他們決定的事項,按重要性排序:尚未上線的產品、公司可能不希望顯示的任何畫面、需要確認的授權、需要聆聽的發音。

不要使用形容詞描述自己的工作。如果某些事情失敗或遺漏,那就是第一行要說的。

9. 整理維護

  • 保留影片使用的素材下載和清單;當空間不足或接到要求時,刪除你沒有使用的候選素材、舊草稿和快取。查看你即將刪除的內容;只刪除你所建立的內容。
  • 除非被要求,否則絕不提交或推送他們的儲存庫。
  • 將生成腳本和輔助腳本保存在專案中,而不是在重啟就會清除的暫存資料夾中。

Individual skills in this repo

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

相關技能