super-video-cut은(는) 무엇을 하나요?

포지셔닝

모든 편집 작업을 '느낌'으로 조립한 클립 더미'가 아닌 '증거 사슬을 갖춘 엔지니어링 전달' 로 취급하십시오. 이 스킬은 재현 가능한 객관적 측정, 항목별로 정당화된 평가, 재사용 가능한 타임라인 템플릿, 전달 전 품질 검사(QC), 그리고 전체 프로세스에 걸친 저작권 경계를 제공합니다.

references/ 디렉토리에 심층 자료가 기능 영역별로 나뉘어 저장되어 있습니다 (약 50개 문서, 대부분 100–250줄의 매개변수 테이블 및 명세). 모든 문서를 미리 읽지 마십시오 — 아래 라우팅을 따라 현재 단계에 필요한 1–3개 문서만 읽으십시오.

본 파일 전체에서 사용되는 볼륨 약어: 09/02는 references/09-material-memory/02-*.md를 의미합니다.

세 가지 절대 원칙

하나라도 위반하면 결과물을 전달해서는 안 됩니다.

레퍼런스 스타일: 평가 먼저, 편집은 그 다음. 사용자가 레퍼런스 영상을 제공하면, 세 가지 차원(편집 기법 / 사운드 / 장면)에 대한 평가를 모든 항목에 대해 항목별 정당성과 함께 완료하고, 사용자 확인을 받기 전까지 타임라인을 건드려서는 안 됩니다. 확인 없이 편집을 진행하는 것은 재작업으로 간주합니다.
푸티지: 모델을 호출하기 전에 캐시를 확인하십시오. 비디오 자료를 분석하기 전에 반드시 material_cache.py lookup을 실행하십시오. 히트가 발생하면 자료 설명 카드를 직접 읽으십시오 — 비디오 모델을 다시 호출하는 것은 금지됩니다. 미스인 경우에만 전체 분석을 한 번 수행하고 등록하십시오.
규정 준수 및 QC가 최우선입니다. 저작권 위험을 확인하지 않은 편집 계획을 실행하거나 qc_scan.sh를 통과하지 않은 완성 파일을 전달해서는 안 됩니다. 법률 볼륨은 참고 자료이며 법적 조언이 아닙니다. 상업용 또는 고위험 프로젝트의 경우 법률 전문가의 검토를 받도록 사용자에게 알리십시오.

메인 워크플로 M0–M6

단계	목표	필독 자료	산출물
M0 접수	실행 가능한 매개변수 확정	본 파일	브리프
M1 푸티지 접수	동일한 토큰에 두 번 비용을 지불하지 않음	`09/02` + `scripts/material_cache.py`	자료 카드 또는 캐시 히트
M2 스타일 평가	'느낌'을 매개변수로 전환	`08/02` + `08/03` + `scripts/reference_probe.sh`	평가 시트 + 지문 + 한 페이지 결론
M3 편집 계획	지문 → 타임라인	`08/04` + 해당 장르 볼륨	초 단위 계획
M4 제작	편집 / 음성 / 자막 / 그레이딩	필요에 따라 `01` / `02` / `03`	러프 컷 및 프로젝트 파일
M5 전달 QC	기술 + 규정 준수 통과	`06/01` + `06/02` + `06/03`	QC 보고서 + 탐지 로그
M6 피드백	후보군만 생성, 규칙을 자동 변경하지 않음	`08/05`	자기 개선 기록

M0 접수: 누락된 매개변수 질문, 최대 3개

다음을 반드시 획득해야 합니다: 플랫폼 및 종횡비(안전 영역 및 길이 결정), 총 길이, 음성 해설/더빙 필요 여부, 상업용 여부, 전달 사양(해상도 / 비트레이트 / 컨테이너).

이미 알고 있는 정보에서 추론 가능한 것은 추론하여 명시하십시오. 사용자에게 항목별로 질문하지 마십시오. 작업의 상업성 여부는 사용 가능한 음악 및 푸티지를 직접 결정하므로, 불명확한 경우 반드시 질문해야 합니다.

M1 푸티지 접수: 다섯 가지 상태 각각에 대한 조치가 고정되어 있습니다

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # 캐시는 프로젝트 내부에 유지, 스킬 디렉토리 내부에는 절대 두지 않음
python "$SK/scripts/material_cache.py" lookup "<푸티지 경로>"

