Claude AutoCut은(는) 무엇을 하나요?
단어 수준의 전사(transcript)를 기반으로 하는 로컬 비디오 편집. 모든 것은 사용자 컴퓨터에서 실행됩니다: 음성 인식은 Whisper(faster-whisper), 미디어 처리는 FFmpeg, 캡션과 카툰 모드(선택 사항)에서 애니메이션 렌더링은 HyperFrames(Node.js)를 사용합니다. API 키, 유료 서비스, 업로드되는 데이터가 없습니다.
명령줄은 이 스킬 폴더 안의 scripts/autocut.py입니다. 필수 패키지가 설치된 Python으로 실행하십시오("설정" 참고):
python "<skill-dir>/scripts/autocut.py" <명령어> ...
<skill-dir>는 이 스킬의 기본 디렉토리입니다(스킬 로드 시 표시됨).
모드 선택
| 사용자가 원하는 것 | 모드 | 명령어 |
|---|---|---|
| "이 영상 편집해 줘", "멈춤 잘라 줘", "음... 제거해 줘", "다시 찍은 거 정리해 줘" | 자동 편집 | edit VIDEO -o PROJECT |
| 영상을 자르지 않고 캡션/자막 추가 | 캡션 | captions VIDEO -o FOLDER |
| 화자 위에 애니메이션 장면, 전체 녹화 유지 | 전체 애니메이션 | cartoon init VIDEO -o PROJECT, 스토리보드, cartoon render |
| 먼저 편집한 후, 편집된 영상에 애니메이션 적용 | 완료 | complete VIDEO -o FOLDER, 스토리보드, cartoon render |
| "카툰", "애니메이션 팟캐스트" (자르기 여부 미지정) | 한 번 질문: 전체 유지(전체 애니메이션) 또는 먼저 자르기(완료)? |
요청이 모호하면 한 문장의 짧은 질문으로 어떤 모드를 원하는지 묻고 하나를 추천하십시오. 그 전에, 세션에서 한 번 doctor를 실행하십시오: 이 명령은 현재 기계에서 어떤 모드가 준비되었는지 알려줍니다.
설정 (기계당 한 번)
python -m venv .venv로 가상 환경을 만들고 활성화한 후,pip install -r "<skill-dir>/requirements.txt"를 실행합니다.- FFmpeg(
ffmpeg및ffprobe)가 PATH에 있어야 합니다. - 카툰 모드만: Node.js 18+ (npx 및 npm). HyperFrames 0.8.79는 처음 사용 시 npx로 가져오며 자동 업데이트되지 않습니다. 각 카툰 프로젝트는 npm으로 GSAP을 설치합니다.
python "<skill-dir>/scripts/autocut.py" doctor
첫 번째 전사는 Whisper 모델을 다운로드합니다(--model tiny ~75 MB, small ~480 MB, 기본값). 언어를 알고 있으면 --language를 사용하십시오. 어려운 오디오에는 --model medium 또는 large-v3를 사용하십시오.
자동 편집
python "<skill-dir>/scripts/autocut.py" edit input.mp4 -o edits/my-video [--language en] [--model small]
단계: 전사 → 분석 → 계획 → 렌더링 → 검증(편집본을 다시 전사하여 비교) → 캡션 → REPORT.md. 프로젝트 폴더의 출력물: renders/cut_vN.mp4 (깔끔한 편집), renders/final_vN.mp4 (내장 캡션 포함), captions_vN.srt, decisions.md (제거된 모든 구간과 그 유형 및 이유), analysis.md, verify_vN.json. 어떤 것도 덮어쓰지 않습니다: 모든 렌더링은 새 버전입니다. 원본 영상은 읽기만 합니다.
계획이 자체적으로 수행하는 작업(의도적으로 보수적):
- 첫 번째 단어 앞과 마지막 단어 뒤의 침묵 제거;
- 0.7초보다 긴 멈춤은 줄이되 완전히 제거하지는 않음; 문장 끝 이후의 멈춤은 더 유지(강조를 위한 멈춤 가능성);
- 군더더기 소리와 바로 뒤에 다시 시도된 불완전한 테이크 제거;
- 같은 문장의 두 개의 완전한 테이크 중, 증거를 바탕으로 더 깨끗한 것을 유지(절대 "마지막" 또는 "가장 짧은" 것이 아님); 증거가 동등하면 둘 다 유지하고 해당 사례는 "검토 필요"에 나열;
- 전사가 놓친 들리는 소리를 유지하고, Whisper가 침묵 위에 지어낸 텍스트는 제거.
게이트 (고위험 컷)
다른 곳에서 말하지 않은 단어(부정 포함)를 제거하는 컷은 고위험입니다. 자동 계획은 절대 고위험 컷을 만들지 않습니다. 고위험 컷은 overrides.json(사용자 요청에 따라 추가하는 컷)에서만 발생합니다. 각 고위험 컷이 승인될 때까지 렌더링이 중단됩니다. 승인하려면 사용자에게 decisions.md의 정확한 구간과 단어를 보여주고 명시적인 동의를 받은 후 다음을 실행하십시오:
python "<skill-dir>/scripts/autocut.py" approve PROJECT --start 12.0 --end 18.5 --by "user" --reason "asked to drop the tangent"
python "<skill-dir>/scripts/autocut.py" edit input.mp4 -o PROJECT # 전사는 재사용, 새 버전 렌더링
사용자가 승인하지 않은 승인을 기록하지 마십시오. plan PROJECT는 렌더링 없이 분석과 계획을 다시 실행합니다.
overrides.json (프로젝트 폴더 안)
{"cuts": [{"start": 12.0, "end": 18.5, "reason": "off-topic tangent"}],
"keep": [{"start": 3.0, "end": 4.2, "reason": "the filler is part of the joke"}],
"pauses": {"p04": {"action": "keep"}, "p07": {"keep_s": 0.8}}}
멈춤 ID(p04)는 analysis.md에서 확인할 수 있습니다. 결정이 어떻게 분류되는지는 references/editing.md를 참조하십시오.
사용자에게 보고
REPORT.md와 decisions.md를 읽고 사용자에게 간략히 알리십시오: 편집 전후 길이, 무엇이 제거되었고 그 이유, "검토 필요" 항목, 검증 통과 여부(누락된 단어, 유지된 부정). 영상을 듣거나 볼 수 없다고 말하십시오: 리듬과 취향은 사용자가 소리와 함께 판단할 몫입니다.
캡션만
python "<skill-dir>/scripts/autocut.py" captions input.mp4 -o captions/my-video [--no-burn] [--caption-y 0.75]
captions.srt, captions.json, captioned.mp4를 생성합니다. 세로 영상은 높이의 70%에 큰 대문자 캡션이 표시되고, 가로 영상은 하단 근처에 표시됩니다. 모든 말한 단어가 한 번, 순서대로 나타납니다.
카툰 (전체 애니메이션 및 완료)
cartoon init VIDEO -o PROJECT(완료 모드는 먼저edit을 실행하고 편집본에 카툰 프로젝트를 생성합니다).PROJECT/speech.md(시간이 포함된 음성 블록)를 읽고PROJECT/storyboard.json을 작성하십시오: 전체 영상을 빈틈없이 덮는 장면들, 각각 시나리오, 호스트의 포즈와 표정, 객체 및 화면상 텍스트를 포함합니다. 스키마, 카탈로그(시나리오, 포즈, 표정, 객체, 전환) 및 레이아웃 규칙은references/cartoon.md에 있습니다. 첫 번째 스토리보드를 작성하기 전에 반드시 읽으십시오.- 오류가 없을 때까지
cartoon check PROJECT를 실행하십시오. 화면상 텍스트는 말한 단어만 사용할 수 있습니다. cartoon snapshot PROJECT --at 1.5,8,20을 실행하고reviews/폴더의 프레임을 확인하십시오.cartoon render PROJECT(또는 빠른 테스트를 위해--range 0-6사용). 출력:renders/cartoon_vN.mp4(원본 오디오가 변경되지 않고 복사됨);renders/cartoon_vN.qc.json(길이와 오디오 확인).
애니메이션은 사용자가 작성한 스토리보드를 통해서만 음성의 의미를 읽습니다: 코드가 자체적으로 음성을 이해하지는 않습니다.
규칙
- 원본 영상이나 이전 렌더링을 수정하거나 삭제하지 마십시오.
- 음성의 의미를 바꾸는 컷을 추가하지 마십시오. 사용자를 대신하여 고위험 컷을 승인하지 마십시오.
- 화면상 텍스트와 캡션은 말한 단어만 사용합니다.
- 렌더링은 한 번에 하나씩 실행하십시오. 카툰 렌더링은 무겁습니다(
references/troubleshooting.md참조). - 결과가 "듣기 좋다"고 말하지 마십시오: 들을 수 없습니다. 측정된 내용을 보고하십시오.
실패 시
references/troubleshooting.md를 참조하십시오 (FFmpeg 누락, 모델 다운로드, Node/npx, HyperFrames, 메모리, 잘못된 언어, 잘못된 전사).