Communitygithub.com

影片編輯與品質管控(Video Edit & QC)

編輯現有影片並在交付前驗證任何渲染結果——重新剪輯、修剪、調整為其他長寬比、燒錄或附加字幕、更換或混音音訊、循環播放及匯出;再加上QC閘門(探測、連絡表、節拍靜態幀、響度、循環接縫、可讀性、事實、PII)。可用於剪輯素材,或對任何動態影片進行最終檢查。

影片編輯與品質管控(Video Edit & QC) 是什麼?

這個技能(Andersonlimahw/lemon-ai-hub)提供了一套完整的影片編輯與品質管控工作流程,專為需要最終檢查輸出並快速執行常見編輯任務的開發者與創作者設計。它將多種基於FFmpeg的編輯操作(修剪、串接、重新構圖、燒錄字幕、音訊替換與混音)與一個結構化的QC(品質管控)閘門清單結合在一起。QC流程透過一個便攜式指令稿(`scripts/qc.sh`)執行多項檢查,包括規格驗證、響度正規化(-14 LUFS)、循環接縫分析,並生成聯絡表與靜態幀供視覺審查。該技能強調整潔的工作流程——永遠不覆寫原始檔案、將所有編輯操作導向新檔案、並在轉碼前在原始專案中解決問題。支援主要平台(Claude Code、Cursor等),並促使開發者報告每個閘門為通過/失敗/未檢查,附帶證據路徑,確保系統性的驗證,而非進行最終編碼修正。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Andersonlimahw/lemon-ai-hub/tree/HEAD/plugins/motion-movie-expert/skills/video-edit-qc

在你喜歡的 AI 中提問

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

說明文件

影片編輯與品質管控

永遠不要在原處編輯。將輸出寫入新檔案(*_v2.mp4、renders/),保留原始素材完整,並在覆寫或刪除任何內容之前進行確認。

編輯食譜(FFmpeg)

# 不重新編碼修剪(以關鍵幀為界)/ 重新編碼進行幀精確修剪
ffmpeg -ss 00:00:05 -to 00:00:20 -i in.mp4 -c copy out.mp4
ffmpeg -i in.mp4 -ss 5 -to 20 -c:v libx264 -crf 16 -c:a aac out.mp4

# 串接相同編解碼器的片段
printf "file '%s'\n" a.mp4 b.mp4 > list.txt && ffmpeg -f concat -safe 0 -i list.txt -c copy out.mp4

# 將16:9重新構圖為9:16,以主體位於CX(像素)為中心;優先考慮重新設計構圖
ffmpeg -i in.mp4 -vf "crop=ih*9/16:ih:CX-ih*9/32:0,scale=1080:1920" -c:a copy out_9x16.mp4

# 燒錄字幕(社群風格)/ 附加為軟字幕軌
ffmpeg -i in.mp4 -vf "subtitles=captions.srt:force_style='FontName=Inter,FontSize=14,Outline=1,MarginV=60'" out.mp4
ffmpeg -i in.mp4 -i captions.srt -c copy -c:s mov_text out.mp4

# 替換音訊 / 在語音下降低音樂音量 / 正規化至-14 LUFS
ffmpeg -i in.mp4 -i mix.wav -map 0:v -map 1:a -c:v copy -shortest out.mp4
ffmpeg -i music.wav -i vo.wav -filter_complex "[0][1]sidechaincompress=threshold=0.05:ratio=8:attack=150:release=300[m];[m][1]amix=inputs=2:normalize=0" mix.wav
ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1:LRA=11 -ar 48000 mix_norm.wav   # 最終交付需進行兩次通

# 網路/社群交付編碼(從母版進行;母版本身為CRF 16——參見 hyperframes-production)
ffmpeg -i in.mp4 -c:v libx264 -pix_fmt yuv420p -crf 18 -preset slow -movflags +faststart -c:a aac -b:a 192k out.mp4

對於人頭對話重新剪輯,應從轉錄稿(voice-video-sync時間戳)中的句子邊界開始剪裁,僅在剪輯不可見處移除填充詞,並在每個剪輯處保留80–150毫秒的環境音。對於設計好的動畫重新構圖,應在原始專案中按長寬比重新組合,而非可能的情況下進行裁切。

QC閘門

從專案目錄執行(QC=<plugin-root>/scripts/qc.sh):

$QC probe    final.mp4                  # 編解碼器、尺寸、幀率、時長、是否存在音訊
$QC sheet    final.mp4 qc/sheet.png 4 4 # 聯絡表,用於完整瀏覽
$QC stills   final.mp4 qc/ 0.5 3 7.5    # 每個故事板節拍一張靜態幀;超出結尾則失敗
$QC loudness final.mp4                  # -14 ±1 LUFS(廣播用途傳遞-23),真實峰值 ≤ -1 dBTP
$QC loop     final.mp4                  # 僅循環影片:接縫必須看起來像一個正常的幀步