상태	조치
`HIT`	비디오 모델을 호출하지 않음. `$MDC_HOME/cards/<MID>.yaml`을 읽고 주제 적응만 수행
`MISS`	로컬 E1 프로브 → `references/09-material-memory/templates/model-analysis-prompt.md`를 사용한 한 번의 전체 분석 요청 → 카드 작성 → `validate` → `register`
`STALE`	푸티지가 변경됨. 기존 카드를 `superseded`로 표시하고 MISS처럼 재실행
`HIT_BLOCKED`	권리 상태가 명확하지 않음. 사용하지 말고 먼저 권리 문제 해결
킬 스위치	`_config.json`에 `cache_enabled=false`인 경우 모든 것을 MISS로 처리. 이를 우회하는 것은 금지

설명 카드는 세 가지 계층으로 구성됩니다: L0 식별(해시 / 사양), L1 자료 설명(내용 / 촬영 장소 / 스타일 / 사용 가능 여부), L2 주제 적응(이 주제가 사용하는 초 단위 구간 및 내러티브 역할). "주제 X의 오프닝으로 잘 작동함"은 L2에만 속합니다 — L1에 넣으면 다른 모든 주제를 오염시킵니다.

위치 필드는 엄격한 규칙입니다: 화면 내 텍스트, 랜드마크, 또는 촬영 기록이 없는 경우 place_name: null로 설정하십시오. "바다와 야자수가 있다"는 이유로 도시를 추론하지 마십시오.

M2 스타일 평가: 사용자가 레퍼런스 영상을 제공할 때마다 여섯 단계

S1 규정 준수 사전 점검 → S2 객관적 프로브 → S3 전체 시청 두 번 → S4 차원별 평가
→ S5 한 페이지 결론 → S6 ★사용자 확인 게이트★

S1 분석만 수행하고 표현을 재사용하지 마십시오. 오프닝/클로징 타이틀, 대화, 음악, 키네틱 텍스트, 샷 구성은 모두 protected: expression으로 태그 지정합니다.
S2 프로브 스크립트를 실행하여 재현 가능한 수치(컷 포인트, 샷 길이, 음량, 무음, 색상 통계, 콘택트 시트)를 얻습니다.
S3 전체를 두 번 시청: 한 번은 영상만, 한 번은 사운드만. 빠른 속도로 건너뛰면 리듬과 유지되는 비트를 놓칩니다 — 이것이 가장 흔한 방법론적 오류입니다.
S4 세 가지 핵심 그룹(편집 기법 / 사운드 / 장면 — 각 10개 하위 항목)에 더해 D 자막, E 내러티브, F 플랫폼 컨텍스트, G 규정 준수 경계(필수) 에 대해 항목별로 평가합니다.
S5 한 페이지 결론 제공: 3가지 핵심 특성, 3가지 비이전 가능 항목, 전체 신뢰도.
S6 사용자에게 확인을 위해 전달합니다. 이 확인 없이 M3에 진입할 수 없습니다.

모든 평가 항목은 다섯 부분을 모두 채워야 하며, 한 부분이라도 누락되면 전체 항목이 무효화됩니다:

① 관찰(타임코드 + 구체적 현상) ② 근거(증거 ID) ③ 추론(이렇게 설계된 이유) ④ 조치 항목(이 컷이 이를 어떻게 활용) ⑤ 신뢰도(높음/중간/낮음 + 이유)

반례 (절대 출력해서는 안 됨): "편집이 매끄럽고 매우 영화적입니다." — 타임코드, 근거, 조치 항목이 없으며 실행 가능하지 않습니다.

모든 조치 항목에는 전송 태그가 있어야 합니다: transferable: parameter (리듬, 길이, 음량, 샷 크기 시퀀스 — 학습 가능) 또는 protected: expression (특정 샷, 대화, 음악, 키네틱 텍스트 — 재현 불가). 스타일과 공식은 아이디어 영역에 있으며 차용할 수 있지만, 표현은 복사할 수 없습니다. 이것이 이 스킬의 저작권 최소 기준이며, 단순 제안이 아닙니다.

M3 편집 계획: 지문을 초 단위 타임라인으로 변환

08/04의 매핑 규칙을 읽고 직접 실행 가능한 타임라인을 생성하십시오: 모든 클립의 인/아웃 포인트, 샷 크기, 전환 유형 및 프레임 단위 길이, 음향 효과 큐 포인트, 자막 인/아웃 포인트, 음량 목표.

충돌 해결 순서: 명시적 사용자 요청 > 하드 플랫폼 제한 > 레퍼런스 영상 특성 > 기본 미학. 푸티지가 특정 기술을 지원할 수 없는 경우, 억지로 적용하지 말고 솔직하게 말하십시오 — "레퍼런스는 기술 X를 사용하지만, 이 프로젝트에는 일치하는 푸티지가 없어 Y로 대체합니다"와 같이.

