🎬 Manju-Laoli Skill – 숏드라마 디렉터 스위트 (V6.9.8 Lite)

이것은 무엇인가 – AI 에이전트(OpenClaw, Coze, Dify, WorkBuddy 등)를 위한 바로 사용 가능한 스킬 패키지로, AI 생성 숏 비디오 제작을 위한 엔드투엔드 파이프라인을 인코딩합니다. 이 저장소에는 완성된 대본이나 비디오가 포함되어 있지 않습니다. LLM 기반 어시스턴트가 호출할 수 있는 규칙, 템플릿, 검증 스크립트 모음을 제공합니다:

1. 모델 버전, 화면비 및 기타 프론트엔드 설정을 고정합니다.
2. 대본, 대사, 캐릭터/소품 에셋, 스토리보드를 생성하면서 샷 간의 엄격한 일관성을 유지합니다.
3. 결과를 구조화된 7섹션 프롬프트(또는 MiniMax H3 스타일 6섹션 프롬프트)로 패키징하여 Seedance 2.5/2.0 또는 MiniMax H3와 같은 비디오 생성 모델에 직접 공급할 수 있습니다.

---

🚀 핵심 기능 (README에 설명된 대로)

단계	기능	설명
📋 고정	필수 프론트엔드 고정	작업 시작 전에 하나의 비디오 모델(Seedance 2.5, Seedance 2.0 또는 MiniMax H3)과 하나의 화면비(16:9, 9:16, 21:9)를 선택합니다.
✍️ 대본	5단계 게이트 엔진	전제 → 구조 → 비트 → 엔티티 → 페이지 순서로 어시스턴트를 안내하며, 내장된 3막 구조와 비트 시트를 갖추고 있습니다.
📈 감정	12비트 긴장 곡선	에피소드 전체의 긴장을 0-10 척도로 정량화하고 고전적인 "9번째 비트 반전"을 검증합니다.
🎙️ 대사	7차원 진단 + 속도 체크 + 톤 슬롯	말하기 속도(3.5-5자/초)를 확인하고, 너무 긴 줄을 분할하며, 대사：【캐릭터（톤）:"…"】 형식을 강제합니다.
🖼️ 에셋	에셋 우선 디지털 팩	스토리보드 전에 고정된 캐릭터 "4뷰" 시트, 장면 맵, 소품 시트를 생성하여 시각적 일관성을 보장합니다.
🎥 공간	한 줄 스탠스 선언 + 그레이딩	위치, 앵커, 방향, 포즈를 선언하고, 축 잠금, 180도 규칙, 배치된 각 캐릭터가 최소 하나의 샷에 등장하도록 강제합니다.
🎬 스토리보드	이중 모드(드라마 & 액션) + 첫 샷 앵커	드라마에는 미세 표정 진행, 액션에는 15초 PREVIS 점수를 제공하며, 샷 크기, 포즈 연속성, 시선 할당에 대한 엄격한 규칙이 있습니다.
😀 퍼포먼스	FACS 미세 표정 엔진	감정을 강도 등급과 "진짜 웃음 vs 가짜 웃음" 규칙과 함께 액션 유닛(AU)에 매핑합니다.
⚔️ 라이브러리	무술/판타지 데이터	23개 문파, 9가지 검술, 무기, 경공, 11가지 피니셔 콤보, 판타지 주문 정의.
🚀 프롬프트 패키징	7섹션 메인 형식(+ H3 분기)	복사 가능한 프롬프트를 생성: 스타일 → 장면 에셋 → 캐릭터 → 스탠스 → 타임라인 → SFX → 네거티브. MiniMax H3를 선택하면 자동으로 6섹션 Ref2VA 형식으로 변환됩니다.
🚫 네거티브	3회 재작성 금지 처리	비디오 모델이 명시적 부정을 무시하지만 어근에는 반응한다는 사실을 처리합니다. "네거티브 블록"은 금지된 개념만 나열합니다.
✅ QC	P0-P2 게이트 + 샷 레벨 린트	기간, 대사, 축, 화면비, 에셋 앵커, 오디오 레벨을 검증하고 validate_prompt.py를 실행하여 C1-C20(Seedance) 또는 H1-H12(H3) 검사를 출력합니다.
🖥️ 보드	오프라인 스토리보드 보드	프로젝트 마크다운을 단일 파일 HTML 보드로 변환하여 빠른 시각적 검토를 가능하게 합니다.
🛡️ 컴플라이언스	안전 번역 사전	유혈/사지 손실 설명을 플랫폼 안전 언어로 재작성합니다.

