Akira-TL/akira-video-skills

Akira Video

akira-video는 Akira Video Skills의 Primary Router입니다. 비디오 제작 진입점, VIDEO.md, 현재 제작 작업 판단, 전문 Skill 라우팅 및 중지 경계를 담당합니다. 구체적인 비디오 스크립트, 재사용 자산, 샷, 생성 패키지, 리뷰 및 전체 편집 방법은 해당 전문 Skill이 담당합니다. 전체 프로젝트의 의존성 및 인간-기계 인계는 references/workflow/PRODUCTION-FLOW.md를 따릅니다. 기존 프로젝트는 현재 실제 작업에서 바로 이어서 진행하며, 이전 단계를 기계적으로 다시 실행하지 않습니다.

전체 제작은 항상 다음 우선순위를 보호합니다: 사용자 및 출처 사실 → 스토리/샷 의도(해당 시) → 캐릭터/객체 정체성 및 구조 → 제품 사실(광고 시) → 공간 및 시간 연속성 → 화면 미학 → 기술적 과시. 구체적인 계층, 충돌 시 역추적 및 "채택된 결과 실제 출력" 예외는 references/workflow/AUTHORITY.md를 따릅니다. 이후의 목표는 이전의 제약 조건을 위반하는 대가로 달성될 수 없습니다.

1. 프로젝트 진입 또는 인수

먼저 프로젝트 루트 디렉토리의 VIDEO.md를 읽습니다. 파일이 없으면 references/project/PROJECT-LAYOUT.md에 따라 최소한의 비디오 프로젝트를 생성합니다. 프로젝트 정의 및 현재 상태는 references/project/VIDEO-HOME.md를, 명명 규칙은 references/project/NAMING.md를 따릅니다. 현재 실제로 필요한 디렉토리와 파일만 생성하고, 빈 분류 디렉토리를 미리 생성하지 않습니다. 처음으로 일회성 생성 패키지가 필요할 때 대상 프로젝트의 .gitignore에 .tmp/ 디렉토리가 포함되어 있는지 확인합니다.

사용자가 기존 이미지, 비디오, 오디오, 러프 컷 또는 참조 완성본을 제공한 경우, 먼저 references/project/IMPORT-MEDIA.md에 따라 현재 프로젝트에서의 실제 용도를 판단합니다. 직접 재사용할 수 있는 결과물은 디자인 또는 생성 프로세스를 강제로 다시 거치지 않습니다.

그런 다음 현재 작업에 따라 필요한 최소한의 내용을 읽습니다:

• 비디오 스크립트 및 샷 개요: video/script/
• 샷 간 재사용 콘텐츠: video/materials/
• 현재 샷: video/shots/<shot-id>/
• 전체 편집 후반 작업에 진입한 경우: video/edit/
• 원작 소설, 챕터, 브랜드 자료 또는 기타 출처: 현재 프로젝트의 실제 포인터를 따라 읽으며, 출처 사실을 복사하여 두 번째 사본을 만들지 않습니다.

완료 기준: 현재 비디오 목표, 전달 요구 사항, 진행 중인 제작 콘텐츠, 기존 재사용 가능 자산, 현재 샷/후반 작업 상태 및 실제 차단 항목을 설명할 수 있어야 합니다.

다음 고비용 제작 단계로 진입하기 전에 references/workflow/PRODUCTION-GATES.md에 따라 현재 프로젝트에 적용 가능한 가벼운 게이트만 실행합니다. 게이트는 추가 프로젝트 상태 파일을 생성하지 않습니다. 현재 프로젝트가 너무 커서 펼쳐 보기 어렵거나 창의적인 버전을 동시에 비교해야 하는 경우에만 references/project/SCALING-VERSIONS.md를 읽고, 장편 영화 디렉토리를 미리 가정하지 마십시오. 실패한 결과, 일회성 패키지, 캐시 또는 이전 미디어를 정리해야 하는 경우 references/project/MEDIA-LIFECYCLE.md에 따라 먼저 파일이 유일한 입력, 현재 채택된 결과 또는 후반 작업의 유일한 의존성이 아님을 확인합니다.

중요한 제작 결정을 기록하는 방법, VIDEO.md를 업데이트하는 시점, 채택된 샷 결과를 SHOT.md에만 기록하는 이유는 references/project/RECORDING.md를 따릅니다. 채팅 기록과 일회성 생성 패키지는 장기 프로젝트 기록이 아닙니다.

2. VIDEO.md 유지보수

VIDEO.md는 사람과 다음 에이전트가 직접 읽을 수 있는 비디오 제작 홈페이지이며, 현재 유용한 정보만 보관합니다. 항상 다음 사항에 집중합니다:

• 프로젝트 및 비디오 목표
• 전달 요구 사항
• 현재 제작 진행 상황
• 현재 진행 중인 작업
• 차단 항목
• 여전히 후속 작업에 영향을 미치는 주요 결정
• 비디오 스크립트, 재사용 자산, 샷 및 전체 편집에 대한 탐색

일반 프롬프트 기록, 모든 생성 결과, 생성 로그 및 이미 Git 기록으로 대체된 이전 결정은 VIDEO.md에 포함되지 않습니다.

자세한 작성 방법은 references/project/VIDEO-HOME.md를 참조하십시오.

3. 전문 작업 라우팅

사용자의 현재 목표와 기존 프로젝트 콘텐츠에 따라 다음 실제 제작 작업을 선택합니다. 완전한 프로젝트가 모든 기능을 기계적으로 거칠 필요는 없습니다. 이미 스크립트가 있으면 바로 샷으로 들어갈 수 있고, 샷과 자산이 있으면 바로 생성 패키지를 준비할 수 있으며, 생성 결과가 반환되면 바로 리뷰 단계로 들어갈 수 있습니다.

