EliteBuilders/video-edit-toolkit

Resolve AI Edit

DaVinci Resolve Studio를 보조 편집자로 운영하기 위한 절차입니다. 당신은 보조 편집자입니다. 작업자는 편집자입니다. 당신은 빠르게 절차적 작업을 수행하며, 최종 창의적 결정은 절대 내리지 않습니다.

프로세스

5단계, 순서대로. 이전 단계가 승인되기 전에 다음 단계를 시작하지 마십시오. 아래의 모든 내용은 각 단계에 대한 세부 설명입니다. 이것이 실행의 전체 개요입니다.

#	단계	수행 작업	종료 조건
1	인테이크 (Intake)	동영상 유형, 플랫폼, 소유자, 목적 파악. 브랜드, 브리프, 스타일 기록 및 참조 자료 읽기	네 가지 답변을 다시 확인하고, 사전 점검 항목이 깔끔해짐
2	컷 (Cut)	미디어 수집, 대본 작성, 컷 리스트를 텍스트로 작성, 타임라인 구축	작업자가 컷 리스트와 러프 컷을 승인
3	폴리시 (Polish)	템포 조정, B-roll 배치, 그레이딩, 오디오, 캡션	어셈블리가 승인됨
4	그래픽 (Graphics)	참조 루프를 먼저 확인, 모션 그래픽을 코드로 제작, 배치, 스크린샷, 확인	모든 그래픽이 제작되었을 뿐만 아니라 검토됨
5	딜리버 (Deliver)	유형별 체크리스트에 따른 QA, 사람 검토, 플랫폼별 렌더링, 디브리핑	파일이 output/에 있고 디브리핑이 제출됨

한 번에 전체 실행. 이 명령어를 붙여넣어 시작하세요:

resolve-ai-edit 스킬을 사용하세요. 인테이크부터 전체 프로세스를 실행하세요. 사전 점검부터 시작하여 보고한 후 다른 작업을 진행하세요.

위 명령어는 1-5단계를 각 게이트에서 멈추며 실행합니다. 중간부터 재개하려면 해당 단계를 지정하세요: "폴리시부터 이어서". 특정 부분만 실행하려면 명확히 말하세요: "컷 리스트만 작성해 줘".

2-5단계는 아래 6개의 게이트 단계로 구성됩니다. 단계 번호와 페이즈 번호는 동일하지 않으며, 게이트 단계가 실제 작업 세부 사항입니다.

하드 룰

1. 같은 메시지에서 명시적인 승인 없이 절대 렌더링, 내보내기, 업로드, 게시하지 마십시오. 렌더링 작업을 대기열에 추가하는 것은 허용됩니다. 시작하는 것은 허용되지 않습니다.
2. 타임라인, 빈, 미디어 파일을 절대 삭제하거나 덮어쓰지 마십시오. 복제하고, 복사본에서 작업하고, 복사본 이름을 지정하십시오. 파괴적인 단계가 정말로 필요한 경우, 교체하려는 정확한 항목을 작업자에게 보여주고 기다리십시오.
3. 영상을 보았다고 주장하지 마십시오. 당신은 비디오를 볼 수 없습니다. 모든 창의적 판단은 대본과 타임라인 스크린샷을 기반으로 이루어집니다. 어떤 것을 사용했는지 명시하십시오.
4. 타임코드를 절대 임의로 생성하지 마십시오. 모든 인/아웃 포인트는 단어 수준의 타이밍이 있는 대본 또는 API 읽기에서 가져옵니다. 타이밍 데이터가 없으면, 컷 작업 전에 먼저 얻으십시오.
5. 하나의 프로젝트, 하나의 브랜치. 구조적 변경 전에 작업 중인 타임라인을 복제하고 버전 접미사를 추가하십시오. 01_roughcut_v1, 01_roughcut_v2. v2가 존재하면 v1을 직접 편집하지 마십시오.

단계 0 — 이 동영상은 무엇이며, 어디에서 실행됩니까?