M4 제작: 현재 작업당 정확히 한 개의 볼륨 읽기

작업	읽을 문서
리듬, 전환, 축	`01/01`, `01/02`
프로젝트 구성, 프록시, 컨폼, 전달	`01/03`
컬러 그레이딩, Log/LUT, HDR	`01/04`
음성 녹음, 전달, ADR	`02/01`
믹싱, 음량, EQ/압축	`02/02`
악보, 음향 효과, 사운드 디자인	`02/03`
AI 음성, TTS, SSML	`02/04`
자막 레이아웃 및 길이	`03/01`
SRT/VTT/ASS/TTML 형식	`03/02`
전사, 정렬, 번인	`03/03`
다국어, CC/SDH, 접근성	`03/04`
특정 장르 편집 방법	`04/01`–`04/06`

음량 기준 (02/02에 전체 목표 테이블 있음): 스트리밍 약 -14 LUFS, 팟캐스트/Apple 약 -16 LUFS, 방송 EBU R128 -23 LUFS, 트루 피크는 일반적으로 ≤ -1 dBTP 필요. 대상 플랫폼의 공식 문서를 우선 참조하십시오; 확실하지 않으면 먼저 측정한 후 결정하십시오.

M5 전달 QC: 먼저 스크립트 실행 후 사람이 판단

bash "$SK/scripts/qc_scan.sh" "<완성 파일>" "<출력 디렉토리>"

한 번 실행으로 사양 JSON, 디코드 무결성, 블랙 프레임/프리즈 탐지, 무음, 음량, 콘택트 시트를 얻습니다. 스크립트는 기술적 이상만 찾을 수 있습니다 — 콘텐츠 및 규정 준수는 수동으로 테이블을 확인해야 합니다:

06/01 기술 사양 체크리스트 (해상도 / 프레임 레이트 / 색상 / 비트레이트 / 오디오 트랙 / 길이 / 이름 지정)
06/02 콘텐츠 및 규정 준수 검토 (사실, 민감한 콘텐츠, 금지된 광고 주장, 권리 문서)
06/03 표 A–G 작성 템플릿 (아카이브용)

M6 피드백 루프: 하나의 히트 영상이 규칙을 변경하지 않음

실제 피드백(완료율, 전환율, 클라이언트 노트)이 도착하면 08/05에 따라 오류 귀인을 수행하고 08/case-library/<CASE-ID>/self-improvement-record.md에 기록합니다.

엄격한 규칙: 단일 사례는 후보군만 생성합니다. 변경은 ≥5개의 동일 방향 샘플, 동결된 회귀 테스트 세트, 사람의 승인, 버전 관리, 카나리 릴리스를 거친 후에만 적용됩니다. 자기 개선 엔진은 자료 설명 카드의 E1/E2 객관적 필드를 자동으로 재작성해서는 안 됩니다 — 캐시가 하나의 오류를 모든 후속 주제에 퍼뜨리는 반면, 히트 레코드는 여전히 정상적으로 보이기 때문입니다.

트리거 시 최단 경로

사용자가 말함	수행할 작업
"이 바이럴 영상 스타일로 뭔가 편집해 줘"	전체 M2 흐름 → S6 확인 게이트; 편집을 시작하지 마십시오
"이 비디오를 편집해 줘"	M0 플랫폼/길이/상업용 확인 → M1 푸티지 → M3 계획
"이 푸티지 사용 가능한가요? 뭐가 보이나요?"	M1 `lookup`; HIT이면 즉시 답변, MISS에서만 분석
"자막 추가해 줘"	`03/01` 레이아웃 + `03/03` 전사 및 정렬; 읽기 속도 및 최소 길이 확인
"음성 해설이 안 좋아요"	`02/01` 녹음 → `02/02` 처리 체인 → 음량 측정
"Douyin / WeChat Channels / Bilibili용으로 내보내기"	`04/01` 플랫폼 사양 + `06/01` 전달 확인
"이 편집 내용이 저작권을 침해하나요?"	`05/02` 결정 트리 + `08/02`의 차원 G; 최종 법적 의견이 아닌 위험 등급 제공
"완성된 컷 괜찮나요?"	`qc_scan.sh` + `06/01` / `06/02` 항목별 확인

스크립트

