Communitygithub.com

編輯交付品質檢查

在交付前驗證最終影片編輯。當代理需要檢查渲染的 MP4/MOV/WebM、確認時長/解析度/影格率/音訊、生成或審查連環圖、分析時間軸 CSV、檢查剪輯密度/來源混合、檢查特效整合與連貫性、驗證文字與節拍同步、捕捉弱影格或意外佔位符,並決定節拍同步的社群編輯是否準備好展示時使用。

編輯交付品質檢查 是什麼?

此技能用於對最終影片渲染進行全面的品質檢查,確保其在技術和創意上符合交付標準。它會自動檢查技術規格,例如時長、解析度、影格率和音訊存在性,並生成連環圖以進行視覺審查。技能還會分析時間軸 CSV,以評估片段數量、平均長度和來源多樣性,並針對特定類型的編輯(如節拍同步的蒙太奇或帶有特效的影片)提供專門的檢查。輸出是一份結構化的 QA 報告,標示出準備就緒、需要小修改或需要重新渲染的狀態。此技能專為在 Claude Code、Cursor 或 Codex 等 AI 代理環境中使用而設計,透過自動化檢測常見故障模式(如缺少音訊、裁剪錯誤或弱影格)來補充人工審查。它支援處理 MP4、MOV 和 WebM 檔案,並透過命令列腳本 `scripts/qa_video_edit.py` 來執行檢查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/edit-delivery-qa

在你喜歡的 AI 中提問

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

說明文件

編輯交付品質檢查 是做什麼的?

概述

在將影片編輯呈現為完成品之前使用此技能。預期輸出為一份簡潔的 QA 報告:技術規格、時間軸健康狀況、視覺審查筆記,以及交付前需要修復的任何問題。

必要檢查

  1. 探測最終渲染檔案:
    • 時長
    • 解析度
    • 影格率
    • 視訊編解碼器
    • 音訊串流存在與否
    • 交付容器格式
  2. 如果尚不存在,則生成連環圖。
  3. 審查連環圖是否包含:
    • 有活動內容且具意圖的影格
    • 除非刻意安排,否則不應有標題卡、訪談或空白影格
    • 無浮水印或素材預覽疊加層
    • 裁剪後主體/動作仍清晰可辨
    • 強調效果看起來是刻意的,而非隨機的填充素材
  4. 如果時間軸 CSV 可用則檢查:
    • 片段數量
    • 平均/最小/最大片段時長
    • 來源混合情況
    • 類型/類別混合情況
    • 優先級重點素材使用情況
  5. 將結果與目標格式及創意簡報進行比較。
  6. 說明該編輯是準備就緒、需要小幅修改,還是需要重新渲染。

節拍同步蒙太奇目標

針對密集的社群平台蒙太奇剪輯:

  • 時長:通常為 30-40 秒。
  • 直向:1080x1920;橫向:1920x1080。
  • 影格率:最低 30fps。
  • 對於一個 35 秒 的高能量蒙太奇,如果素材能支持,70-90 個片段是健康的。
  • 平均片段長度:約 0.35-0.50 秒。
  • 音訊應存在且乾淨。
  • 連環圖應主要顯示活躍/有目的的鏡頭。

整合特效與工藝檢查(2026年7月新增)

對於包含特效或文字圖層的編輯,將這些項目加入必要檢查:

  • 連貫性 / 貼紙檢查: 任何合成元素是否看起來像未追蹤的貼紙,而非場景中的物體?任何片段是否看起來像是切到另一個不同的影片?某個鏡頭是否破壞了統一的調色(在自然色調中出現一個異類外觀)?任何一個「是」= 需要修改 — 這些是最常見的退件原因。
  • 文字同步檢查: 如果一句鉤子台詞要落在某個節拍上,測量文字出現影格與音頻重音之間的實際偏移量;|偏移量| > 100 毫秒 = 需要重新渲染。
  • 循環檢查: 將結尾重播到開頭;循環接縫的編輯必須是不可見的。
  • 手機比例檢查: 以完整尺寸和手機比例檢查;在規定的時間戳(例如一個 15 秒的作品的 1/4/8/12/14 秒處)保存審查影格,並與 QA 報告一同提供一個後期影格的抽查。
  • 低成本驗證階段(在全片構建前,而非之後): 渲染一個低解析度的前 3-5 秒骨架,並在捲動速度下觀看,然後再承諾進行完整/VFX 渲染 — 在此關卡淘汰成本很低,但在 VFX 之後則成本高昂。
  • QuickTime 交付物: 當在 Apple 播放器中進行審查時,也需生成並單獨 QA 一個 QuickTime 相容的 .mov 檔案。
  • 對於任何對外公開發布的內容,執行五個獨立關卡:技術、視覺、敘事、原創性/權利、平台包裝。自動化 QA 可以輔助,但永遠不能取代以正常速度觀看渲染成品。有顆粒感是可以接受的(觀眾更喜歡它);但塊狀模糊、條帶、放大模糊、浮水印和邊框才是真正的扣分項目。

失敗模式

當看到以下情況時,將編輯退回修改:

  • 沒有音訊串流或使用了錯誤的音訊片段
  • 錯誤的長寬比或非預期的裁剪
  • 空白影格、標題卡、訪談、素材浮水印或價格疊加層
  • 動作被垂直裁剪遮擋
  • 過多的弱勢群眾/雷射/自然環境插入鏡頭取代了主要前提
  • 優先級音樂重點由低動態鏡頭呈現
  • 時間軸 CSV 與最終渲染存在實質性差異

腳本

針對最終影片執行 scripts/qa_video_edit.py。當資料可用時,加上 --timeline 和 --contact-sheet 參數:

python3 scripts/qa_video_edit.py final.mp4 --timeline final_timeline.csv --contact-sheet final_contact_sheet.jpg --out final_qa

此腳本會輸出 JSON 和 Markdown 格式的報告。當設定 --make-contact-sheet 參數時,它也可以使用 FFmpeg 建立連環圖。

人工審查

腳本能捕捉規格和時間軸的問題,但不能取代觀看或檢查影格。始終將自動化 QA 與至少一次連環圖審查搭配使用,並且在編輯風險高或視覺上密集時,務必觀看最終渲染成品。

關於 Conteto Machino 標準,請參閱 references/edit-qa-standard.md。

可選參考資料:

  • references/qa-thresholds.md:可根據編輯類型調整的閾值。
  • references/example-prompts.md:可重複使用的最終 QA 提示。
  • references/gui-vision.md:視覺 QA 和交付面板的產品願景。

Individual skills in this repo

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

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

viral-video-edits

End-to-end system for making S-tier beat-synced short-form music video edits — song analysis, viral window selection, footage sourcing with shot-level QA, hook writing, onset-locked cutting, integrated audio-reactive FX (person mattes, procedural GLSL renderers, cinematic grade), and delivery QA. Use this whenever the user asks to make a video edit, music video, reel, TikTok/Shorts/vertical video, beat-synced montage, lyric/hook video, audio-reactive visual, tunnel/portal/kaleidoscope render, or to promote a song with video content — even if they don

相關技能