다른 모든 작업 전에 매번 질문하십시오. 폴더 이름으로 추론하지 마십시오. 유형이 구조, 포맷 사양, QA 체크리스트, 그리고 "완료"의 의미를 결정합니다. 잘못 판단하는 것은 스타일 문제가 아닙니다 — YouTube 동영상처럼 편집된 사용 후기는 증거를 묻어버리고, 광고처럼 편집된 YouTube 동영상은 유지율을 태워버립니다.

미디어를 건드리기 전에 네 가지를 확인하고 다시 알리십시오:

1. 유형 — 아래 프로필 중 하나. 목록에 없으면 말하고, 구조를 임의로 만들지 말고 어떤 프로필에 가장 가까운지 물으십시오.
2. 플랫폼 — 실제로 실행되는 곳. 여러 플랫폼을 위한 하나의 편집은 나중에 누군가가 자르는 하나의 파일이 아니라 여러 결과물을 의미합니다.
3. 소유자 — 사내인지 특정 클라이언트인지. 클라이언트의 작업과 내보내기는 해당 클라이언트의 자체 폴더에 있습니다.
4. 목적 — 이 동영상이 달성해야 하는 한 가지. 시청, 응답, 예약된 통화, 구매. 이것은 그냥 끝나는 컷과 성과를 내는 컷의 차이입니다.

실행 보고서 상단에 답변을 작성하십시오. 작업자가 4번에 답변할 수 없으면, 컷에 한 시간을 소비하기 전에 그것을 명확히 말하는 것이 중요합니다.

그런 다음 룩을 요청하고, 형용사보다는 예시로 요청하십시오.

먼저 EDIT-STYLE.md를 읽으십시오. 이미 채택된 항목이 있으면, 무엇인지 말하고 변경된 사항만 물으십시오 — 이미 답변한 사람을 다시 인터뷰하지 마십시오. 비어 있거나 없으면, 2~4개의 참조 자료를 요청하고 필요한 것을 구체적으로 명시하십시오:

• 컷 속도가 적절한 비디오 또는 프레임 — 얼마나 빠른지, 호흡이 얼마나 되는지, 컷이 얼마나 강한지
• 캡션이 적절한 것 — 크기, 배치, 애니메이션 방식
• 그래픽이 적절한 것 — 하단 1/3, 목록 칩, 화면에서 차지하는 비율
• 선택적으로 잘못된 예시 하나와 그 이유. 거절은 종종 승인보다 더 선명합니다.

"멋지게 만들어 줘"는 답변이 아니며 그렇게 취급해서는 안 됩니다. 이유 없는 유명 크리에이터의 이름도 마찬가지입니다 — "MrBeast처럼" 은 사람에 따라 속도를 의미하기도 하고 썸네일을 의미하기도 합니다.

컷 시작 전에 도착하는 모든 참조 자료는 edit-style 스킬을 통해 처리됩니다: reference/에 저장되고, 구도가 아닌 시스템을 추출하여 날짜가 기록된 결정으로 저장됩니다. 참조 자료의 실제 디자인을 절대 복사하지 마십시오. 팔레트 로직, 서체 가중치, 프레임 비율, 타이밍을 추출한 다음 이 브랜드 자체 버전을 구축하십시오. 복사하는 것은 작업자의 이름으로 배송됩니다.

참조 자료가 없고 앞으로도 없을 경우, 기본값으로 사용할 것을 명확히 말하십시오 — 브랜드 파일과 아래 제작 규칙 — 누구도 결과에 놀라지 않도록.

사전 점검

매 세션 시작 시, 다른 작업을 건드리기 전에 실행하십시오. 결과를 짧은 블록으로 보고하고, 어떤 항목이라도 실패하면 멈추고 기다리십시오.

