Kelly MV
앱 UI 스크린샷
핵심 아이디어
이 스킬을 뮤직비디오 창작 워크스페이스로 사용하세요. 앱은 인간이 편집하는 표면이고, 스킬은 창작 프로듀서입니다. 즉, 추론하고, 초안을 작성하고, 검증하고, 내보내고, AI 생성 프롬프트를 준비합니다. 앱은 로컬 프로젝트 파일만 읽고 씁니다.
여기서 MV는 순수 그림입니다 — 나레이션, 대사, 화면 내 가사가 없습니다. 작업은 간단합니다: 기존 MP3를 가져와 시각 자료를 입히는 것입니다. 최종 비디오는 스토리보드 샷을 노래에 맞춰 순서대로 재생한 것입니다. (대사/나레이션이 있는 드라마는 kelly-drama를 사용하세요 — 그것이 그 작업을 담당합니다.)
앱에는 정확히 네 가지 영역이 있습니다: 개념, 노래, 캐스트, 스토리보드. 이를 간단하게 유지하세요 — 노래 섹션, 타임라인 타일, 또는 샷별 대형 프로덕션 시트를 다시 도입하지 마세요.
지속적인 창작 작업에는 로컬 앱을 기본으로 사용하세요. 사용자가 명시적으로 "채팅 전용", "UI 없음", "순수 채팅" 등을 요청하는 경우에만 채팅 전용 모드를 사용하세요.
기본 흐름
app/start.sh로 로컬 앱을 시작하거나 재사용합니다 (기본값127.0.0.1:3041;KELLY_MV_UI_PORT환경 변수 존중).app/.data/project.json을 확인합니다. 파일이 없으면 서버가 번들된 스타터(정야사 샘플 MV)를 시드합니다.scripts/create_sample_project.ts로 다시 시드할 수도 있습니다.- 앱을 사용하여 사이드바의 다음 단계를 따릅니다:
- 개념: MV가 무엇인지와 그 분위기를 한 줄로 요약하고, 시각적
look한 줄, 종횡비. 이것이 전부입니다. - 노래: MP3를 업로드합니다. 지속 시간은 자동으로 읽힙니다. 선택적 제목/아티스트. 그 외에는 없습니다.
- 캐스트: 화면에 등장하는 사람들. 안정적인 ID, 역할, 세 방향 시각적 노트, 의상, 앵커, 금지된 표류, 그리고 캐릭터 참조 카드 이미지. 일관성이 중요할 때 스토리보드 작업 전에 참조 카드를 생성하세요. 음성 프로필은 없습니다 (순수 시각 MV). kelly-drama와 동일한 모델.
- 스토리보드: 순서가 있는 샷 목록. 각 샷에는 장면 설명, 화면 내 캐릭터, 지속 시간, 이미지 + 비디오가 있습니다. 이미지와 비디오는 각각 AI 생성 (캐릭터 카드에서 이미지-투-이미지; 로컬 LTX를 통한 초안 비디오) 또는 사용자 업로드일 수 있습니다.
- 개념: MV가 무엇인지와 그 분위기를 한 줄로 요약하고, 시각적
- 편집 후 생성 전에
scripts/validate_ui_schema.ts(구조)와scripts/validate_shot_readiness.ts(각 샷에 제목, 설명, 합리적인 지속 시간이 있는지)를 실행하세요. - 읽기 쉬운 개념 + 샷 리스트를
scripts/export_story_bible.ts로 내보내어 인계하세요.
창작 운영 규칙
- 순수 시각. 대화 오디오, 나레이션 TTS, 또는 화면 내 자막/가사를 절대 추가하지 마세요. 유일한 오디오는 노래 자체입니다.
- 간단하게 유지하세요. 샷은 장면 설명 + 캐릭터 + 지속 시간 + 이미지 + 비디오일 뿐입니다. 카메라 사양 시트, 노래 섹션 분류, 가사 타임라인, 또는 엄격한 타임라인 커버리지 규칙을 추가하지 마세요.
- 음악에 맞춰 속도를 조절하세요. 샷 길이를 노래에 맞게 자르세요 — 빠른 순간은 짧게 (4–6초), 확립/히어로/몽타주는 길게 (8–12초). 단일 AI 생성 샷은 4, 5, 6, 8, 10, 또는 12초여야 하며 12초를 초과할 수 없습니다. (업로드된 클립은 모든 길이 가능.)
- 샷을 채우는 두 가지 방법. 각 샷의 이미지와 비디오는 생성되거나 업로드될 수 있습니다 — 둘 다 비파괴적 후보로 추가되며 사용자가 활성 항목을 선택합니다. 사용자가 원하는 것을 존중하세요; 업로드된 에셋을 재생성하여 덮어쓰지 마세요.
- 실제 이미지-투-이미지로 캐릭터 일관성 유지. 스토리보드 이미지 생성은 기존 캐릭터 참조 카드 이미지를 이미지
/images/edits엔드포인트에 실제 입력 픽셀로 전달하며, 단순 텍스트가 아닙니다. 캐릭터에 생성된 참조 카드가 없으면 해당 샷은 텍스트-투-이미지로 대체되며 닮음이 표류합니다 — 먼저 카드를 생성하세요. - 의존성 순서로 생성: 노래 업로드 → 개념 작성 → 캐스트 참조 카드 → 스토리보드 이미지 → 샷 비디오 초안. 샷의
description이 이미지 프롬프트입니다. 선택적negative_prompt와video_prompt가 생성을 개선합니다. - 포토리얼 MV 룩 (현실감이 목표일 때): 시네마틱 뮤직비디오 스틸, 실제 렌즈 효과, 필름 그레인을 요청하세요; 화면 내 가사/캡션/워터마크/UI, 읽을 수 있는 가짜 텍스트, 플라스틱 피부, 잘못된 손을 금지하세요.
노래 생성 (향후 기능)
기존 노래를 선택/가져오는 것이 현재 지원되는 경로입니다. 노래 자체를 만드는 것 — 사용자의 클론된 음성으로 노래하는 것을 포함 — 은 문서화된 스텁(POST /api/song-generate → scripts/gen_song.py)으로 연결되어 있으며, 비디오에 사용된 로컬 초안 / 클라우드 프로덕션 분할을 미러링합니다.
권장 로컬 백엔드 (Apple Silicon, 클라우드 없음):
- SongGeneration v2 (Tencent) — 네이티브 MLX 가중치
mlx-community/SongGeneration-v2-large. "로컬 MLX에 가장 좋음"에 가장 적합; 로컬 TTS/오디오 스택과 동일한 계열 경로. 주요 권장. - ACE-Step 1.5 — 가장 강력한 로컬 모델, Mac에서 실행, 4GB 미만, 전체 보컬 + 악기, 오디오-프롬프트 음색 클로닝 및 가사 편집 지원 → "내 클론 음성으로 노래 만들기" 경로 (참조 클립을 음색 프롬프트로 전달).
- YuE / DiffRhythm — 전체 길이 노래-가사 대안; 더 무거움.
주의: 노래하는 목소리를 클로닝하려면 노래하는 참조 클립이 필요합니다; 말하기 샘플은 음색을 클로닝하지만 보컬 퍼포먼스는 잘 복제하지 못합니다. 생성을 활성화하려면 app/.data/song/venv에 백엔드를 설치하고, scripts/gen_song.py에서 추론 호출을 구현한 다음, song-service.songConfigPayload()에서 draft_ready를 토글하세요.
앱 계약
로컬 앱은 파일 기반 JSON만 사용합니다:
app/.data/project.json: 표준 MV 워크스페이스 (song,treatment= 개념,characters,shots).app/.data/image_config.json: 스토리보드 생성을 위한 로컬 전용 이미지 API 설정.app/.data/song_config.json: 선택적 로컬 전용 노래 생성 백엔드 설정.app/.data/generated/songs/: 업로드된 (또는 생성된) 노래 오디오.app/.data/generated/storyboards/,.../references/,.../videos/: 생성 또는 업로드된 이미지 및 샷 비디오.app/.data/agent.lock: 임시 쓰기 잠금.
앱은 무료로 외부 모델을 호출하거나, 파일을 게시하거나, 메시지를 보내거나, 사용자가 트리거한 설정된 이미지/비디오 생성을 넘어 외부 시스템을 변경해서는 안 됩니다. 스킬은 사용자가 요청한 후에만 다른 작업을 준비하거나 실행할 수 있습니다.
참조 문서를 읽어야 할 때
references/mv-workflow.md: MV 개념, 캐스트 라이브러리, 샷 분할, 또는 이미지/비디오 프롬프트 워크플로를 설계하거나 개선할 때.references/ui-schema.md: 앱 파일을 편집하거나, 프로젝트 JSON을 생성하거나, 데이터를 검증할 때.
유용한 명령어
skills/kelly-mv/app/start.sh
node skills/kelly-mv/scripts/create_sample_project.ts
node skills/kelly-mv/scripts/validate_ui_schema.ts
node skills/kelly-mv/scripts/validate_shot_readiness.ts
node skills/kelly-mv/scripts/export_story_bible.ts
이미지/비디오 생성 패스 전에 validate_shot_readiness.ts (선택적으로 --strict)를 실행하세요. 스킬 저장소 루트를 기준으로 경로를 사용하거나, skills/kelly-mv 내에서 스크립트를 실행하세요.