스크립트	목적	의존성
`scripts/material_cache.py`	푸티지 지문, 캐시 조회, 등록, 재사용, 검증, 통계 (8개 하위 명령어)	Python 3, 서드파티 패키지 없음
`scripts/reference_probe.sh`	레퍼런스 또는 푸티지 파일의 객관적 프로브: 컷 포인트, 샷 길이, 음량, 무음, 색상, 콘택트 시트	bash + ffmpeg/ffprobe
`scripts/qc_scan.sh`	완성 파일의 기술 QC: 사양, 디코드, 블랙 프레임, 프리즈, 무음, 음량, 콘택트 시트	bash + ffmpeg/ffprobe

먼저 환경을 확인하십시오: ffmpeg -version && ffprobe -version && python --version. ffmpeg 없이는 모든 객관적 측정이 불가능합니다 — 이 경우 수동 평가만 가능하며 재현 가능한 지표를 제공할 수 없다고 사용자에게 솔직히 알리십시오. 절대 숫자를 조작하지 마십시오.

전달 전 자체 점검

레퍼런스가 S1–S6을 거쳤고 사용자가 확인함 (레퍼런스를 사용한 경우)
모든 푸티지가 캐시에서 출처 및 권리 상태를 추적할 수 있음
"매끄러운", "고급스러운", "질감 있는"과 같은 증거 없는 표현이 평가나 계획에 나타나지 않음
음량이 측정되어 목표 허용 오차 내에 있으며, 트루 피크가 제한 이하임
자막이 안전 영역을 벗어나지 않고, 오타가 없으며, 읽기 속도 제한을 충족함
qc_scan.sh가 차단 항목을 보고하지 않으며, 표 A–G가 작성됨
음악 / 폰트 / 초상권 / 스톡에 대한 권리 문서가 완전하거나 위험 등급이 명시됨
전달 파일 이름, 컨테이너, 비트레이트가 플랫폼 요구 사항과 일치함

자료의 범위 (사용자에게 반드시 명시해야 함)

법률 볼륨은 법적 조언이 아닙니다. 법령과 사법적 입장은 변경될 수 있으므로, 상업용 또는 고위험 프로젝트의 경우 법률 전문가의 검토를 받고 최신 공식 텍스트에 의존하십시오.
플랫폼 매개변수는 변경됩니다. 길이, 비트레이트, 안전 영역, 음량 목표는 출처에 따라 충돌하므로 항상 "플랫폼의 최신 공식 문서에 따름"으로 표시되며, 전달 전 업로드 및 미리보기로 확인하십시오.
자기 개선 매개변수에는 업계 표준이 없습니다. 08 볼륨의 η, δ, N_min 등은 이 라이브러리의 자체 시작 값일 뿐이며, 프로세스를 실행 가능하게 하기 위해 존재하는 것이지 검증된 최적값이 아니기 때문입니다.
약 190개의 "TO VERIFY" 항목이 각 문서 본문 또는 끝에 항목화되어 있으며, references/00-overview/sources-and-reliability.md(A/B/C/D 증거 등급 및 P0/P1/P2 우선순위 포함)에 집중되어 있습니다. 인용하기 전에 해당 파일의 증거 등급을 확인하십시오.

라우팅 및 인덱스

references/INDEX.md — 단계 또는 작업별 최단 경로 및 최소 필독 자료
references/00-overview/knowledge-map.md — 전체 기능 영역 매핑 및 문제 해결 빠른 조회
references/00-overview/sources-and-reliability.md — 증거 등급, 출처 목록, TO VERIFY 항목
references/00-overview/manifest.csv — 기계 판독 가능 파일 인덱스

큰 파일을 검색할 때는 처음부터 끝까지 읽지 말고 키워드로 찾으십시오. 예: grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md.

super-video-cut

super-video-cut란 무엇인가요?

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

문서

super-video-cut은(는) 무엇을 하나요?

포지셔닝

세 가지 절대 원칙

메인 워크플로 M0–M6

M0 접수: 누락된 매개변수 질문, 최대 3개

M1 푸티지 접수: 다섯 가지 상태 각각에 대한 조치가 고정되어 있습니다

M2 스타일 평가: 사용자가 레퍼런스 영상을 제공할 때마다 여섯 단계

M3 편집 계획: 지문을 초 단위 타임라인으로 변환

M4 제작: 현재 작업당 정확히 한 개의 볼륨 읽기

M5 전달 QC: 먼저 스크립트 실행 후 사람이 판단

M6 피드백 루프: 하나의 히트 영상이 규칙을 변경하지 않음

트리거 시 최단 경로

스크립트

전달 전 자체 점검

자료의 범위 (사용자에게 반드시 명시해야 함)

라우팅 및 인덱스

관련 스킬

steipete/video-frames

steipete/summarize

openclaw/openclaw

obra/superpowers

affaan-m/ECC

affaan-m/everything-claude-code