CutCraft은(는) 무엇을 하나요?
원본 푸티지와 대화를 하나의 명확한 최종 비디오로 만듭니다. 모든 프로젝트는 이름이 지정된 CutCraft 워크스페이스 안에 보관하고, 편집 전에 시각적 자막 선택 항목을 보여주며, 창의적인 질문은 한 번만 하고, 대본 수정은 즉시 되돌릴 수 있도록 합니다.
비타협적 계약
- 먼저 준비 상태 게이트를 실행합니다. 처음 사용 시 또는 환경 변경 후
python3 helpers/check_environment.py를 실행합니다. 필수 또는 요청된 조건부 종속성이 누락된 경우 편집을 일시 중지하고 사용자에게 스크립트의 공식 URL과 정확한 설정 지침을 보여주고 누락된 승인 또는 자격 증명만 요청합니다. 키 처리 및 플랫폼 지침은 references/onboarding.md를 참조하십시오. - 이 패키지나 프로젝트에 비밀번호를 저장하지 마십시오. ElevenLabs 키는 모드
600으로~/.config/cutcraft/.env에 저장하거나, 로컬 Whisper를 사용하여 키나 대본 업로드가 필요 없도록 합니다. 키를 명령 인수, 로그, 대본, 스크린샷, 저장소, 플러그인 캐시 또는 프로젝트 폴더에 절대 넣지 마십시오. - 무언가를 생성하기 전에 워크스페이스를 만드십시오. 사용자의 설명과 검사된 푸티지에서 짧은 프로젝트 이름을 유추합니다. 두 가지 실질적으로 다른 이름이 가능할 때만 확인합니다.
helpers/project_workspace.py --name "<이름>"을 실행하고 반환된 경로를 사용합니다. - 먼저 검사하고, 한 번만 질문하고, 승인 후 편집합니다. 소스를 목록화하고 대본을 만들고, 대표적인 시각 자료를 검사하고, 실제 자막 미리보기 이미지를 만든 다음, 나머지 모든 창의적인 질문을 하나의 통합 체크포인트에서 묻습니다. 사용자가 권장 기본값을 선택하거나 수락하기 전에 편집을 시작하지 마십시오.
- 선택 사항을 시각적으로 보여줍니다. 세 가지 재료 인식 자막 미리보기 이미지(권장, 깔끔/내러티브, 굵게/소셜—푸티지에 따라 다른 선택이 필요한 경우 제외)를 생성합니다. 각 이미지 아래에 글꼴, 크기, 배치, 배경, 언어 및 큐 리듬을 명시합니다. 사용자는 옵션 번호나
往下 4%또는字大 15%와 같은 조정 사항으로 응답할 수 있습니다. - 최종 결과물을 명확하게 유지합니다.
成品/폴더에만 최종 전달물을 넣습니다. 기본 비디오 이름은<project>_final.mp4여야 합니다. 미리보기, 클립, 대본, EDL, 다운로드, 생성된 자산 및 보고서는過程/폴더에 넣습니다. - 모든 자막이 포함된 전달물과 함께 편집 가능한 텍스트를 내보냅니다. 최종 비디오 옆에
<project>_逐字稿.md와<project>.srt를 전달합니다. 사용자가 예를 들어第 18 句改成……과 같이 말할 수 있도록 안정적인 큐 ID와 타임스탬프를 사용합니다. - 대본 수정 사항을 즉시 적용합니다. 요청된 큐를 확인하고,
過程/master.srt에 대해helpers/apply_transcript_corrections.py를 실행하고, 유효성 검사를 다시 실행하고, 수정된 SRT로 최종 비디오를 다시 렌더링하고, 대본을 다시 생성하고, 전달물을 교체합니다. 사용자가 동기화 문제를 보고하지 않는 한 타이밍을 유지합니다. 변경되지 않은 소스 미디어를 다시 전사하지 마십시오. - 검토 프론트엔드가 없습니다. 서버를 시작하거나 브라우저 UI 파일을 생성하지 마십시오. 모든 검토는 전달된 비디오/이미지 파일과 대화형 수정을 통해 이루어집니다.
- 작업을 재개 가능하게 만듭니다. 모든 체크포인트에서
cutcraft.project.json을 업데이트합니다. 소스 서명, 승인 상태, 수정본, 최종 경로 및 자산 출처를 보존합니다. 검사에는 프록시만 사용하고, 항상 원본에서 렌더링합니다. - 전달 전에 확인합니다. 결정론적 사전 점검과
quality_report.py를 실행하고, 렌더링된 출력물을 컷 경계와 대표적인 자막 순간에 검사하고, 최종 믹스를 듣고, 출력 지속 시간/스트림을 확인합니다. 컷이 더듬거림이나 잘못된 시작을 제거한 경우, 렌더링된 섹션을 다시 전사하여 해당 부분이 사라졌음을 증명합니다.
프로젝트 레이아웃
기본 루트: ~/Documents/Codex/CutCraft/ (Finder에서 보임; 설치 가능한 스킬 자체는 ~/.codex 아래에 유지).
CutCraft/
└── <project>/
├── cutcraft.project.json
├── 成品/
│ ├── <project>_final.mp4
│ ├── <project>_逐字稿.md
│ └── <project>.srt
└── 過程/
├── project.md
├── creative_brief.json
├── inventory.json
├── takes_packed.md
├── edl.json
├── master.srt
├── transcript_corrections.json
├── asset_registry.json
├── transcripts/
├── clips/ and clips_*/
├── assets/
├── animations/
├── proxies/
├── downloads/
└── verify/
사용자가 요청하지 않는 한 사용자 소스 푸티지를 프로젝트에 복제하지 마십시오. 절대 소스 경로를 edl.json에 기록하고 원본은 그대로 둡니다.
하나의 통합 체크포인트
권장 사항을 제시할 수 있을 만큼 충분한 자료를 검사하고, 자막 비교 이미지를 렌더링한 후, 다음 항목을 모두 함께 질문합니다:
- 목표, 대상 청중, 플랫폼, 종횡비, 해상도, 목표 길이, 마감일에 민감한 형식.
- 이야기/순서, 반드시 유지해야 할 대사, 반드시 제거해야 할 자료, ASR이 정확하게 철자해야 할 이름/용어.
- 속도, 자르기/리프레이밍, 색상 분위기, 전환, 효과, 오버레이, B-롤, 검열/개인정보 보호 요구 사항.
- 자막: 굽기/사이드카/둘 다, 단일 언어 또는 이중 언어 모드, 그대로/정리됨, 글꼴, 크기, 위치, 배경, 큐 리듬, 화면 UI 안전 영역.
- 오디오: 정리, 음량, 제공된 음악/SFX/내레이션, 또는 원하는 분위기와 강도.
- 자산 출처: 사용자 제공 파일, 생성된 자산, 또는 특정 무료 라이브러리. 무료 자료가 요청된 경우, references/free-assets.md에서 적절한 선택지를 제공하고, 사용자에게 선택을 요청하며, 항목, 제작자, URL, 라이선스, 저작자 표시 및 체크섬을
asset_registry.py로 등록합니다. - 전사 개인정보 보호: 개인정보가 중요할 때는 로컬 Whisper를 권장하고, 그렇지 않으면 관리형 화자 분리를 위해 ElevenLabs를 제공합니다. 미디어를 클라우드 제공업체에 보내기 전에 업로드 동작을 설명합니다.
- 편집 자율성 및 명시적으로 금지된 사항.
이 체크포인트에 미리보기 이미지를 첨부합니다. 모든 선택에 대해 권장 기본값을 제공하고 全部用建議值를 유효한 답변으로 포함시킵니다. 답변을 過程/creative_brief.json에 저장합니다. 편집 중간에 결정된 질문을 다시 열지 마십시오.
워크플로우
- 준비 상태를 확인하고 누락된 요구 사항만 해결합니다.
- 파일 이름과 사용자의 설명을 검사하고, 프로젝트 이름을 유추하여 워크스페이스를 생성합니다.
inventory.py --work-dir <過程> <sources_dir>을 실행합니다. 길거나 4K 소스의 경우 검사를 위해 캐시된 프록시를 생성합니다.analyze_media.py를 실행하여 장면 전환, 무음, 검은 프레임 및 정지 프레임 구간을 찾습니다.- 승인된 클라우드/로컬 제공자를 사용하여
<過程>/transcripts/에 전사하고, 대본을 패킹합니다. 패킹된 대본을 읽고, 초기/중간/후반 프레임과 모호한 편집 지점을 샘플링하며, ASR 철자 위험을 기록합니다. - 대표 프레임에서 세 가지 자막 스타일 미리보기를 생성합니다. 통합 체크포인트를 질문하고 승인된 브리프를 저장합니다.
edl.json을 구축하고, 승인된 자산을 소싱하거나 생성하며, 일반적인 취향 질문을 반복해서 묻지 않고 편집합니다.- 자막을 구축합니다. 중국어의 경우
build_cn_subtitles.py를 사용하고, 다른 언어의 경우render.py --build-subtitles를 사용합니다. references/subtitles.md를 따릅니다. validate_project.py를 실행하고,過程/verify/에 평가 가능한 미리보기를 렌더링하고, 자체 검토합니다. 고집스러운 문제를 보고하기 전에 수정/재렌더링 루프를 세 번으로 제한합니다.- 원본 소스에서
<成品>/<project>_final.mp4를 렌더링하고, 최종 SRT를<成品>/<project>.srt에 복사하고,export_transcript.py로<成品>/<project>_逐字稿.md를 생성합니다. quality_report.py를 실행하고, 모든 오류를 해결하고, 경고를 시각적, 청각적으로 검토한 후,project_state.py로 매니페스트를 전달 완료로 표시합니다.- 세 가지 명시적 경로, QC 보고서, 간결한 편집 요약 및 자산 출처를 전달합니다. 사용자가 중간 파일 중에서
final을 검색하도록 하지 마십시오.
제작 정확성
- 모든 오버레이와 자르기 후에 마지막으로 자막을 적용합니다.
- 컷 후보는 단어 경계와 무음에서 파생하며, 단어 중간을 절대 자르지 않습니다. 속도에 맞게 30–200 ms의 패딩을 사용합니다.
- 클릭을 방지하기 위해 세그먼트 경계에 짧은 오디오 페이드를 적용합니다.
- 클립을 결합하기 전에 캔버스, 프레임 속도, 픽셀 형식, 색상 공간, 샘플 속도 및 채널 레이아웃을 정규화합니다.
- 소스 경로, 크기 및 수정 시간별로 대본과 프록시를 캐시하고, 해당 서명이 변경된 경우에만 다시 실행합니다.
- 소스 타임라인이 아닌 출력 타임라인에서 자막 타임스탬프를 계산합니다.
- 한 줄 큐가 승인된 경우 픽셀 세이프 단일 줄 큐를 보장하고, 실제 글꼴과 캔버스에 대해 검증합니다.
- 사용자 제공, 생성된, 공개 도메인 또는 라이선스 호환 자산만 사용합니다. 제목, 제작자, 소스 URL, 라이선스, 다운로드 날짜 및 필수 저작자 표시를 기록합니다.
- 먼저 대화를 믹싱합니다. 음악을 대화 아래로 덕킹하고 들어봅니다. 음량 정규화는 나쁜 믹스를 구할 수 없습니다.
- 메인 에이전트가 창의적 브리프, EDL, 자막 타이밍, 최종 타임라인, 믹스 및 QC의 소유자로 유지됩니다. 고유한 경로를 쓰는 불변 입력 작업만 병렬화합니다.
다중 테이크 선택, 전환, 그레이딩, 애니메이션, 스피드 램프 또는 음악 주도 편집이 필요한 프로젝트는 references/editorial-craft.md를 참조하십시오. EDL을 작성하거나 확장하기 전에 references/edl.md를 읽으십시오.
헬퍼
check_environment.py— 필수/조건부 종속성 및 자격 증명 준비 상태(공식 설정 URL 포함).project_workspace.py— 이름이 지정된成品/+過程/프로젝트를 생성하거나 재사용합니다.project_state.py— 재개 가능한 체크포인트, 승인, 수정본 및 출력 경로를 원자적으로 기록합니다.inventory.py— 소스 형식 및 정규화 위험을 조사합니다.analyze_media.py— 장면 전환, 무음, 검은 프레임 및 정지 프레임을 감지합니다.create_proxy.py— 변경 불가능한 원본에 매핑된 캐시된 경량 검사 프록시.transcribe.py,transcribe_batch.py— 캐시된 단어 수준 ElevenLabs 또는 로컬 Whisper 전사.pack_transcripts.py— 간결한 구문 수준 편집 보기.timeline_view.py— 필름스트립, 파형, 단어 및 컷 포인트 검사.subtitle_style_preview.py— 실제 프레임에 대한 정확한 libass 스타일/배치 미리보기.build_cn_subtitles.py— 중국어 인식 픽셀 너비 큐 구성.render.py— 정규화, 컷, 결합, 오버레이, 믹싱 후 마지막으로 자막.validate_project.py— EDL, 자산, 타이밍 및 자막 검사를 신속히 실패.asset_registry.py— 자산 라이선스, 저작자 표시 및 체크섬 레지스트리를 오류 시 차단.quality_report.py— 최종 스트림, 지속 시간, 검은 프레임/정지/무음 및 QC 증거 보고서.build_cut_report.py— 분류된 컷 요약.apply_transcript_corrections.py— 감사 로그 및 백업이 포함된 오류 시 차단 큐/텍스트 수정.export_transcript.py— 전달을 위한 읽기 쉽고 큐 주소 지정이 가능한 대본.cleanup_session.py— 사용자가 명시적으로 프로세스 파일 삭제를 요청한 후에만 선택적 정리.完成을 삭제로 해석하지 마십시오.
모든 헬퍼와 참조는 이 SKILL.md가 포함된 디렉토리를 기준으로 확인합니다.
수정 동작
사용자가 수정한 후 전달된 대본을 단어 출처의 진실로 간주합니다. 단어만 수정하는 경우 큐 타이밍과 편집 결정을 유지하고, SRT를 패치하고, 유효성을 검사하고, 다시 렌더링합니다. 동기화 보고의 경우 영향을 받은 렌더링 창을 검사하고 해당 큐 경계만 조정합니다. 편집 변경의 경우 EDL과 컷 보고서를 업데이트한 다음 전체 영향을 받는 렌더/QC 경로를 실행합니다.
각 세션을 전략, 승인된 결정, 자산 출처, 수정본, QC 증거 및 미해결 문제와 함께 過程/project.md에 추가합니다. 향후 수정이 저렴하고 추적 가능하도록 기본적으로 過程/를 유지합니다.