비디오 프롬프트 빌더
비디오 생성 프롬프트를 위한 범용 제공업체 독립적 디스패처입니다. .specs/architecture/PROVIDERS.md의 라우팅 매트릭스를 읽고, 어떤 제공업체가 작업을 수행할지 결정한 후 적절한 전문가(higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder)에 위임합니다.
호출 시점
- 파이프라인에서 비디오 생성 단계(brief -> script -> creative, creative 타입이 video인 경우)일 때.
.specs/pieces/*.md파일에서type: video로 선언된 조각이 있을 때.- 제공업체별로 비디오 훅을 A/B 테스트하고 오케스트레이터가 단일 진입점을 필요로 할 때.
- A/B 승자 선정 후 동일한 브리프를 다른 제공업체로 재실행할 때.
- 상위 에이전트가 브리프를 가지고 있지만 어떤 제공업체를 선택해야 할지 모를 때.
입력
brief: 객체. 최소한subject,motion,mood,aspect,duration_seconds필드를 포함하는 시각적 브리프.task_kind: 문자열.cinematic_reel,motion_control,ugc_product_holder,product_demo,talking_head,batch_hook_test,motion_typography,data_viz_reel,programmatic_short중 하나.piece_path: 문자열, 선택 사항. 조각 파일 경로.provider_override.video를 포함할 수 있음.dry_run: 불리언, 선택 사항. true인 경우 MCP를 호출하지 않고 해결된 제공업체와 파라미터를 반환.
프로세스
.specs/architecture/PROVIDERS.md를 읽고 비디오 매트릭스를task_kind -> provider맵으로 파싱합니다.piece_path가 설정되어 있고provider_override.video를 포함하는 경우 해당 오버라이드를 사용합니다.- 그렇지 않으면 매트릭스에서
task_kind를 조회합니다. 알 수 없는 경우cinematic_reel의 매트릭스 기본값으로 대체합니다. - 선택한 제공업체에 필요한 환경 변수(
HIGGSFIELD_MCP_ACTIVE,TOPVIEW_API_KEY,WAVESPEED_API_KEY,HYPERFRAMES_ACTIVE)가 설정되어 있는지 확인합니다. - 제공업체를 전문가 스킬에 매핑합니다: Higgsfield ->
higgsfield-prompt-builder, Topview ->topview-prompt-builder, Wavespeed ->wavespeed-batch, Hyperframes ->hyperframes-prompt-builder. brief필드를 전문가가 기대하는 입력 형식으로 변환합니다.- 전문가를 호출하고
params및mcp_tool출력을 캡처합니다. dry_run인 경우 해결된 제공업체, 파라미터, MCP 도구를 반환합니다. 그렇지 않으면 MCP를 호출하고 아티팩트 참조를 반환합니다.- 실행을
data/video-usage.jsonl에 타임스탬프, 제공업체, task_kind, 결과와 함께 기록합니다.
출력
provider_used: 문자열.params: 객체. MCP 호출을 위한 최종 파라미터 객체.mcp_tool: 문자열. MCP 도구 이름.artifact_ref: 문자열, dry_run이 아닌 경우. 생성된 비디오의 경로 또는 URL.cost_estimate_usd: 숫자.
예시
예시 1: cinematic_reel이 Higgsfield로 라우팅됨
입력: { brief: { subject: "린넨 정장을 입은 모델", motion: "트래킹 샷", mood: "에디토리얼", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" }
출력: { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }
예시 2: UGC 광고가 Topview로 라우팅됨
입력: { brief: { subject: "아바타가 들고 있는 스킨케어 병", motion: "정적", mood: "친근한", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" }
출력: { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }
예시 3: 주간 KPI 릴이 Hyperframes로 라우팅됨
입력: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" }
출력: { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — hyperframes + hyperframes-cli 스킬을 통한 로컬 렌더링.
실패 모드
- task_kind가 매트릭스에 없음: 경고를 기록하고 cinematic_reel 기본값을 사용합니다.
- 선택한 제공업체에 필요한 환경 변수 누락: 매트릭스의 다음 제공업체로 전환하고 경고를 표시합니다.
- 전문가 스킬이 오류를 반환: 오류를 표시하고 호출자가 선택하지 않는 한 다른 제공업체로 자동 재시도하지 않습니다.
- 지속 시간이 제공업체 제한을 초과: 제공업체 최대치로 자르고 알림을 표시합니다.
관련 스킬
higgsfield-prompt-builder: Soul, DoP, Seedance 전문가.topview-prompt-builder: UGC 및 아바타 기반 광고 전문가.wavespeed-batch: 저렴한 배치 훅 테스트 전문가.hyperframes-prompt-builder: HTML 렌더링 모션 타이포그래피, 데이터 시각화 릴, 매개변수화된 프로그래매틱 숏 전문가.llm-router: 텍스트 생성을 위한 별도 디스패처. 동일한 패턴, 다른 도메인.qa-tech-specs: 최종 비디오가 플랫폼 사양을 준수하는지 검증합니다.