---

🛠️ 사용 방법 (README 퀵스타트)

# 스킬을 OpenClaw 에이전트에 설치
openclaw skills install ./short-drama-director --as short-drama-director

# 패키지 검증 (41개 규칙 모듈 + 의미론적 회귀)
python3 short-drama-director/scripts/check_package.py

# 샷 레벨 프롬프트 검증기 실행 (FAIL이 0이어야 함)
python3 short-drama-director/scripts/validate_prompt.py <script>.md --model 2.5|2.0|h3

# 오프라인 스토리보드 보드 구축 (단일 HTML 파일)
python3 short-drama-director/scripts/build_board_lite.py <project.md>

# 12비트 감정 곡선 차트 생성
python3 short-drama-director/scripts/generate_emotion_curve.py

README에는 LLM 어시스턴트가 사용자에게 노출할 수 있는 슬래시 명령도 나열되어 있습니다. 예: /写剧本, /资产图册, /做分镜, /生成视频提示词, /H3提示词 등.

---

📂 저장소 구조 (문서화된 대로)

manju-laoli-skill/
└─ short-drama-director/        # V6.9.8 Lite – 49개 파일, 41개 규칙 모듈
   ├─ SKILL.md                  # 메인 라우터, 워크플로 설명, 모듈 인덱스
   ├─ references/                # 41개 마크다운 규칙북 (에셋 파이프라인, 모델 어댑터, FACS 등)
   ├─ scripts/                  # 헬퍼 유틸리티
   │   ├─ check_package.py       # 정적 + 의미론적 린트
   │   ├─ validate_prompt.py    # 프롬프트 레벨 QC (C1-C20 / H1-H12)
   │   ├─ build_board_lite.py    # MD → 단일 HTML 보드
   │   └─ generate_emotion_curve.py
   └─ README.md / LICENSE / CHANGELOG.md

---

🎯 의도된 사용 사례

• AI 생성 숏드라마, 애니메이션 숏, 시리즈 에피소드
• AI 기반 광고, 브랜드 필름, 컨셉 비디오
• 대규모 프로덕션을 위한 프리비주얼라이제이션(PREVIS) 스토리보드
• 액션/격투 안무 설계 (모던, 무협, SF 등)
• FACS를 사용한 미세 표정 및 감정 엔지니어링
• 대본 → 스토리보드 → 비디오 모델 프롬프트의 엄격한 크로스 샷 일관성이 필요한 모든 워크플로.

---

📜 라이선스 및 커뮤니티

이 프로젝트는 MIT 라이선스로 배포되며, 기여자, 스폰서 테이블, 추가 협업을 위한 연락처 정보를 나열합니다.

---

TL;DR

Manju-Laoli Skill은 생성 비디오 모델로 숏 비디오 콘텐츠를 만드는 전체 파이프라인을 자동화하는 AI 에이전트용 규칙 기반 스킬 패키지입니다. 에셋 우선 일관성을 강제하고, 광범위한 품질 게이트 검사를 제공하며, Seedance 또는 MiniMax H3 모델에 직접 공급할 수 있는 프롬프트를 출력합니다. 저장소에는 규칙북, 검증 스크립트, 퀵스타트 가이드가 포함되어 있어 진정한 AI 중심 오픈소스 프로젝트입니다.