Plan 영상 제작 스킬
적용 범위
전제 조건: 현재 Plan 협업이 활성화되어 있어야 하며(scenario(activate, plan) 활성화됨), 시각/영상 산출물(이미지 생성, 단편 영상, 더빙, 자막)이 포함된 태스크여야 합니다.
공급사 선택: 이미지 생성은 byted-ark-seedream-skill을 읽고, 영상 생성은 media-production 스크립트(Volcano Seedance)를 읽습니다. 기타 공급사는 agnes-media-generation / wan-media-generation / kling-media-generation을 참조하세요.
자격 증명 (환경 변수)
설정 → 환경 변수에서 스킬에 필요한 KEY=VALUE(예: VOLCENGINE_API_KEY / ARK_API_KEY)를 추가합니다. 설정 → 모델 → 크리에이티브 미디어에서 다른 공급사의 키를 입력할 수도 있습니다.
| 기능 | 일반적인 KEY | 스킬 |
|---|---|---|
| 이미지 생성 | VOLCENGINE_API_KEY / ARK_API_KEY | byted-ark-seedream-skill |
| 영상 생성 | 동일 | media-production |
| Agnes | AGNES_API_KEY | agnes-media-generation |
핵심 변경 사항: 모든 미디어 직군(각본가, 시각 기획자, 아티스트, 감독, 후반 작업)은 모두 plan(goal, steps[])의 steps 안에서 assigned_agent로 지정되며, plan이 저장되고 사용자가 확인하면 즉시 executing 상태로 진입하여 직렬 실행됩니다. 더 이상 plan 외부에서 별도로 subagent를 위임하지 않습니다.
워크플로우
사용자 요구사항 표현
↓
사용자 요구사항 질문 및 확인 (주제, 길이, 스타일, 화면 비율 등)
↓
plan(goal, steps[])으로 직접 계획
step 1: media-screenwriter — 대본/스토리보드/내레이션
step 2: media-visual-planner — 이미지 생성 프롬프트
step 3: media-artist — 키프레임 생성
step 4: media-video-director — 영상 출력 + 네이티브 더빙
step 5: media-post — 하드 자막
↓
사용자 확인 → 실행 (직렬, 각 단계마다 검증)
작업 단계
1단계: 사용자 요구사항 질문
사용자에게 다음 정보를 능동적으로 수집합니다.
| 질문 | 예시 |
|---|---|
| 영상 주제/제품/내용은 무엇인가요? | 신형 스마트워치 홍보 |
| 목표 길이는? | 15초 / 30초 |
| 시각 스타일은? | 테크 감성 / 따뜻함 / 중국풍 |
| 화면 비율은? | 16:9 / 9:16 세로 |
| 내레이션 방향은? | 기능 하이라이트 + 브랜드 슬로건 |
| 참고 자료가 있나요? | 참고 이미지 / 경쟁사 영상 |
2단계: 확인 후 직접 plan
사용자가 요구사항을 확인하면 plan 도구를 사용하여 모든 단계를 구조화된 계획에 기록합니다.
plan(
goal="15초 제품 홍보 영상 제작, 주제: xxx, 스타일: xxx",
steps=[
{
"step_id": 1,
"description": "각본가가 production brief 작성, 로그라인, 스토리보드, 내레이션 대본 포함",
"assigned_agent": "media-screenwriter",
"expected_output": "outputs/production-brief.md",
"acceptance_criteria": "사용자 의도, 로그라인, 시각 스타일, 샷 목록, 내레이션 대본 포함"
},
{
"step_id": 2,
"description": "시각 기획자가 스토리보드를 이미지 생성 프롬프트로 변환",
"assigned_agent": "media-visual-planner",
"expected_output": "outputs/shot-prompts.json",
"depends_on": [1]
},
{
"step_id": 3,
"description": "아티스트가 첫 번째 키프레임 이미지 생성",
"assigned_agent": "media-artist",
"expected_output": "outputs 내 PNG 키프레임",
"depends_on": [2]
},
{
"step_id": 4,
"description": "영상 감독이 네이티브 더빙이 포함된 MP4 생성",
"assigned_agent": "media-video-director",
"expected_output": "outputs/*.mp4",
"depends_on": [3]
},
{
"step_id": 5,
"description": "후반 작업에서 하드 자막 추가, 최종 MP4 전달",
"assigned_agent": "media-post",
"expected_output": "outputs/*-subtitled.mp4",
"depends_on": [4]
}
],
flowchart_mermaid="..."
)
3단계: 사용자 확인 후 실행
plan이 저장되고 사용자가 "실행 시작"을 확인하면 executing 단계로 진입하며, 각 단계는 의존성 순서에 따라 직렬로 실행됩니다. 각 단계 완료 후 주 에이전트가 산출물을 검증한 후 다음 단계로 넘어갑니다.
미디어 서브 에이전트 목록
| assigned_agent | 역할 | 핵심 도구 |
|---|---|---|
media-screenwriter | 대본, 스토리보드, 내레이션 대본 작성 | read_file, write_to_file |
media-visual-planner | 이미지 생성 프롬프트 작성 | read_file, write_to_file |
media-artist | Seedream 이미지 생성 (jimeng) | read_file, terminal → scripts/image_generate.py |
media-video-director | Seedance 이미지 to 영상 + 네이티브 더빙 | read_file, terminal → scripts/video_generate.py, task_wait.py |
media-post | SRT 자막 + ffmpeg 하드 자막 | read_file, terminal → scripts/subtitle_build.py, subtitle_burn.py |
참고: media-voice-director는 단계에 포함하지 마십시오. Seedance는 이미 네이티브 오디오를 지원합니다(generate_audio=true 기본 활성화).
기술 스택
스크립트 디렉토리: skills/public/media-production/scripts/ (media-production 스킬을 먼저 읽어야 함)
| 기능 | 스크립트 | provider |
|---|---|---|
| 이미지 생성 | image_generate.py | jimeng (Volcano Ark Seedream) |
| 영상 생성 | video_generate.py + task_wait.py | jimeng (Volcano Ark Seedance, 기본 오디오 포함) |
| 자막 | subtitle_build.py + subtitle_burn.py | 로컬 ffmpeg |
실패 처리: jimeng 실패 시 자동으로 wan/kling으로 전환하지 말고 사용자에게 Ark 모델 액세스 포인트를 개설하도록 안내합니다. 동일한 매개변수로 최대 1회 재시도합니다.
일반적인 오류
- plan 모드에서 메인 세션이 직접
image_generate.py실행 → plan 단계 내media-artist등의 직군이 실행해야 함 - plan 단계 외부에서 별도로 subagent 위임 → 모든 직군은 plan steps의
assigned_agent에 작성해야 함 task_wait.py생략 → 영상 생성이 완료되지 않은 상태로 전달- 기본 파이프라인에서 여전히
media-voice-director위임 → Seedance가 이미 네이티브 오디오를 지원하므로 불필요