현재 작업에 따라 정식 Skill을 로드합니다:

• 소설, 챕터, 브리프 또는 기타 상위 콘텐츠에서 비디오 스크립트, 캐릭터 연기, 장면 또는 샷 개요를 작성/수정해야 함 → video-script
• 캐릭터 또는 장면이 기능적 설명만 있고 구체적인 외형/의상/재질/공간/조명 디자인이 아직 없는 경우 → video-design
• 캐릭터가 샷 간에 일관된 음색, 사운드 레퍼런스가 필요하거나 프로젝트에서 대화 사운드, 앰비언스, 사운드 효과 및 전체 비디오 사운드 경계를 계획해야 하는 경우 → video-audio
• 샷 간에 재사용할 캐릭터, 장면, 소품, 제품 프롬프트 및 참조 자산을 계획하거나 유지보수해야 하는 경우 → video-materials
• 샷 개요를 SHOT.md로 확장하고, 액션, 카메라, 사운드 및 인접 샷과의 연속성을 처리해야 하는 경우 → video-shot
• 현재 생성 프롬프트를 작성하고, 최소 참조 세트를 선택하고, 일회성 생성 패키지를 정리하고, 사용자 생성 결과를 다시 가져와야 하는 경우 → video-generation
• 사용자가 이미지나 생성 결과를 가져온 후 채택, 후속 조정, 후반 수정, 재생성 또는 재작성을 결정해야 하는 경우 → video-review
• 여러 채택된 샷이 Premiere Pro, After Effects, DaVinci Resolve 등의 전체 편집 도구로 넘어가는 경우 → video-editing
• 동일한 비디오에 여러 언어의 자막, 내레이션, 더빙 또는 공식 완성 버전이 필요한 경우 → 먼저 references/workflow/LOCALIZATION.md를 읽고, 번역 콘텐츠는 video-script에, 사운드는 video-audio에, 자막/그래픽/최종 내보내기는 video-editing에 위임하며, 전체 프로젝트를 복사하지 않습니다.
• 브랜드, 제품 PPL 또는 광고에 제품 기능, 구조, 공식 자산 및 광고 표현 경계에 대한 검증이 필요한 경우 → 필요 시 선택적 video-advertising를 로드합니다. 현재 Target에 설치되지 않은 경우 명시적인 coordinator akira-tl/akira-video-skills/video-advertising를 사용하여 akira Router / Skiloom에 전달하여 후보 계획(Candidate plan)을 생성하고 승인 후 설치합니다.

Router는 위의 책임 요약만 유지합니다. 분기 중 하나에 진입하면 실제 로드된 권위 있는 Skill이 해당 전문 방법의 유일한 권위 있는 출처가 됩니다.

대상이 비디오 모델별 어댑터를 필요로 하는 경우, 먼저 references/workflow/MODEL-ADAPTERS.md를 읽고 현재 저장소에서 사용 가능한 최소 어댑터 패키지를 선택합니다. 아직 설치되지 않은 경우 명시적인 coordinator를 akira Router / Skiloom에 전달하여 정상적으로 후보 계획(Candidate plan)을 생성하고 설치합니다. 모델 매개변수나 공급업체 세부 정보를 akira-video에 하드코딩하지 마십시오. 이미지 생성은 현재 video-design + video-materials의 일반 규칙을 사용하며, 별도의 이미지 모델 어댑터를 유지보수하지 않습니다.

외부 생성이 사용자에게 넘어가고, 세션을 걸쳐 대기해야 하는 경우 references/workflow/WAITING-RESUME.md에 따라 VIDEO.md에 생성 패키지 경로, 예상 반환, 다음 단계 및 실제 차단 항목만 기록합니다. 다음 세션에서는 기존 패키지/반환 결과를 우선 복구하며, 세션이 변경되었다고 해서 패키징을 반복하지 않습니다.

4. 외부 생성의 인간-기계 경계

기본적으로 사용자가 외부 이미지/비디오 모델에서 실제 생성을 수행하도록 허용합니다. 외부 생성이 필요한 경우, 전문 생성 Skill이 공식 프로젝트 콘텐츠에서 일회성 생성 패키지를 정리합니다:

공식 프로젝트 콘텐츠 → .tmp/ 일회성 생성 패키지 → 사용자 외부 생성 → 결과 반환 → 공식 디렉토리로 아카이브 → 임시 패키지 삭제

일회성 생성 패키지는 파생물이며 장기 프로젝트 사실의 출처가 되지 않습니다. 장기 프롬프트는 해당 자산 또는 샷 디렉토리에 남아 있으며, 임시 패키지는 현재 생성에 실제로 필요한 콘텐츠만 복사합니다.

5. 재라우팅 및 중지 경계

전문 Skill이 경계가 명확한 작업을 완료할 때마다:

1. 반환된 공식 자산, 생성 결과, 샷 결정 또는 전체 편집 프로젝트를 해당 디렉토리에 아카이브합니다.
2. 여전히 제작에 영향을 미치는 VIDEO.md를 업데이트합니다.
3. 사용자 목표와 현재 산출물에 따라 다음 제작 작업을 결정합니다.

사용자가 범위를 제한한 작업이 완료되었거나, 다음 단계가 사용자의 외부 생성 또는 자산 제공을 기다려야 하거나, 실제 차단 항목이 있거나, 현재 전달이 완료된 경우에만 중지합니다. 사용자의 외부 생성을 기다리는 경우 일회성 생성 패키지와 반환 명명 요구 사항을 명확히 제시하고, 이미 자산이 생성된 것처럼 계속 진행하지 않습니다.