Communitygithub.com

h296025733-sys/codex-auto-video-lab

사용자가 제공한 로컬 비디오, 이미지, 오디오 에셋과 자연어 편집 요구사항을 격리된 감사 가능한 편집 작업, 검증된 JSON 타임라인, 렌더링된 MP4, 그리고 로컬 기술 QA 보고서로 변환합니다. Codex에게 업로드된 미디어를 자동으로 편집, 트리밍, 리프레임, 캡션 추가, 시퀀싱, 스코어링, 패키징하도록 요청할 때 사용하세요. 지식 기반 구축, 소셜 플랫폼 게시, 또는 순수 참조 비디오 프롬프트 작성에는 사용하지 마십시오.

codex-auto-video-lab란 무엇인가요?

이 스킬은 Codex가 로컬 미디어 파일(비디오, 이미지, 오디오)을 사용자 요구사항에 따라 자동으로 편집할 수 있게 해주는 강력한 워크플로우입니다. 원본 파일은 보존하고, 격리된 작업 공간에서 분석, 편집 계획 수립, 렌더링, 기술 QA를 순차적으로 수행합니다. 특히 Reference 비디오 학습이 필요한 경우 `$tiktok-fine-cut-director`와 연동하여 정교한 편집 사양을 가져올 수 있으며, 캡션, 배경 음악, 전환 효과, 속도 변경 등 다양한 편집 기능을 지원합니다. Codex는 의미적 결정을 내리고, CLI 도구(FFmpeg 기반)는 결정론적인 미디어 분석, 검증, 렌더링, QA를 담당하여 안정적이고 감사 가능한 결과물을 제공합니다. 이 스킬은 현재 로컬 편집에 초점을 맞추며, 생성형 B-roll, 객체 추적, 멀티캠 싱크, 편집 가능한 프로젝트 내보내기, 플랫폼 게시 등은 지원하지 않습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/h296025733-sys/codex-auto-video-lab/tree/HEAD/.codex/skills/auto-video-editor

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

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

문서

자동 비디오 편집기

목표

원본을 보존하면서 실제 로컬 편집 결과물을 생성합니다. Codex는 의미적 결정을 수행하고, 워크스페이스 CLI는 결정론적 미디어 분석, 검증, FFmpeg 렌더링, 기술 QA를 수행합니다.

워크스페이스 루트: D:\workspace\codex-auto-video-lab.

워크플로우

요청사항에 reference 비디오 학습, 精剪, 계층/목록 오버레이 구축, 음성에 맞춘 제품 컷아웃 타임라인, 또는 계층화된 캡션 모션 등이 포함된 경우, 타임라인 작성 전에 $tiktok-fine-cut-director를 로드하십시오. 해당 정밀 편집 사양이 이 결정론적 렌더링 워크플로우의 의미적 입력이 됩니다.

  1. 사용자의 요구사항을 읽고 제공된 모든 로컬 에셋 경로를 확인합니다. 안전하고 간결한 작업 ID를 만듭니다. 원본 파일을 직접 편집하지 마십시오.

  2. 이 작업에서 첫 번째 편집인 경우 워크스페이스 닥터를 실행합니다:

    powershell -ExecutionPolicy Bypass -File .\scripts\doctor.ps1

  3. 격리된 작업을 생성합니다. 소스당 한 번씩 --asset을 전달하고 사용자의 정확한 요청사항을 포함합니다:

    .\studio.ps1 create --job <job-id> --asset <경로> --brief <요구사항>

  4. 작업을 분석합니다. 음성 의미, 캡션, 필러 제거, 또는 인용문 선택이 편집에 영향을 미치는 경우 --transcribe를 추가합니다:

    .\studio.ps1 analyze --job <job-id> --transcribe

  5. jobs\<job-id>\brief.txt, manifest.json, reports\analysis.json 및 관련 트랜스크립트 JSON을 읽습니다. 씬 후보와 무음 구간은 증거로 사용하되, 자동 편집적 진실로 취급하지 마십시오.

  6. 보수적인 초안을 생성합니다:

    .\studio.ps1 draft-plan --job <job-id>

  7. jobs\<job-id>\edit-plan.json을 요청사항에 맞게 편집합니다. 계획을 변경하기 전에 edit-plan.md를 읽으십시오. 선택, 순서, 속도감, 텍스트, 화면 비율, 오디오 결정을 설명하는 intent_summary를 유지하십시오. 사용할 수 없는 B-roll이나 사실에 근거하지 않은 주장을 절대 만들어내지 마십시오.

  8. 검증, 렌더링, QA를 실행합니다:

    .\studio.ps1 validate --job <job-id>

    .\studio.ps1 render --job <job-id>

    .\studio.ps1 qa --job <job-id>

  9. reports\qa.json의 sample_frames 및 critical_overlay_frames 아래 모든 경로를 로컬 이미지 뷰어로 검사합니다. 캡션, 크롭, 타이틀 안전 영역, 글꼴 글리프, 중요 오버레이, 또는 검은 프레임이 잘못된 경우 계획을 수정하고 다시 렌더링하십시오.

  10. MP4, 편집 계획, 분석, QA 경로를 전달합니다. 실제로 실행된 항목(소스 검사, 트랜스크립션, 로컬 렌더링, 전체 디코드, 샘플링된 프레임 시각 검사, 플랫폼 재생)을 별도로 명시하십시오. 기술 QA를 의미적 또는 게시 검증이라고 부르지 마십시오.

