단막극 창작 라우팅
이 스킬은 프로젝트 초기화, 단계 간 라우팅, 제작 형태 및 대시보드를 담당합니다. 각 단계의 본문은 해당 owner가 작성합니다.
Quick Start
모든 프로젝트는 일관되게 creator-first 워크플로우를 사용합니다: 각 에피소드별로 필요에 따라
대본.md, 시각설정.md, 스토리보드.md, 이미지프롬프트.md, 비디오프롬프트.md를 유지 관리하며, 병렬적인 구조화된 창작 진실을 만들지 않습니다.
구체적인 작성 방법은 다섯 가지 창작 문서를 참조하세요.
라우팅
| 사용자가 하려는 작업 | owner / 행동 |
|---|---|
| 아이디어 개발, 시리즈 약속, 각색 및 에피소드 맵 | $short-drama-develop, 사용자가 필요로 할 때만 |
| 여러 에피소드의 완전한 대본/산발적 자료를 이미 보유하고 있으며 에피소드 식별 | $short-drama-develop 실제 경계에 따라 임시 인덱스 생성 |
| 긴 원작 분석 | $short-drama-novel-analyze, 사용자가 필요로 할 때만 |
| 단일 에피소드 대본 작성 또는 수정 | $short-drama-write → 대본.md |
| 캐릭터, 스타일, 장소, 소품 분해 | $short-drama-assets → 시각설정.md |
| 에셋 이미지 프롬프트 작성 | $short-drama-image-prompts → 이미지프롬프트.md |
| 촬영 및 동결 키프레임 | $short-drama-storyboard → 스토리보드.md |
| 비디오/타임라인 음악 프롬프트 작성 | $short-drama-video-prompts → 비디오프롬프트.md |
| 실제 미디어 생성 | $short-drama-produce, 먼저 미리보기, 명시적 확인, 마지막으로 실행 |
| 검토 또는 검증 | $short-drama-review, 사용자가 지명할 때만 |
| 초기화, 대시보드, 문서 보관 | 이 스킬 |
프로젝트개발/ 폴더의 긴 자료 분석 및 에피소드 인덱싱은 선택적 분석 작업 공간이며, 단일 에피소드 레이아웃 판단에는 참여하지 않습니다. 어떤 에피소드를 작성하든 여전히 해당 에피소드의 다섯 가지 creator-first Markdown 파일만 유지 관리합니다.
기존 대본은 바로 에셋으로 분해할 수 있습니다. 기존 시각 사실이 있다면 바로 이미지 프롬프트나 스토리보드를 작성할 수 있습니다. 기존 스토리보드가 있다면 바로 비디오 프롬프트를 작성할 수 있습니다. 명목상의 파이프라인을 채우기 위해 상위 단계를 위조하지 마십시오.
요청 실행
- 사용자가 제시한 프로젝트 또는 자료를 찾고, 현재 작업의 직접적인 입력만 읽습니다.
- 사용자가 지명한 전체 범위를 해당 owner에게 전달합니다. 배치는 컨텍스트만 제어하며, 자동으로 계속 실행됩니다.
- 실제 창작 분기점에서만 질문합니다. 스키마, 디렉토리, 트랜잭션 또는 검사기로 창작자에게 질문하지 마십시오.
- 범위 완료 후 완료된 내용, 주요 결정, 실제 미해결 사항 및 선택적 다음 단계를 한 번에 보고합니다.
- 사용자가 지명하지 않은 검토, 보관 또는 생산을 자동으로 시작하지 않습니다.
초기화 및 대시보드
프로젝트 구성이 필요할 때 실행:
python3 {스킬 디렉토리}/scripts/project_tool.py init ./my-drama --title "예시 드라마"
init은 구성과 빈 디렉토리만 생성합니다. 첫 번째 창작 시에만 문서를 에피소드/<EP>/에 쓰며, 빈 파일을 미리 만들지 않습니다.
프로젝트 위치 및 안전한 쓰기에 대한 자세한 내용은 런타임 사전 점검을 참조하세요. 사용자가 명시적으로 대시보드를 요청할 때 실행:
python3 {스킬 디렉토리}/scripts/dashboard_server.py --workspace <workspace> --port 0 --detach --open
--detach는 서비스 프로세스를 현재 셸에서 분리하여 독립적으로 실행합니다. 세션이 종료되거나, 터미널이 닫히거나, 에이전트가 종료되어도 함께 종료되지 않습니다.
따라서 링크는 전체 창작 기간 동안 유효합니다. 실행 중인 주소, 포트 및 pid는
<workspace>/.short-drama/dashboard.json(본인만 읽기 가능)에 기록되며, 로그는 같은 디렉토리의 dashboard.log에 저장됩니다.
python3 {스킬 디렉토리}/scripts/dashboard_server.py --workspace <workspace> --status # 현재 링크 출력
python3 {스킬 디렉토리}/scripts/dashboard_server.py --workspace <workspace> --stop # 중지
동일한 workspace에 이미 실행 중인 대시보드가 있을 때 다시 시작하면 동일한 링크만 출력되며, 두 번째 포트를 열지 않습니다.
포트나 토큰을 변경해야 하는 경우 --restart를 추가하십시오. --detach 없이 실행하면 동작이 변경되지 않습니다: 포그라운드에서 실행되며 Ctrl-C로 종료됩니다.
대시보드는 창작 파일을 표시하고 편집하며, 워크플로우 오케스트레이션이나 미디어 생성을 담당하지 않습니다.
프로젝트 수준 창작 결정
제작 형태, 시각 방향, 재생 플랫폼 및 에피소드 길이 목표가 여러 단계에 영향을 미칠 때, 선택 사항과 그 영향을 제시한 후 사용자가 결정합니다. Look Development는 선택적 분기이며, 이미지 프롬프트나 스토리보드로 진입하기 위한 고정된 관문이 아닙니다.
질문별로 하나의 관련 지식만 읽습니다:
- 규칙 계층 및 owner 라우팅: 규칙 및 라우팅 인덱스
- 출력 언어, 안정적인 ID, 소유권 및 안전 경계: 계약 및 소유권
- 실사, 2D, 3D, 수묵화, Q 버전, 중국풍 애니메이션의 형태 차이: 제작 형태
- 대표 프레임 비교가 필요할 때: Look Development
- 참조 이미지가 제어할 수 있는 것: 참조 역할
- 가림, 지연된 공개 및 시청자 인지 시점: 시청자 공개
- 마스터, 추가 촬영 및 대체 버전의 역할: 추가 촬영 및 대체
생산 및 전달 경계
외부 생산은 항상 preview -> explicit confirm -> run을 유지합니다. 보관은 사용자가 지명한 현재 문서와 완성된 결과물만 복사하며, 비공개 입력, 자격 증명, 절대 경로 및 숨겨진 실행 상태는 제외합니다. 보관을 위해 승인, 해시 또는 두 번째 콘텐츠 세트를 생성하지 않습니다.
사용자가 "다 했는데 어떻게 내보내기/전달하나요?"라고 물으면 export로 현재 상태를 패키징합니다:
python3 {스킬 디렉토리}/scripts/project_tool.py export <project> --out <프로젝트 외부 디렉토리>
이 명령은 각 에피소드의 현재 다섯 가지 창작 문서와 에피소드/<EP>/제작결과물/ 폴더를 --out으로 복사하고, manifest.json과 checksums.sha256을 첨부하며, 입력/, 전달/ 및 .short-drama/는 제외합니다. 일부만 필요한 경우 --episode EP001(반복 가능)을 추가합니다. 텍스트만 필요한 경우 --no-media를 추가합니다. 기존 디렉토리를 덮어쓰려면 --overwrite를 추가합니다. --out은 프로젝트 외부에 있어야 합니다.
export는 현재 상태 스냅샷이며, manifest의 asserts_approval은 항상 false입니다: 어떤 검토나 창작자 승인도 주장하지 않습니다. 승인 증명이 필요한 공식 전달 패키지는 여전히 package/verify 경로를 통해서만 가능합니다.
설치 및 유지보수
설치, 업그레이드 또는 문제 해결 시에만 python3 scripts/selftest.py를 실행합니다.