Communitygithub.com

ZLHad/open-video-harness

코드로 비디오를 제작합니다 (video-as-code / code2video). OpenVideoHarness 워크벤치를 통해 3Blue1Brown 스타일의 수학/과학 설명 영상, 지식 쇼츠 (세로/가로; 抖音, B站, 小红书, Shorts), 제품 론칭 영상 및 프로모션, 가사 비디오와 뮤직 비디오, 데이터 스토리, 논문 설명 영상, 손그림 또는 수채화 쇼츠, 밈 또는 빠른 편집 영상, 가로 풍경 설명 영상, 사용자 사진 및 클립으로 만든 회상 영상 (결혼식, 여행, 한 해; 照片回顾), 사용자 자체 영상 편집 등을 지원합니다.

open-video-harness란 무엇인가요?

OpenVideoHarness는 코드로 비디오를 제작하는 오픈소스 워크벤치입니다. '비디오-애즈-코드' 패러다임을 따르며, 3Blue1Brown 스타일의 수학/과학 설명 영상, 지식 쇼츠, 제품 홍보 영상, 가사 비디오, 데이터 스토리, 논문 설명, 손그림 쇼츠, 밈 편집, 가로 풍경 설명 영상, 사용자 사진/클립 회상 영상 등 11가지 비디오 유형을 지원합니다. AI 어시스턴트(Claude Code, Cursor, Codex 등)와 연동하여 작동하며, 사용자는 자연어로 요청을 입력하면 시스템이 자동으로 기획, 스토리보드, 코드 생성, 렌더링까지 처리합니다. 각 프레임은 t의 순수 함수로 표현되며, 오디오가 있을 경우 오디오가 타이밍을 결정합니다. 'standard' 및 'studio' 모드에서는 세 번의 인간 리뷰 게이트(컨셉/개요 → 스토리보드 → 초안)에서 사용자 피드백을 받고, 'quick' 모드는 자동으로 렌더링합니다. TTS(중국어/영어), 자막(중국어/영어/이중 언어), 음악, 효과음, 믹싱/먹싱 도구를 내장하고 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ZLHad/OpenVideoHarness/tree/HEAD/skills/open-video-harness

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

OpenVideoHarness

하네스 경로 (install.sh로 설정): ~/OpenVideoHarness

이 스킬은 얇은 포인터 역할을 합니다. 모든 워크플로, 규칙 및 도구는 OpenVideoHarness 저장소에 있습니다.

1. 하네스 찾기

다음 중 첫 번째로 존재하고 bin/vh를 포함하는 경로를 사용하세요:

  1. $OVH_DIR
  2. 위 "하네스 경로" 줄에 있는 경로
  3. ~/OpenVideoHarness
  4. 현재 작업 디렉토리

아무것도 없으면 사용자에게 권한을 요청하고 다음을 설치하세요:

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

2. 이 파일이 아닌 하네스를 따르세요

<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를 실행하세요.

관련 스킬