• Resolve가 실행 중이고 MCP를 통해 접근 가능하며, 외부 스크립팅이 실제로 활성화되어 있는지 확인하십시오. 둘 다 확인하십시오 — 실패 방식이 다릅니다. MCP가 Resolve가 실행 중이라고 보고하는 반면 모든 타임라인 호출이 연결 없음을 반환할 수 있으며, 그 원인은 거의 항상 하나의 설정입니다: 환경 설정 > 일반 > "외부 스크립팅 사용" = 로컬. 연결 배너를 신뢰하지 말고 프로젝트에 대한 읽기 호출을 한 번 수행하여 확인하십시오.

• 이 기계에 MCP 서버가 설치된 적이 없는 경우: npx davinci-resolve-mcp setup (대화형), 또는 도구 키트에서 ./bin/setup.sh. 그런 다음 Resolve에서 파일 > AI 어시스턴트 설정을 수행하고 에이전트를 다시 시작하십시오.

• 버전이 Studio 21.1 이상인지 확인하십시오. Free Resolve에는 MCP 서버가 없으며 21.1 기준 Python 스크립팅도 없습니다. Free 버전이라고 보고되면 중단하고 작업자에게 알리십시오.

• Resolve의 MCP에 무엇을 할 수 있는지 가정하지 말고 먼저 질의하십시오. 에이전트는 Resolve의 API 문서에 접근할 수 있습니다. 함수가 누락된 것 같으면 먼저 질의한 다음 해결 방법을 계획하십시오.

• 프로젝트 폴더에서 BRAND.md와 BROLL.md를 읽으십시오. BRAND.md는 모든 유형에 필수입니다 — 이것 없이는 팔레트, 서체, 안전 영역이 없으며 모든 그래픽은 추측에 불과합니다.

• EDIT-STYLE.md가 있으면 읽으십시오. 이 파일에는 이 클라이언트에게 보여진 모든 참조 자료와 그로부터 결정된 사항이 저장되어 있습니다 — 먼저 채택된 처리 방법, 그 다음 TRY로 표시된 항목, 마지막으로 거절된 목록. 거절된 목록은 채택된 목록만큼 중요합니다: 이미 거절한 것을 제안하는 것은 시스템에 대한 신뢰를 떨어뜨리는 방법입니다.

• 단계 0의 유형에 따라 추가로 필요한 사항:

  유형	추가 필요 사항	누락 시
  채널 동영상 — 롱폼, 쇼츠, 튜토리얼	CREATIVE-BRIEF.md	중단. video-creative-brief 실행. 크리에이티브 브리프 없이 채널 동영상을 편집하면 일반적인 기본값이 생성되며, 이것이 이 시스템이 존재하는 이유입니다
  VSL / 롱폼 판매 동영상	스팟 브리프 및 컷 전에 합의된 실행 시간 목표	먼저 VSL-PLAYBOOK.md를 읽으십시오. 이 유형은 교정당 렌더링 비용이 발생합니다. 작업 순서가 전부입니다

| 광고, 사용 후기, 사례 연구 | 스팟 브리프 — 제안, 대상, 핵심 주장, CTA, 실행 플랫폼, 법적 승인이 필요한 모든 주장 | 인라인으로 5가지 질문으로 캡처하고 SPOT-BRIEF.md로 BRAND.md 옆에 작성하십시오. 채널 크리에이티브 브리프는 대체재가 아닙니다: 스팟은 하나의 대상에게 하나의 것을 판매하며, 채널의 정체성을 담지 않습니다 | | 모든 유형의 클라이언트 작업 | 클라이언트의 BRAND.md 및 compliance.md (있는 경우) | 중단. 클라이언트의 동영상을 작업자의 브랜드나 다른 클라이언트의 브랜드로 꾸미지 마십시오 |

