Communitygithub.com

ZLHad/open-video-harness

用程式碼製作影片(影片即程式碼 / code2video)的 OpenVideoHarness 工作台。涵蓋 3Blue1Brown 風格的數學與科學解說、知識短影音(直式或橫式;抖音、B站、小紅書、Shorts)、產品發表片與宣傳片、歌詞影片與音樂影片、數據故事、論文解說、手繪或水彩短影音、迷因或快剪影片、橫式長篇解說、從使用者自己的照片與片段(婚禮、旅行、年度回顧;照片回顧)製作回顧影片,以及剪輯使用者自己的⋯⋯

open-video-harness 是什麼?

OpenVideoHarness 是一個影片即程式碼(video-as-code / code2video)的工作台,專門為 AI 代理(如 Claude Code、Cursor、Codex 等)與開發者設計,讓您用程式碼生成各類影片。它支援從 3Blue1Brown 風格的數學解說到短影音、產品宣傳片、音樂影片等多種影片類型,並在 SKILL.md 中明確定義了 11 種影片類型,其中兩種類型(編輯使用者自己的素材與照片回顧)仍為實驗性功能。工作台會引導代理根據「努力程度」(標準 / 快速 / 工作室)與「導演模式」設定停靠點,在概念與大綱、分鏡、初稿三個階段要求人類審查,重要決策(如鉤子、主角、主題音樂)可額外停靠。所有畫面皆為時間 `t` 的純函數,有聲音時音訊決定時間軸,嚴格遵循先分鏡後程式碼、每個場景自我審查、事實紀律等硬性規則。音訊工具包括 TTS(支援中英文,預設本機 Qwen3-TTS)、字幕生成、音樂作曲、音效、混音與封裝。運行 `bin/vh doctor` 可檢查缺漏。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ZLHad/OpenVideoHarness/tree/HEAD/skills/open-video-harness

在你喜歡的 AI 中提問

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

說明文件

OpenVideoHarness

Harness 路徑(由 install.sh 設定):~/OpenVideoHarness

此技能為一個輕量指標。所有工作流程、規則與工具都位於 OpenVideoHarness 儲存庫中。

1. 找到 Harness

使用第一個存在且包含 bin/vh 的路徑:

  1. $OVH_DIR
  2. 上述「Harness 路徑」行中的路徑
  3. ~/OpenVideoHarness
  4. 當前工作目錄

如果都不存在,請詢問使用者許可,然後安裝:

curl -fsSL https://raw.githubusercontent.com/ZLHad/OpenVideoHarness/main/install.sh | bash

2. 遵循 Harness,而非此檔案

閱讀 <harness>/CLAUDE.md(Codex:<harness>/AGENTS.md,兩者相同)並完全遵循:

  • 將請求路由到 11 個 video-types/ 文件之一(類型 09(編輯使用者自己的素材)與 11(使用者自己的照片回顧)為實驗性);
  • 使用 <harness>/bin/vh new <type> <slug> 建立專案;
  • 在需要努力程度與導演模式(CLAUDE.md 中的「努力程度」與「導演模式」)指示的地方停下來等待使用者:standard 與 studio 模式會在三個人類審查關卡(概念與大綱 → 分鏡 → 初稿)停止;quick 模式則直接渲染。使用者表示想自行決定的任何事項(鉤子、主角、主題音樂、標題與封面等)會在後續需要用到之前額外增加一個停靠點,或者如果可等待則依附在下一個關卡。每個停靠點預設為 bin/vh review 產生的本地審查頁面,最多三個決策;僅將它印出的行發送給使用者,然後等待;
  • 遵循硬性規則:每個畫面都是時間 t 的純函數;有聲音時,音訊決定時間軸;先分鏡後程式碼;每個場景自我審查;事實紀律;
  • 將工作保持在 <harness>/projects/ 內;當使用者指定其他目錄時,使用 <harness>/bin/vh new <type> <slug> --dir <that directory> 在該處建立專案(或設定 OVH_PROJECTS)。

音訊工具:

  • bin/vh tts — 語音旁白,中文或英文,預設使用本機 Qwen3-TTS;
  • bin/vh captions — 中/英/雙語字幕;
  • bin/vh music — 程式碼作曲的背景音樂;
  • bin/vh sfx — 音效;
  • bin/vh mix 與 bin/vh mux — 混音與封裝。

如果發現任何缺失,請執行 bin/vh doctor。

相關技能