침묵 자르기 (파이프라인 에이전트 1)
자동 편집의 첫 번째 단계입니다. 원본 녹화와 단어 수준 전사본을 받아 침묵만 제거합니다: 첫 단어 전과 마지막 단어 후의 데드 에어, 그리고 임계값보다 긴 단어 간 일시 정지(자연스러운 호흡 간격으로 줄이며, 절대 완전 무음이 되지 않음). 화자의 단어는 그대로 둡니다. 잘못된 시작, 재시도, 말더듬은 cut-mistakes 에이전트(에이전트 2)의 작업입니다.
이 에이전트는 결정론적이며 전사본 기반으로 작동하므로, 출력 파일(*.silence-transcript.json)은 다음 에이전트와 비트 동기화 검증기에 깔끔하게 전달됩니다.
사용 시기
- "침묵을 잘라줘", "일시 정지를 다듬어줘", "데드 에어를 제거해줘", "템포를 조정해줘"
- 마스터 편집 워크플로우의 첫 번째 단계, 전사 직후.
전제 조건
단어 수준 전사본 JSON 파일. ElevenLabs Scribe 형식({ words: [{ text, start, end, type }], audio_duration_secs }) 또는 일반 형식({ words: [{ text, start, end }] }) 모두 가능합니다. 워크스페이스 전사 도구를 사용하여 생성하십시오:
node scripts/transcribe-elevenlabs.mjs path/to/raw.mp4 # -> path/to/raw.json
사용법
# 1) 계획만 수립 — 컷 계산, EDL + 재타이밍 전사본 작성 (비디오는 건드리지 않음)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
--out-dir video-projects/<slug>/assets
# 2) 비디오 포함 — ffmpeg 명령어도 작성 (아직 렌더링하지 않음)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
--video video-projects/<slug>/assets/raw.mp4 --out-dir video-projects/<slug>/assets
# 3) 편집된 비디오 렌더링 (로컬 ffmpeg, 재인코딩, A/V 동기화 유지)
# 실제 ffmpeg를 실행하려면 --apply 추가
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
--video video-projects/<slug>/assets/raw.mp4 --apply \
--output video-projects/<slug>/assets/edited-silenced.mp4
옵션
| 플래그 | 기본값 | 설명 |
|---|---|---|
--video <path> | — | 원본 비디오; ffmpeg 명령어/렌더링 활성화 |
--out-dir <dir> | 전사본 옆 | 출력 파일이 저장될 디렉토리 |
--output <path> | <video-stem>.silenced.mp4 | 편집된 비디오 경로 |
--gap <s> | 0.55 | 제거 대상이 되는 최소 일시 정지 시간 |
--head-pad <s> | 0.22 | 첫 단어 전에 유지할 침묵 시간 |
--tail-pad <s> | 0.34 | 마지막 단어 후에 유지할 침묵 시간 |
--apply | off | 실제 ffmpeg를 실행하여 편집된 비디오 렌더링 |
결정 방식 (침묵 규칙)
--gap(0.55초) 미만의 일시 정지는 그대로 유지합니다. 자연스러운 말하기 리듬입니다.- 잘라내는 일시 정지의 경우 자연스러운 호흡이 유지되며, 문맥에 따라 크기가 조정됩니다: 긴 일시 정지(≥2초)는
0.24초, 문장 종결자(. ! ?) 뒤는0.20초, 그 외는0.14초. 유지되는 호흡은 이전 구문의 끝 부분에 약간 치우쳐 배치됩니다. - 처음/끝 데드 에어는
--head-pad/--tail-pad로 다듬어집니다. - 삭제 범위는 병합되고, 유지 범위는 그 보완 집합이 됩니다. 편집은 ffmpeg
trim/atrim+concat필터그래프를 사용하여 렌더링되며(*.silence-filter.txt스크립트로 작성되어-/filter_complex로 전달됨), 비디오와 오디오가 동기화됩니다.
출력 파일 (--out-dir에 작성됨)
| 파일 | 용도 |
|---|---|
<stem>.silence-edl.json | 유지/삭제 범위, 길이, 매개변수 — 편집 결정 목록 |
<stem>.silence-transcript.json | 편집된 타임라인에 맞춰 재타이밍된 단어들 (에이전트 2 + 비트에 전달됨) |
<stem>.silence-decisions.md | 사람이 읽을 수 있는 요약 + 가장 큰 일시 정지 정보 |
<stem>.silence-filter.txt | ffmpeg 필터그래프 (--video가 있을 때만) |
<video-stem>.silenced.mp4 | 편집된 비디오 (--apply가 있을 때만) |
stdout으로 출력되는 JSON 요약에는 removed, removedPct, 범위 개수 및 출력 경로가 포함되어 있어 마스터 워크플로우에서 로깅 및 체인 연결에 유용합니다.
튜닝 노트
- 토킹헤드 YouTube 기본값(
--gap 0.55)은 일반적인 원본 촬영본의 약 15-20%를 순수 침묵으로 제거합니다. 더 빠르고 강력한 컷을 원하면--gap을 낮추고, 더 자연스러운 호흡 공간을 유지하려면 높이십시오. - 문장 경계에서 컷이 너무 공격적이라고 느껴지면 문장 끝 호흡 시간을 늘리거나
--gap을 높이십시오.
다음 에이전트로 전달
<stem>.silence-transcript.json (렌더링된 경우 silenced.mp4도 함께)을 cut-mistakes 에이전트에 전달하십시오. 타임스탬프가 이미 편집된 타임라인에 맞춰져 있으므로 다운스트림 비트 타이밍과 scripts/validate-beat-sync.mjs가 추가 조정 없이 작동합니다.