vibecut-auto-edit

vibecut-auto-edit 스킬

영상 → Whisper 전사 → 정적 표시 transcript → Claude NG 판단 → 사용자 검토 → CapCut 적용 → 자막 파이프라인.

핵심 원리

Whisper가 전사한 단어 타임스탬프와 실제 오디오의 정적 구간을 함께 펼친 transcript를 Claude가 직접 읽고 NG 구간을 판단합니다.

• 키워드/유사도 방식은 문장 내부 반복, 3~4회에 걸친 점진적 반복, 불완전 발화를 못 잡음
• Whisper 대본만 읽으면 말이 멈춘 정적을 못 봄 — Whisper가 멈춘 시간을 앞 단어 길이에 흡수시키기 때문. 그래서 make_transcript.py가 ffmpeg로 정적을 재서 ⏸ 표시를 끼워 넣음

처리 흐름

영상 (.mov/.mp4)                     ※ 모든 중간 파일은 영상 옆에 {stem}_*.json 으로 저장
   │                                   (영상이 여러 개여도 섞이지 않고, 캐시 재사용도 안전)
   ├─ [0] 프로젝트·타임라인 찾기 (find_project.py) — 사용자에게 묻지 않고 자동 탐색
   ├─ [1] transcribe.py            → {stem}_words.json
   ├─ [2] make_transcript.py       → {stem}_transcript.txt (⏸ 정적 / 🔊 인식 안 된 소리 표시)
   │      Claude가 읽고 NG 판단   → {stem}_ng_log.json
   ├─ [2-D] 사용자 사전 검토        번호 리스트 → 승인/제외 반영
   ├─ [3] make_segments.py         → {stem}_segments.json
   ├─ [3-B] 프로젝트 상태 점검
   ├─ [4] capcut_editor.py --timeline <이름>   4개 파일 갱신 + 자동 백업
   ├─ [5] 자막 자동 연결            subtitles_from_cuts.py → 분할 → apply_subtitles.py
   └─ [6] vibecut app으로 열기

전제 조건 (모든 Bash 블록 앞에 한 번)

which uv || curl -LsSf https://astral.sh/uv/install.sh | sh

VIBECUT_CONFIG="${HOME}/.vibecut/config.json"
SCRIPTS=""
if [ -f "${VIBECUT_CONFIG}" ]; then
  SCRIPTS=$(python3 -c "import json; print(json.load(open('${VIBECUT_CONFIG}')).get('scripts_dir',''))" 2>/dev/null)
fi
if [ -z "${SCRIPTS}" ]; then
  SCRIPTS=$(find "${HOME}/.claude/plugins/cache/vibecut" -name "capcut_editor.py" -maxdepth 8 2>/dev/null | head -1 | xargs dirname 2>/dev/null)
fi
if [ -z "${SCRIPTS}" ]; then
  APP_DIR="${HOME}/.vibecut/app"
  if [ -d "${APP_DIR}/.git" ]; then
    git -C "${APP_DIR}" pull --ff-only >/dev/null 2>&1
  else
    git clone --depth 1 https://github.com/AX-Surfers/Vibecut.git "${APP_DIR}" >/dev/null 2>&1
  fi
  [ -f "${APP_DIR}/scripts/capcut_editor.py" ] && SCRIPTS="${APP_DIR}/scripts"
fi
[ -z "${SCRIPTS}" ] && echo "❌ vibecut-setup 먼저 실행" && exit 1

uv run "${SCRIPTS}/_platform.py" quit-capcut