Communitygithub.com

johdav999/VideoAIAgent

在原生 Windows 上使用 VideoAIAgent 編導、創作、評分、渲染與評論 Cinetic 影片,適用於產品影片、標誌片頭、循環動畫、操作指南及動態圖形,並可透過儲存庫的 Remotion 或 HyperFrames 轉接器執行。

VideoAIAgent 是什麼?

VideoAIAgent 技能提供一個完整的本地化工作流程,用於在原生 Windows 環境中創作與管理 Cinetic 影片專案。它嚴格遵循 MIT 授權的 Cinetic v1.0.0 源碼,並從此儲存庫明確載入,而非全域安裝。使用者必須先閱讀 Windows 原生命令指南,才能執行任何工作流程指令。該技能支援多種影片類型,包括產品廣告、標誌片頭、循環動畫、操作指南以及動態圖形,並可透過 Remotion 或 HyperFrames 轉接器進行渲染。整個工作流程涵蓋從撰寫簡報、概念發想、品牌設定與動態設計,到最終渲染與嚴格品管的所有步驟,最終交付包含全面 QA 清單的最終成品。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/johdav999/VideoAIAgent/tree/HEAD/skills/cinetic-windows

在你喜歡的 AI 中提問

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

說明文件

Windows 上的 Cinetic

此儲存庫本地工作流程將 Cinetic v1.0.0(修訂版 91c43acf4ea183ea68861d4cd99ec054f6741876,MIT 授權)導入。它從此檔案明確載入,並非全域安裝。在執行命令前,請先閱讀原生命令指南。完整未修改的原始碼及其雜湊值位於 third_party/cinetic;其中的 shell 腳本僅供溯源,並非 Windows 上的可執行指令。

導演與所有權

圍繞一個產品特定概念導演一部短片。畫面、文案與聲音共用同一時間軸。通過技術檢查的渲染仍需要創意審查。遵循提供的品牌規範;若需自創品牌,則應沿用原始工作流程中的禁令與佔位符檢查。未替換佔位符設計前,不得移除佔位符標記。

  1. 撰寫 BRIEF.md:產品、受眾、承諾、格式、時長、投放位置、提供的品牌、假設與輸出清單。從充分的簡報中推斷合理的選擇;僅詢問必要的遺漏資訊。
  2. 閱讀已固定來源下的 references/concept-and-story.md。開發三個概念:產品的動詞、觀看者的痛點,以及一個形式手法。套用所有權與刪除測試。填寫生成的 TREATMENT.md:梗概、鉤子/轉折/證明/承諾/鎖定圖、鏡頭路徑、節拍表、完整文案與最終幀。
  3. 閱讀 brand-and-color.md 與 copy-and-type.md。建立品牌代碼、原始標誌與離線字型。渲染風格幀,檢查調色板對比度與文字可讀性。提供的品牌例外情況應記錄在簡報中。
  4. 閱讀 timing-grid.md、motion-tokens.md、camera.md、transitions.md 以及所選引擎指南。將每個提示、幕次、時長、文案停頓與聲音事件放入共用時間軸。對真實產品 UI 使用宣告式資料;操作指南請閱讀 product-ui.md。
  5. 使用 sound.md 創作構圖與配樂。使用原生 audio 指令重建提示與音軌。透過轉接器使用配樂、合成與母帶處理工具。切勿僅從來源時間軸推斷聲音同步。
  6. 閱讀 finishing.md 與 chromium-rendering.md。渲染預覽,檢查實際解碼輸出,執行網格、lint、探測、同步、佈局、取證以及嚴格的音軌式音訊審計。生成聯絡表,檢查全尺寸標記幀,並保留所有報告。宣告設計的剪輯/凍結及其原因,而非隱藏不合規的失敗。
  7. 閱讀 review-loop.md。使用來源 assets/critics/*.md 範本,透過導演、取證、聲音同步、美術文案 UI 與驗證者等鏡頭進行審查。除非使用者授權並行審查,否則應依序執行各鏡頭。使用幀/音訊證據驗證每個 P0/P1,按影響程度修復,記錄修復結果並重新渲染。啟動影片/操作指南至少需要兩輪審查;循環動畫/片頭至少一輪;五輪後停止並回報未解決問題。
  8. 對原始十一維度進行評分:想法與手法、鉤子(0–2 秒)、文案與字型、色彩與品牌、構圖、動態、轉場、節奏、產品真實性、聲音與同步、完成度。每項最低 3 分,平均至少 4.2 分,完成度與聲音同步需達 5 分,無未關閉的 P0 問題,所有技術關卡均通過。無聲循環可將聲音標記為 N/A,並記錄格式理由。分別記錄證據與人為核准。原生 review 指令會驗證證據記錄,但不會憑空產生審查判斷。
  9. 導演方向確定後渲染最終母版,執行最終取證/音訊檢查,檢查最快的模糊幀與幕邊界。使用 deliver 生成海報、循環動畫、GIF/WebM、Alpha 片頭及明確重新排版社交媒體變體。自創品牌時使用 brand-kit。formats.md 定義特定格式的輸出清單,包括操作指南的 SRT 字幕。交付檔案需附帶 QA 清單;任何未完全通過的關卡必須明確回報。

原生執行

從儲存庫使用 npm.cmd run cinetic -- COMMAND --project "data/films/NAME" ...。在生成的影片目錄內使用 node scripts/native.mjs COMMAND ... 或其 npm 腳本。使用可執行路徑與參數陣列進行編排。切勿執行上游 Bash 腳本、使用 Unix 符號連結、在生成的影片中安裝套件,或將簡報內容放入 shell 命令文字中。生成的工作區使用儲存庫確切的鎖定依賴關係。

來源參考資料描述了藝術演算法與臨界值。使用原生命令指南將其命令示例進行轉譯:render.sh → render、render-chunks.sh → render-chunks、hf-finish.sh → hf-finish、deliver.sh → deliver、brand-kit.sh → brand-kit、layout-audit.sh → layout-audit、grab.sh → grab,以及 Python 工具名稱 → 相同基本名稱的命令。所有路徑與輸出均保留在此儲存庫中。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能