Communitygithub.com

cubeplexai/auto-demo-video

시나리오 → 스크립트 → Playwright 시네마틱 녹화 → 하이라이트 파이프라인을 통한 자동 데모 비디오 생성

auto-demo-video란 무엇인가요?

auto-demo-video는 라이브 제품 데모를 자동 생성하는 파이프라인입니다. 시나리오 파일을 기반으로 Playwright를 사용하여 시네마틱하게 브라우저 상호작용을 녹화하고, 편집 과정을 거쳐 최종 MP4 비디오를 렌더링합니다. 이 도구는 제품별 로직을 분리하여 재사용성을 높이며, `scenario.yaml`, 외부 어댑터, 환경 변수를 통해 설정을 관리합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 환경에서 사용할 수 있으며, 'adv' CLI 명령어를 통해 계획, 녹화, 편집, 렌더링의 전체 워크플로우를 자동화합니다. 주요 특징으로는 제품 저장소에서 시나리오를 작성하고, 외부 어댑터를 통해 커스텀 로직을 주입할 수 있으며, Remotion과 함께 사용하여 더 복잡한 비디오 편집도 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add cubeplexai/auto-demo-video

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

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

문서

auto-demo-video은(는) 무엇을 하나요?

라이브 제품 데모를 위한 일반 파이프라인입니다.

핵심 규칙

auto-demo-video 저장소에 제품별 로직을 추가하지 마십시오 (작업 공간 이름, 브랜드 프롬프트, 테넌시 선택기, 앱 testid).
이러한 항목은 소비자 앱/마케팅 저장소에 보관하고 다음을 통해 전달하십시오.

  • scenario.yaml (단계, 캡션, 프롬프트)
  • adapter: ./path/to/adapter.mjs + adapterOptions
  • 환경 자격 증명 / storage-state.json

명령어

adv plan   --scenario <yaml> [--code-root <dir>]
adv record --script <script.json>
adv edit   --meta <meta.json> [--target-sec 90]
adv render --plan <edit-plan.json>
adv all    --scenario <yaml> --out runs/job

어댑터

내장: generic-web 만 해당.

외부:

adapter: ./demos/adapter.mjs
adapterOptions:
  # 어댑터에 대한 자유 형식

형태: export default { loginPath?, isAuthed?, afterLogin?, custom?, composerPlaceholders? }.

워크플로우

  1. 제품 저장소에서 시나리오 + 선택적 외부 어댑터를 작성합니다.
  2. adv plan → script.json을 검토합니다.
  3. BASE_URL + 자격 증명(또는 스토리지 상태)을 설정합니다.
  4. adv record → 메타/스크린샷을 검사합니다.
  5. adv edit → adv render → final.mp4.
  6. (선택 사항) 다른 프로젝트에서 Remotion 패키징.

문서

  • docs/pipeline.md
  • docs/shotcraft-notes.md
  • schemas/*.json

관련 스킬