Communitygithub.com

simpletibr/simplicio-loop-marketing

비디오 생성 프롬프트를 조립하여 PROVIDERS.md를 통해 제공업체를 선택하고 일치하는 제공업체별 빌더에 위임합니다.

simplicio-loop-marketing란 무엇인가요?

이 스킬은 비디오 생성 프롬프트를 위한 범용 디스패처 역할을 합니다. `.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`로 선언된 조각을 처리할 때 호출됩니다. 입력으로 비디오 브리프(주제, 움직임, 분위기, 화면비, 길이), 작업 종류(예: cinematic_reel, ugc_product_holder), 선택적 조각 경로 및 dry_run 플래그를 받습니다. 처리 과정은 제공업체 확인, 환경 변수 검증, 파라미터 변환, 전문가 스킬 호출, 결과 로깅을 포함하며 최종적으로 사용된 제공업체, 파라미터 객체, MCP 도구 이름, 생성된 비디오 참조, 비용 추정치를 출력합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/video-prompt-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

비디오 프롬프트 빌더

비디오 생성 프롬프트를 위한 범용 제공업체 독립적 디스패처입니다. .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를 호출하지 않고 해결된 제공업체와 파라미터를 반환.

프로세스

  1. .specs/architecture/PROVIDERS.md를 읽고 비디오 매트릭스를 task_kind -> provider 맵으로 파싱합니다.
  2. piece_path가 설정되어 있고 provider_override.video를 포함하는 경우 해당 오버라이드를 사용합니다.
  3. 그렇지 않으면 매트릭스에서 task_kind를 조회합니다. 알 수 없는 경우 cinematic_reel의 매트릭스 기본값으로 대체합니다.
  4. 선택한 제공업체에 필요한 환경 변수(HIGGSFIELD_MCP_ACTIVE, TOPVIEW_API_KEY, WAVESPEED_API_KEY, HYPERFRAMES_ACTIVE)가 설정되어 있는지 확인합니다.
  5. 제공업체를 전문가 스킬에 매핑합니다: Higgsfield -> higgsfield-prompt-builder, Topview -> topview-prompt-builder, Wavespeed -> wavespeed-batch, Hyperframes -> hyperframes-prompt-builder.
  6. brief 필드를 전문가가 기대하는 입력 형식으로 변환합니다.
  7. 전문가를 호출하고 params 및 mcp_tool 출력을 캡처합니다.
  8. dry_run인 경우 해결된 제공업체, 파라미터, MCP 도구를 반환합니다. 그렇지 않으면 MCP를 호출하고 아티팩트 참조를 반환합니다.
  9. 실행을 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: 최종 비디오가 플랫폼 사양을 준수하는지 검증합니다.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

관련 스킬