결정 규칙

  • 요청사항이 작은 세부 사항을 열어둔 경우 합리적인 편집 가정을 하고 intent_summary에 기록합니다.
  • 누락된 선택이 스토리, 제품 주장, 정체성, 또는 라이선스 에셋 사용을 실질적으로 변경하는 경우에만 사용자에게 질문합니다.
  • 액션, 음성, 증명, 일반 몽타주에는 하드 컷을 선호합니다. 논컷 전환은 실제 시간/장소/장 변경, 부드러운 연결, 또는 시각적으로 일치하는 방향 이동에만 사용하고, 텍스트 스케일은 지원되는 훅, 대비, 숫자, 증명, 페이오프, 또는 CTA에만 사용하십시오. 효과보다 속도감과 샷 선택을 우선시하십시오.
  • 대화가 명확하게 들리도록 유지합니다. 배경 음악은 기본적으로 덕킹이 활성화된 상태에서 -18 dB 근처로 설정합니다.
  • 세로 숏폼 출력의 경우 기본적으로 1080x1920, 30fps를 사용합니다. 중요한 콘텐츠가 프레임을 벗어날 때는 파괴적인 크롭 대신 contain을 사용합니다.
  • 사용자가 스타일 변경을 요청하지 않는 한, 이미 읽을 수 있는 캡션이 포함된 소스 푸티지 위에 새 캡션을 덧입히지 마십시오.
  • 씬 감지, 무음 감지, 음성 인식을 오류 가능성이 있는 증거로 취급합니다. 의미적 컷 전에 트랜스크립트 경계를 확인하십시오.

빠른 기준

의미적 삭제 없이 순서 연결, 리프레임, 선택적 제목, 캡션만 필요한 요청의 경우 baseline-auto가 전체 기계적 파이프라인을 실행할 수 있습니다. 이를 사용자 정의 편집 판단이 아닌 기준선 어셈블리로 표시하십시오:

.\studio.ps1 baseline-auto --job <job-id> [--transcribe] [--title <텍스트>] [--burn-captions]

현재 경계

지원됨: 로컬 비디오/이미지 수집, 프로빙, 씬 후보, 무음 구간, 선택적 오프라인 트랜스크립션, 세그먼트 트림, 0.25x-4x 속도, fill/contain 리프레임, 정확한 소스 음소거 또는 소스 게인, 제어된 push/pull 모션, 증거 기반 dissolve/dip/directional-slide 전환, 스타일링된 애니메이션 제목/캡션/레이블, 캡션/제목/레이블 내 하나의 정확한 의미적 컬러 실행(해당 단어의 실제 말하기 창 내에서 선택적 제한된 pulse 또는 shake 포함), 쌍을 이루는 번호 단계 레이블, 생성된 음성 해설, 나레이션 덕킹이 포함된 배경 음악, 시간이 맞춰진 음향 효과, 상업용 컬러 피니싱, H.264/AAC MP4, 전체 디코드 QA, 검은 프레임 스캔, 오디오 레벨 스캔 및 샘플링된 프레임.

이 FFmpeg 렌더러에서 직접 지원되지 않음: 에셋 지식 베이스, 생성형 B-roll, 계층화된 Remotion 모션 그래픽, 객체 추적, 멀티캠 동기화, 편집 가능한 Premiere/DaVinci 프로젝트 내보내기, 또는 플랫폼 게시. 계층화된 Remotion 작업은 $tiktok-fine-cut-director에서 지정한 대로 $openchatcut을 통해 라우팅하십시오.

Individual skills in this repo

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

관련 스킬