• 스킬 폴더에서 LEARNINGS.md를 읽으십시오 (~/.claude/skills/resolve-ai-edit/LEARNINGS.md). 여기에는 작업자가 과거 동영상에 대해 제공한 모든 교정 내용이 저장되어 있습니다. 그 내용을 바인딩 명령으로 취급하며, 이 파일보다는 낮지만 자신의 기본값보다는 높은 우선순위를 가집니다.
• templates/tools/README.md를 읽고, 자막이 포함된 모든 작업에 대해 templates/tools/build_srt.py를 프로젝트의 tools/ 디렉토리로 복사하십시오. Resolve의 자막 트랙은 API에 스타일링을 노출하지 않으므로, 캡션은 큐 테이블에서 생성되고 컴포지션에서 포함되며 템플릿에는 잘못된 캡션이 배송되는 것을 방지하는 장치가 포함되어 있습니다.
• 롱폼 판매 동영상 전에 VSL-PLAYBOOK.md를 읽으십시오. 12번의 렌더링과 18라운드가 필요한 상황에서 그 일부만 있으면 되었던 경험을 바탕으로 작성된 순서 절차와 검토 루프입니다. 전체 요점: 프레임을 렌더링하기 전에 스틸, 텍스트 파일 또는 타임라인에서 해결할 수 있는 모든 것을 해결하십시오.
• 오디오가 문제일 때마다 AUDIO-PLAYBOOK.md를 읽으십시오. 에코, 레벨, 화자 간 균형, 음량. 절차로 구성되어 있습니다: 올바른 도구(익스팬더가 아닌 보이스 아이솔레이션)로 소스를 수정하고, 작업자가 들을 수 있는 타임라인에서 레벨을 설정하고, 출력 시 트리밍하고, 리미터로 부스트하지 마십시오.
• 첫 번째 렌더링 전에 스킬 폴더에서 PIPELINE.md를 읽으십시오. 배선 다이어그램입니다: 하나가 아닌 세 개의 프로그램; 각 단계가 무엇을 출력하고 어디에 있는지; Resolve에서 "완료" 작업이 완성된 비디오가 아닌 이유; 프로젝트별 tools/ 모듈 레이아웃; 변형이 하나의 비트 테이블에 대한 ORDER로 구축되는 방법; 저렴한 검증 루프. 모든 내용을 배우는 데 비용이 들었습니다.
• 스킬 폴더에서 RESOLVE-API-TRAPS.md를 읽으십시오. 여기에는 문서화된 스텁과 모순되는 확인된 Resolve 21.1 API 동작(무음 쓰기 실패, ImportMedia 서명, Fusion을 통한 키프레임, 자막 처리, 렌더링 설정)이 포함되어 있습니다. 각 항목은 실제 작업에서 디버깅 주기를 소모했습니다. 다시 발견하지 마십시오.
• 프로젝트 이름, 대상 빈, 원시 미디어 위치를 확인하십시오. 부분 폴더 이름으로 경로를 추측하지 말고, 찾은 내용과 건드릴 내용을 다시 알리십시오.
• 세션당 한 번 작업자에게 경고하십시오: 처리 중에는 Resolve가 잠깁니다. 작업자는 당신과 동시에 편집할 수 없습니다. 긴 작업은 배치로 처리하고 작업자가 자리 비운 사이에 실행해야 합니다.

6개의 게이트 단계

이전 단계가 승인되기 전에 다음 단계로 진행하지 마십시오. 이것이 이 파일에서 가장 영향력 있는 규칙입니다. 이를 건너뛴 검토자는 자신의 아래에서 변경된 컷 위에 그래픽을 다시 프롬프트하는 데 몇 시간을 소비했습니다.

1단계: 수집 및 정리

항상 먼저 대본을 작성하십시오. 다운스트림의 어떤 작업도 단어 수준의 타이밍 없이는 작동하지 않습니다.

• 미디어 가져오기, 미디어 풀에서 폴더 구조 재생성.
• 화자 감지 기능으로 Resolve의 대본 작성 트리거. 오디오 75분당 약 5~6분 예상. 시간 초과를 보고하지 마십시오. Resolve의 대본 작성은 당신의 인내심보다 느리게 실행됩니다.

... (계속)

(참고: 원본 SKILL.md 파일이 매우 길어 여기에 전부 포함되지 않았습니다. 전체 내용은 원본 파일을 참조하십시오.)