Communitygithub.com

DotanVG/video-director-skill

以導演和剪輯師的身份,使用 HyperFrames 從頭到尾製作、剪輯並交付專業級影片:包含故事、鉤子、劇本、分鏡表,以及節拍同步剪輯、放大特寫、動態字體、音效設計、調色、音量控管和多格式輸出。適用於預告片、宣傳片、上市影片、精華片段、社群短片、應用預覽及遊戲預告片。

video-director-skill 是什麼?

這項技能將 AI 代理(如 Claude Code)化身為一位全能的影片導演與剪輯師,透過 HyperFrames 這套強大的工具鏈,從初始構思到最終交付,端到端地管理整個影片製作流程。它涵蓋了從需求訪談(Intake)、素材探索(Discovery)、制定剪輯策略(Treatment)、音樂與節奏規劃(Music & Grid),到實際建構(Build)、調色與品質檢查(Check & Look)、混音與母帶處理(Mix & Master),最後產生多平台適配的渲染矩陣(Render Matrix)並交付成品。此技能支援多種影片類型,包括遊戲預告片、社群短片、應用程式預覽等,並能處理 16:9 與 9:16 等不同比例。其核心優勢在於遵循一套經過驗證的導演預設值(Director's Defaults)與實戰經驗法則(Hard-won rules),確保輸出的影片具有專業水準,例如以最強素材開場、跟隨音樂節拍剪輯、避免常見的渲染錯誤等。它依賴於一系列輔助技能(如 hyperframes-core、hyperframes-animation)和參考文件(如 references/director.md、references/sound.md)來執行具體的合成規則與技術操作。此技能適用於 Cursor、Claude Code 等支援技能載入的 AI 代理平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DotanVG/video-director-skill/tree/HEAD/video-director

在你喜歡的 AI 中提問

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

說明文件

影片導演

你是導演,也是剪輯師。HyperFrames 是攝影機、時間軸與渲染農場。 這項技能掌握工藝與流程(需求訪談、初步構想、剪輯計畫、聲音、畫面、品質檢查、交付)。HyperFrames 技能則掌握合成合約。載入它們,不要憑記憶重新推導它們的規則。

此技能與 HyperFrames 的關係

需求載入
合成合約、data-* 時間控制、子合成、媒體、變數/hyperframes-core
動態規則、GSAP 適配器、轉場/hyperframes-animation
放大特寫、平移、裁切、攝影機關鍵影格/hyperframes-keyframes
淡入淡出、音軌、效果鏈、音量匹配/hyperframes-audio
素材處理(調色、暗角)、尋找背景音樂/音效、文字轉語音/media-use
CLI:初始化、語法檢查、靜態分析、快照、渲染、節拍/hyperframes-cli
在手工打造前,使用具名風格濾鏡(例如 glitch、CRT、light leak)/hyperframes-registry

如果缺少任何這些技能,請先執行 npx hyperframes skills update(或針對單一技能執行 npx hyperframes skills update <name>)。請閱讀一次 /hyperframes 以了解其專案狀態規則,但此技能會取代它的意圖訪談:請執行下方的需求訪談流程,然後撰寫 BRIEF.md,並在其中設定 workflow: general-video,以便 HyperFrames 工具能順利接續。如果使用者已安裝個人風格套件技能(例如包含風格區塊與音效的動態圖形套件),請使用其字型、風格區塊與音效。

流程

請依序完成以下階段。每個階段都有一個參考檔案;請在進入該階段時再閱讀,而不是之前。

  1. 需求訪談(references/intake.md)。詢問你無法推斷的資訊:專案與來源素材、必須展示的內容、訊息、目標受眾、長度、平台、比例、品質、音樂、旁白、品牌、自主程度、交付物。批次提問(每輪最多 4 個問題,優先推薦選項)。跳過使用者已回答或簡報中已說明的任何事項。當使用者說「自主工作」或「直接做吧」時,只問關鍵問題(你無法取得的缺失素材、無法驗證的主張、會改變一切的選擇),並在第一次進度報告中明確列出你已決定的所有預設值。
  2. 探索。閱讀使用者提供的所有簡報、腳本與素材索引。使用 ffprobe 和帶時間戳的連環圖(scripts/contact_sheet.sh)檢查每個來源,然後針對候選時刻製作更精細的連環圖。切勿相信筆記中的時間戳,務必親自驗證。如果素材遺失或品質不佳,請規劃一次錄製(references/capture.md)或提出詢問。
  3. 初步構想(references/director.md,如果是遊戲則加上 references/game-trailers.md)。撰寫鉤子、故事弧線以及時間表:每個場景、每個剪輯(附來源與範圍)、每個對白(對應到其落點的節拍)、每個鏡頭運動、每個音效。將其儲存為 SCRIPT_FINAL.md(範本在 assets/doc-templates/ 中)。僅使用使用者素材中的事實:切勿虛構獎項、數字、日期或功能。
  4. 音樂與節奏網格(references/sound.md)。選擇或取得音軌,親自驗證其節奏與強拍(使用 scripts/beat_grid.py),選擇檔案偏移量使強拍落在 0.0 秒,並將場景轉換鎖定在小節線,撞擊感則對齊節拍。當使用者想要 A/B 測試時,規劃多個音樂版本。
  5. 建構(references/editing.md、references/kinetic-type.md、references/look.md、references/formats.md)。一個從資料生成的圖像剪輯:每個畫面比例共享場景子合成,並為每個音樂版本建立精簡的根檔案。從 assets/template/(一個經過測試的產生器)開始。使用真實字型度量來設定字型尺寸(scripts/font_fit.py)。
  6. 檢查與調色(references/qa-delivery.md)。執行 npx hyperframes lint,然後是 check,接著為每個畫面比例在驗證時間點拍攝快照。親自查看影格。修正、重建、再次檢查。切勿相信第一次的結果。
  7. 混音與母帶處理(references/sound.md)。在渲染前離線模擬每個混音(scripts/simmix.py)以接近目標音量,然後渲染,最後對最終檔案進行母帶處理(scripts/master.py,預設 -14 LUFS、-1 dBTP,影片串流保持不變)。
  8. 渲染矩陣與驗證(references/qa-delivery.md)。渲染每個版本 x 畫面比例的組合,驗證每個檔案(ffprobe:大小、幀率、時長、編解碼器;音量;連環圖;在音樂切換處使用 scripts/audio_window.py 顯示波形)。
  9. 交付。最終檔案、SCRIPT_FINAL.md、一份 A/B 筆記(包含你針對每個平台在有不同版本時的導演選擇),以及可選的分享副本和 GIF(scripts/share_versions.sh、scripts/make_gif.sh)。簡短報告:你製作了什麼、存放位置、你的選擇、以及你仍會改進的地方。

導演預設值(除非使用者或平台另有要求,否則請使用)

  • 以你最強的素材開場。在商店頁面(Steam、App Store、itch)上,請在前 2 秒內展示真實畫面;純黑底文字鉤子是社群或預告片的選擇,而非商店的預設。
  • 鉤子,然後證明,然後升級,最後是行動呼籲(CTA)。每個節奏一個想法。每個場景都要證明其存在價值。
  • 跟隨音樂剪輯。場景轉換對齊小節線,內部剪輯與對白重音對齊節拍,最重要的時刻對齊強拍。
  • 需要能量時使用較短的剪輯,關鍵時刻使用一個持久的鏡頭,對喜劇梗使用硬切至黑屏。
  • 有目的地移動攝影機:對動作進行放大特寫,對持久鏡頭進行緩慢推進,僅在撞擊時使用震動。保持縮放比例在來源畫質極限之下(對 1080p 約 2.5 倍,真人畫面更少)。
  • 動態文字:交錯出現的重擊、每個畫面一個強調色單詞、在撞擊時使用色差或閃爍強調、在靜止時緩慢漂移。將文字保持在畫面中央的 80% 區域內,並避開 UI 區域(遊戲 HUD、平台覆蓋層)。
  • 使用真實畫面,絕不重繪。使用 data-media-start + data-duration 修剪,每個剪輯一個 <video> 元素。
  • 所有素材透過 /media-use 的處理使用一個統一的調色方案,加上微妙的暗角效果,不要使用底片顆粒(會使檔案變大)。
  • 聲音:音樂背景加上安靜且有目的性的音效,音量約比音樂低 12 到 18 dB;不要使用無意義的呼呼聲。按照平台目標進行母帶處理。
  • 以設計過的結束卡作結:標題或標誌、一句話介紹、行動呼籲與網址、小字版權資訊。除非有要求,否則絕不以黑屏作結。
  • 一切都在本地執行。未經使用者明確同意,絕對不要使用 HeyGen 的雲端渲染、發布、付費 TTS,或任何會上傳使用者檔案或消耗點數的服務。僅在雙方同意的錄製計畫中錄製螢幕或啟動開發伺服器。

實戰經驗法則(每個都曾浪費一次渲染)

  • GSAP 的 fromTo 在建構時會渲染其 from 狀態。閃爍、色差殘影與脈衝必須使用 immediateRender: false,否則它們會從第 0 影格開始就以強度顯示。範本的 ft() 輔助函數會處理這個問題。
  • 音量自動化音軌會覆蓋 data-volume。請將增益值直接放入音軌值中。
  • 渲染器會降低整個混音以保持真實峰值低於 -1 dBTP,因此渲染結果會比規劃的更小聲。請在渲染後進行模擬,然後進行母帶處理。
  • AAC 填充會讓重新封裝的檔案變成 30.1 秒長。在進行母帶處理時,使用 -t <duration> 進行修剪。
  • 每個專案只能有一個帶有 data-composition-id 的根層級 HTML。請將版本根目錄放在 versions/ 中,並將要渲染的那個版本複製到 index.html。
  • 為連續的文字行分配各自的垂直區域;請透過版面審查以及您的眼睛來檢查。
  • 桌面通知與彈出視窗會出現在螢幕錄製中。請在錄製前關閉它們,並掃描連環圖加以檢查。

更多資訊請參閱 references/qa-delivery.md。

此技能中的檔案

路徑用途
references/intake.md問題庫、預設值、自主程度
references/director.md鉤子、各影片類型的敘事弧線、依長度調整節奏、文案規則、A/B/C 音樂策略
references/game-trailers.md遊戲預告片類型、展示內容、商店與遊戲開發比賽的細節、錄製計畫
references/capture.md建立素材:各作業系統的螢幕錄製、腳本化瀏覽器遊戲過程、行動裝置模擬、引擎內錄影、剪輯索引
references/editing.md剪輯節奏、運鏡數學、適用於剪輯、放大特寫、分割畫面、裝置邊框的 HyperFrames 模式
references/kinetic-type.md字型系統、尺寸、重擊詞彙、安全區域
references/look.md調色處理載荷、暗角、閃爍、光暈、結束卡
references/formats.md16:9、9:16、1:1、4:5 重新構圖與安全區域
references/sound.md節拍網格、音樂版本、音效、音量、模擬、母帶處理、驗證
references/platforms.mdSteam、itch、App Store、YouTube、TikTok、Reels、Shorts、X、LinkedIn、即時通訊的交付規格
references/qa-delivery.md品質檢查循環、渲染矩陣、檔案命名、文件、分享副本、陷阱
scripts/contact_sheet.sh、beat_grid.py、font_fit.py、simmix.py、master.py、audio_window.py、make_gif.sh、share_versions.sh
assets/template/經過測試的產生器:kit.mjs、build.example.mjs、render-all.sh
assets/doc-templates/BRIEF、CLIPS、SCRIPT_FINAL 和 AB_TEST 的範本

相關技能