Communitygithub.com

SouVi 엔진

SouVi 엔진(`souvi` CLI)을 사용하여 비디오와 오디오를 생성하고 편집합니다 — 편집, 릴스, 트레일러, 슬라이드쇼, 그레이딩, 타이틀, 음성 해설, 음악, 믹싱, 마스터링, 사운드 디자인, 포맷 내보내기. 사용자가 SouVi 또는 비디오/오디오 출력을 요청할 때 사용하세요.

SouVi 엔진란 무엇인가요?

SouVi 엔진은 `souvi`라는 단일 CLI 도구를 통해 비디오 및 오디오 제작의 전체 워크플로우(편집, 그레이딩, 타이틀, 음성 해설, 음악, 믹싱, 마스터링, 사운드 디자인, 포맷 내보내기)를 관리하는 AI 에이전트 스킬입니다. `/home/cptdawn/Kode/SouVi-Engine`에 위치하며, 프로젝트 단위로 작업 공간을 구성하고, 타임라인 JSON을 수정하거나 `souvi render` 명령어를 실행하여 결과물을 생성합니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 터미널 기반 AI 에이전트와 호환되며, 병렬 에이전트 작업을 안전하게 처리합니다. 각 에이전트는 고유한 슬러그로 구분된 프로젝트에서 작업하며, 에셋은 불변적으로 관리되고 출력물은 버전 관리됩니다. 사용자는 비디오/오디오를 직접 재생할 수 없으므로, `souvi look`(연락 시트), `souvi frame`(프레임 이미지), `souvi hear`(스펙트로그램) 같은 리뷰 도구를 사용하여 결과를 확인하고 QC를 통과해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CPT-Dawn/SouVi-Engine/tree/HEAD/skill

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

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

문서

SouVi 엔진은(는) 무엇을 하나요?

souvi는 PATH에 있으며 모든 디렉토리에서 작동합니다. 엔진은 /home/cptdawn/Kode/SouVi-Engine에 위치합니다 (이하 $SOUVI). souvi <명령어> -h는 플래그를 보여주고, souvi presets는 전달 포맷, 룩, 타이틀 스타일, 전환 및 SFX 목록을 출력합니다.

작업 공간

각 전달물 세트는 $SOUVI 내의 프로젝트로 구성됩니다:

  • projects/<slug>/ — timeline.json (편집 데이터) 및 BRIEF.md (브리프 + 날짜별 결정 로그)
  • assets/<slug>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/ — 소스 파일, 절대 수정하지 않음
  • output/<slug>/{drafts,renders,final,review}/ — 결과물, 버전 관리 _vNNN, 절대 덮어쓰지 않음

다른 저장소에서 호출된 경우: slug는 해당 저장소의 폴더 이름입니다 (별도의 전달물을 위해 접미사를 붙입니다, 예: myapp-teaser). 미디어 가져오기는 souvi import <slug> <파일…> (--as voice|sfx로 비음악 오디오의 경우, --link로 대형 푸티지의 경우)를 사용하고, 전달은 souvi promote <렌더> --to <호출 저장소의 폴더>를 사용합니다. 사용자가 요청하지 않는 한 $SOUVI의 git은 건드리지 마십시오.

병렬 에이전트는 안전합니다: 모든 작업은 개인 폴더에서 실행되며 한 프로젝트의 렌더는 잠금으로 대기열에 들어갑니다. 각 에이전트의 전달물에는 고유한 slug를 부여하십시오.

루프

  1. souvi new <slug> --preset <전달>; 브리프를 BRIEF.md에 작성합니다.
  2. souvi import …, souvi assets <slug>, 그런 다음 모든 후보 소스에 대해 souvi look <클립>을 실행합니다.
  3. $SOUVI/docs/timeline.md를 읽은 후 timeline.json을 작성합니다; souvi plan <slug>을 오류 없이 통과할 때까지 실행합니다.
  4. souvi render <slug> --draft (--gpu, --until N), 검토, 수정.
  5. souvi render <slug> (QC가 반드시 PASS해야 함), 검토, souvi promote <렌더> [--to …].

검토 — 당신은 시청하거나 청취할 수 없으므로, 다음 명령어가 출력하는 PNG를 읽으십시오: souvi look <비디오> (연락 시트, 컷 주변의 밀집 시트를 위해 --from/--to 사용), souvi frame <비디오> --at <t…>, souvi hear <파일> (스펙트로그램, 파형, 음량). 최종 렌더가 이 검토와 QC를 통과하면 작업이 완료됩니다.

제작

창의적 결정을 내리기 전에, 화면 관련 video.md와 사운드 관련 audio.md를 읽으십시오. 해당 문서의 검토 체크리스트 항목을 모두 적용하십시오.

단일 파일 도구

export --preset, master, voice, sfx, reverb, stabilize, denoise, grade, retime, qc, loudness, probe. 처리된 파일은 소스 옆에 <이름>.<태그>_vNNN.<확장자> 형식으로 저장됩니다. 다른 모든 작업에는 raw ffmpeg를 사용해도 괜찮지만, 10비트 처리, lanczos 스케일링, BT.709 태그 및 soxr 리샘플링을 유지해야 하며, 음량은 souvi master로 마무리하고 전달물은 souvi export로 인코딩하십시오.

관련 스킬