Communitygithub.com

aakashH242/video-director

使用 AI 生成的藝術圖像、可編輯的 SVG 前景、實際產品 UI 或程序化 3D 來導演和製作完成的影片。適用於解說影片、產品展示、上市宣傳片、短影音以及前後對比研究,需要可讀的視覺效果、定時註解、流暢的捕捉和本機 MP4 輸出。不適用於沒有影片交付成果的獨立圖像或普通網站動畫。

video-director 是什麼?

Video Director 是一個專門的 AI 代理技能,專注於從頭到尾製作結構清晰、易於理解的影片。它不只是一般的動畫工具,而是透過組合 AI 生成藝術、可編輯的 SVG 前景、實際的產品 UI 畫面或程序化 3D 內容,來產出具有特定目的的影片,例如產品展示、解說、上市宣傳片或前後對比研究。此技能支援在節點環境中使用,並包含一套自訂的指令碼助手(如 `capture.mjs`、`serve.mjs`、`audio.mjs` 等),用以處理從依賴檢查、本地影片捕捉、音訊合成到最終驗證與交付的完整工作流程。其核心原則是保持可控制元素的精確性(如文字、幾何圖形),準確展示實際操作過程,並根據目標輸出格式(如直式影片)進行獨立排版,而非簡單的裁切。最終交付物為可在本地播放的 MP4 檔案,且強調在捕捉前進行低幀率時間校準,以及對編碼後影片的全面品質檢查。

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

在你喜歡的 AI 中提問

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

說明文件

影片導演

讓主題易於理解,而不僅是動畫化。選擇最能忠實呈現重要動作的最簡單媒介。這是一個包含輔助工具的技能,不是一個獨立的應用程式或 Python 函式庫。

簡報與配方

根據請求確定主題、觀眾、時長、長寬比、關鍵動作和交付邊界。保留已核准的聲音、素材和當前的產品定位。做出可逆的次要選擇;詢問有關重大遺漏選擇、權利或費用的問題。創作不構成出版授權。

盡早展示有趣的結果。寫簡短具體的句子:「看看哪個頁面獲得點擊」,而不是「整合你的工作流程」。讓實際 UI 保持足夠長的時間以便閱讀。在解釋其各部分之前,先建立整個機制。

僅閱讀相關配方:

當要求時,選擇一個經過研究的新構圖/調色板。不要將一個頻道的風格強加於所有影片。互補色可以區分主體,但標籤和對比度也必須在沒有顏色提示的情況下有效運作。

製作決策

  1. 保持可控的事物可控制。 文字、箭頭、高亮、UI 畫面框架和事實性幾何圖形屬於 SVG/HTML/canvas 或 3D。生成的像素是有用的藝術,但不是精確的 UI 或機械真相。
  2. 展示動作。 真實的點擊需要可見的游標和引導;真實的操作需要其實際狀態/素材。不要將螢幕截圖動畫化,好像後端操作發生了一樣。當某個零件的高亮出現時,說出它的名稱;追蹤其移動的錨點。
  3. 分階段引導注意力。 一次一個教學動作。緩慢移動攝影機,穩定,然後保持。根據絕對時間(而非累積的幀增量)推導位置。次要動作必須支援主要解釋。對於恆速軸,線性旋轉是正確的。
  4. 為輸出進行構圖。 直式版本需要其自身可讀的畫面框架/標籤放置,而不是自動的橫式裁切。保持註解遠離零件、其他標籤和平台疊加層。
  5. 分離生成與組裝。 儲存已核准的藝術作品和原始語音。記錄提示詞、來源、權利、設定和雜湊值。逾時的生成可能仍已建立了一個計費任務;在重試前進行檢查。在花費之前,解決單獨計費的範圍/成本問題。
  6. 保留審查邊界。 使用新的輸出資料夾,保留主檔案/復原檔案,並拒絕意外覆寫。在未經單獨授權的情況下,停止上傳/發布。

輔助工具

這些輔助工具適應了 Pip 產品中使用的精確時間捕捉、安全本地提供、剪輯組裝和編碼輸出檢查。從此檔案的位置解析 <skill>。從影片專案資料夾執行,而不是技能資料夾。先閱讀 production.md。

輔助工具用途
scripts/create-example.mjs將自包含的首個專案複製到新資料夾;絕不覆寫。
scripts/doctor.mjs檢查依賴項並實際啟動 Chromium;不自動安裝。
scripts/capture.mjs本地頁面 → 精確幀的靜默 H.264;在同一時間點重試;來源雜湊值/錯誤收據。
scripts/serve.mjs僅回送地址的靜態伺服器,支援範圍請求和路徑限制。
scripts/compare.mjs帶標籤的並排比較;拒絕時長/fps 不匹配。
scripts/audio.mjs現有語音片段 + 明確停頓 → WAV 和測量時序清單。
scripts/verify.mjs探查/完整解碼/雜湊值、所有相鄰幀統計數據和編碼聯繫表。
scripts/self-test.mjs輔助工具的回歸測試和覆寫保護。
scripts/boundary-test.mjs本地瀏覽器-網路和損壞音訊的回歸測試。

需要 Node、FFmpeg/FFprobe 以及專案可存取的 Playwright/Chromium;僅 3D 需要 Three.js。輔助工具不安裝套件/模型、不呼叫提供者、不讀取憑證、也不發布。assets/first-video/ 僅包含程式碼,無需外部媒體。位於 assets/comparison-study/ 的比較入門範例包含程式碼和一個素材清單,不包含私人螢幕截圖、生成媒體、字型或第三方 Three.js。

交付

在最終捕捉之前,進行一次低幀率的時間校準。檢查編碼後的時長、尺寸、fps、完整解碼、顏色、可讀的關鍵幀和轉場邊界。度量標準支援檢查;大的幀差異可能是故意的剪輯,而小的差異可能隱藏了停滯的動畫。觀看影片並聆聽語音。ASR 和乾淨的 WAV 檔案並不能證明是自然的聲音。

交付可播放的本地 MP4 和來源路徑,附帶檢查和遺漏說明。不要宣稱離線捕捉達到即時 60 fps、從建構的基準中得到歷史性結果、或作者的獨立代理測試。

請參閱 lineage.md 以了解靈感來源和許可邊界。已安裝的專業技能可能補充此技能;工作流程不需要載入所有技能或複製上游儲存庫。

相關技能