Music MV / 음악 MV

뮤직 MV

사용자素材를 2D 핸드 드로잉 MV로 편성하여 연기, 가사 동기화 및 전환 효과를 포함한 재생 가능한 MP4를 제공합니다. 내장된 painted-animation의 p5.js + p5.brush 엔진, 예제 및 Windows 패키지를 사용합니다. 다른 설치된 스킬이나 외부 비디오 생성 API에 의존하지 않습니다.

현재 사용자 매개변수:

$ARGUMENTS

요청 분석

중국어 자연어 또는 key=value 형식을 허용합니다. 필수 항목: 캐릭터 이미지 image, 노래 audio, 가사 lyrics, 시작 start, 종료 end, 스타일 style. 경로에 공백이 있을 경우 따옴표를 지원합니다. 시간은 초, M:SS 또는 H:MM:SS 형식을 허용합니다. 누락된 항목이 있으면 한 번에 나열합니다. 이미 알고 있는 정보는 다시 묻지 않습니다.

기본값: 1920×1080, 24fps, 행 단위 가사, 이미지에서 명확하게 구분되는 모든 캐릭터를 포함, 출력은 현재 프로젝트의 outputs/music-mv 아래 새 디렉토리로 지정합니다. 사용자가 단일 주인공, 자막 없음, 다른 프레임 속도를 지정하면 그에 따라 처리합니다. 복잡한 캐릭터 그림의 경우 먼저 모델 테이블을 정의하고 테스트 프레임을 그립니다. 이미지는 신원 및 스타일 참조용이며, 단순한 텍스처 이동이나 정적 슬라이드쇼로 사용할 수 없습니다.

스타일이 '작은 마을 소녀'인 경우 references/styles.md를 읽고 assets/painted-animation/docs/xiaozhen-sheet.jpg를 확인합니다. 이 이름은 예제의 수채화 종이, 먹선, 프레임 제한 연기, 가사 이미지 및 일관된 전환을 나타내며, 원곡의 스토리를 그대로 복사하지는 않습니다. 다른 스타일은 구현 가능한 2D 회화 언어에 매핑됩니다. 사실적인 실사 또는 3D 요구 사항이 있는 경우 먼저 이 엔진의 한계를 설명합니다.

제작

1. 세 개의 입력 파일을 확인하고 캐릭터 이미지를 검사합니다. 먼저 간단한 계획(캐릭터, 스토리 라인, 화면 스타일, 파일 위치)을 출력합니다. 프로젝트의 기존 승인 요구 사항을 준수합니다. 사용자가 전체 생성을 승인한 경우 완성된 영상까지 계속 제작하고, '스토리보드 우선 보기' 모드인 경우에만 스토리보드 이후에 중단합니다.
2. assets/painted-animation/template/ANIMATION_GUIDE.md 및 references/production.md를 읽습니다. 음악 편성에 필요할 경우 references/music-video.md를 읽습니다. 마디별 확장 제안은 사용자의 정확한 잘라내기 구간을 덮어쓸 수 없습니다. 모드가 '스토리보드 우선 보기'인 경우 이미지와 가사만 읽고 박자를 측정하여 스토리보드를 작성합니다. 엔지니어링 설치, 장면 제작 및 렌더링은 건너뛰고 스토리보드 전달 후 중단합니다.
3. 파일 도구를 사용하여 정규화된 JSON을 현재 프로젝트의 .cache/music-mv-request.json에 씁니다. output에는 현재 프로젝트 내에 존재하지 않는 절대 경로를 제공해야 합니다. 스크립트를 사용하여 素材 및 프로젝트를 준비합니다:

   python "${CLAUDE_SKILL_DIR}/scripts/prepare_mv.py" --request "<요청 JSON 절대 경로>" --install
   

   Windows 종속성, 캐시 및 브라우저는 references/windows.md를 참조하십시오. 보조 스크립트는 프로젝트만 준비하며, 장면은 여전히 사용자가 제작합니다.
4. 생성된 mv-task.json, analysis/lyrics.json을 읽고 BPM과 beat_offset을 확인합니다. 감지 실패 시 종속성을 수정하고 측정하거나 사용자가 제공한 BPM을 사용합니다. 추정값을 측정값으로 사용할 수 없습니다. 지정된 오디오 범위를 유지하며, 임의로 인트로를 추가하거나 템포를 변경하거나 페이드 아웃하지 않습니다. 일반 LRC는 행 단위 시간만 제공하며, 가사 색칠은 행 내 추정값이므로 단어 단위 정확도를 주장할 수 없습니다.
5. 완전한 STORYBOARD.md를 작성합니다: 각 컷의 시간, 가사, 동작, 구도, 전환. src/scenes 내에 장면 파일을 생성하고 studio.html에 등록합니다. 데모 장면을 제거합니다. 캐릭터는 표정, 준비 동작, 무게 중심 변화, 후속 동작 및 읽기 쉬운 연기를 가져야 합니다. 각 프레임은 시간 t의 순수 함수여야 합니다.
6. scripts/render_mv.mjs를 사용하여 각 컷의 대표 프레임, 동작 막대 및 이음새를 렌더링하고, 이미지를 열어 확인 및 수정합니다. 자막이 없는 경우 studio.html에서 karaoke.js 로드를 제거합니다.
7. 전체 비디오를 렌더링합니다. 캡슐화는 지속 시간, 크기, 프레임 속도 및 오디오 트랙을 확인합니다. 시작, 끝 및 모든 전환을 확인한 후 MP4, 스토리보드 및 미리보기 이미지의 실제 절대 경로를 전달합니다. 장면을 수정한 후 영향을 받는 프레임을 다시 렌더링하고, 이전 프레임을 재사용하지 않습니다. 열지 않은 미리보기 또는 재생/확인되지 않은 비디오로 품질이 확인되었다고 주장할 수 없습니다.

기본 순서: 素材 확인 → 스토리보드 → 장면 제작 → 미리보기 수정 → MP4. 정상적인 단계 사이에 반복적으로 승인을 요청하지 않습니다. 사용자가 명시적으로 요청한 경우에만 하위 에이전트를 사용합니다.

호출 예시

/music-mv 캐릭터="D:/mv/character.png" 노래="D:/mv/song.mp3" 가사="D:/mv/song.lrc" 잘라내기="00:39-01:07" 스타일="작은 마을 소녀"

추가 가능: 캐릭터 모드=주황색 주인공만, 자막=없음, 모드=스토리보드 우선 보기. 이미지에 여러 명의 명확하게 구분되는 캐릭터가 있는 경우 기본적으로 모두 포함되며, 계속해서 완성된 영상까지 제작합니다.

출처 및 라이선스는 references/credits.md를 참조하십시오.