然後根據故事板審查靜態幀與聯絡表:

閘門通過條件
規格解析度、幀率、時長與編解碼器需符合每一長寬比的簡報要求
故事關閉聲音仍可理解;前2秒傳遞價值或鉤子
連續性每個剪輯都有其載體;無關畫面間無交叉淡出;無乒乓接縫
節奏關鍵動作落在節拍上;無死幀;無動機不足的停滯 > 3秒
可讀性文字無裁剪或重疊;字幕 ≤ 2行,位於安全區域內;數字在動態模糊中清晰可讀
品牌取樣顏色符合色票;使用正確的字型與圖示集;無重新設計
事實螢幕上的每個數字或宣稱皆在故事板事實清單中
安全無PII、未經許可的第三方品牌、許可證與署名皆存在
音訊響度與真實峰值在範圍內;音效在音樂之下;語音在音樂之上清晰可辨
無障礙每秒閃爍 ≤ 3次;字幕與口語內容相符
循環若要求,接縫須通過 qc.sh loop 檢查
確定性同一時間戳渲染兩次應相同(抽樣檢查3幀)

將每個閘門報告為通過 / 失敗 / 未檢查,並附上證據路徑(靜態幀、聯絡表、指令輸出)。在原始檔案中修正失敗問題並重新渲染;不要在最終編碼中掩蓋問題。對於長影片,按章節拆分QC,並並行使用 motion-qc 代理人處理每個章節。

Individual skills in this repo

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

Andersonlimahw/lemon-ai-hub

When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongoing marketing after launch, see marketing-ideas. For the offer being launched (bonuses, guarantees, scarcity, naming), see offers.

Andersonlimahw/lemon-ai-hub

Create and edit motion videos end to end — product motion films, motion graphics, narrated explainers, captioned clips, UI animation recreations, and recuts. Orchestrates brief, storyboard, choreography, build (HyperFrames or any deterministic renderer), voice/caption sync, and render QC. Use when the user asks to make, animate, storyboard, narrate, caption, edit, or render a video or motion piece; skip for static images and web UI work with no video deliverable.

Andersonlimahw/lemon-ai-hub

Build and render a deterministic video composition — HyperFrames (HTML + GSAP) by default, or a custom seek(t) + Playwright + FFmpeg pipeline. Covers project setup, composition contract, timeline rules, creative direction for frames, lint/check/snapshot, preview, and local render. Use when implementing an approved storyboard as code.

Andersonlimahw/lemon-ai-hub

Motion law for multi-scene videos — seam continuity (axis, direction, speed, phase), carriers, causal motion, springs and timing, camera, transitions, stillness, and loop design. Use when planning or fixing how scenes connect and move, before and during any animation build.

Andersonlimahw/lemon-ai-hub

Short design-led motion graphics where motion is the message — kinetic typography, stat count-up, chart/data-viz reveal, logo sting, lower third or callout, animated map, tweet/news/headline card, webpage or UI walkthrough, and image-plus-data fusion. Usually under 10 s, up to about 30 s, no narration; renders to MP4 or a transparent overlay. Use when the user wants a short motion graphic, animated stat/chart/logo/map/card, or overlay; when the upstream HyperFrames `motion-graphics` skill is installed, use it for exact CLI flags and registry blocks.

Andersonlimahw/lemon-ai-hub

Turn a video idea, product, or script into an approved master prompt and pre-implementation storyboard — intake, concept, 8–12 state sequence, beat grid, transition map, camera plan, audio cue plan, and render architecture. Use before building any new video, or when a video brief is vague.

Andersonlimahw/lemon-ai-hub

Motion tokens, spring presets, and React/Next.js (motion/react) interaction patterns for product UI that appears in a video — rebuilding real product screens faithfully, animating them as seekable scenes, and keeping the live product's motion consistent with the film. Use when a motion video shows or recreates product UI; for web UI work with no video deliverable use design-expert instead.

Andersonlimahw/lemon-ai-hub

Synchronize narration, captions, music, and SFX with picture — narration writing, script lock, TTS or recorded voiceover, word-level timestamps, caption blocks, shot windows derived from the voice track, dwell budgets, ducking, and loudness targets. Use for narrated explainers, voiceover changes, subtitles, or any video where timing must follow audio.

Andersonlimahw/lemon-ai-hub

Agent skill at plugins/video/SKILL.md

相關技能