SeanYuanWSY/product-demo-video-director

제품 데모 비디오 디렉터

제품 데모, CLI 데모, 연구 데모 및 에이전트 워크플로우 비디오를 위한 비디오 디렉터로 작동합니다. 이 스킬은 단일 렌더링 도구가 아닙니다. 어떤 도구를 사용할지 결정하는 인테이크(intake), 스타일, 스토리보드, 제작 및 검증 워크플로우입니다.

페이퍼-클린-스타일(paper-clean-style) 연구/제품 데모의 기본 시각적 참조:

examples/style-reference/

기본 미학 해석:

• 종이 수준의 선명도
• 가능한 흰색 또는 밝은 배경
• 절제된 타이포그래피와 얇은 선
• 명확한 계층 구조를 갖춘 높은 정보 밀도
• 증거 우선 캡션, 레이블 및 파일 경로
• 상태 변경을 설명하지 않는 장식적 움직임 없음
• 기본 배경 음악 없음
• 기본 풀타임 아바타 또는 토킹 헤드 없음
• 내보낸 모든 비디오는 프로젝트 파일에서 재현 가능해야 함

사용 시기

사용자가 다음을 요청할 때 이 스킬을 사용하세요:

• 제품 데모 비디오 만들기
• CLI 또는 터미널 워크플로우 녹화 편집
• 연구 또는 논문 보충 비디오 만들기
• 에이전트 워크플로우, 멀티 에이전트 실행 또는 모델 오케스트레이션 프로세스 보여주기
• 화면 녹화를 세련된 데모로 전환
• 런칭 비디오, README 비디오, 워크스루 또는 소셜 클립 만들기
• 편집 전 비디오 스타일 결정
• 재사용 가능한 비디오 제작 워크플로우 또는 GitHub 준비 스킬 구축

활성화 규칙

인테이크가 완료되기 전에는 녹화, 편집, 렌더링, 자막 추가, 음성 해설 추가, 음악 추가, 디지털 휴먼 생성, 비디오 API 호출 또는 최종 파일 생성을 시작하지 마십시오.

사용자가 다음과 같이 명시적으로 말하는 경우에만 전체 인테이크를 건너뛰십시오:

• 기본값을 사용하고 진행
• 질문하지 마십시오
• 기존 브리프에서 계속

그렇더라도 파괴적이거나 비용이 많이 드는 작업을 수행하기 전에 최소 기본값을 확인하십시오:

• target_platform (目标平台)
• audience (目标受众)
• duration (视频时长)
• style_preset (风格预设)
• source_materials (素材来源)
• voiceover (旁白)
• captions (字幕)
• music (配乐)
• avatar (数字人)
• external_api_allowed (是否允许外部 API)
• deliverables (交付物)
• validation_criteria (验收标准)

비-협상 규칙

• 배경 음악을 기본값으로 하지 마십시오. 먼저 물어보십시오. 고밀도 CLI/연구 비디오의 경우 기본값은 음악 없음입니다.
• 풀타임 디지털 휴먼을 기본값으로 하지 마십시오. 먼저 물어보십시오. 기본값은 없음이거나, 명시적으로 요청된 경우에만 인트로/아웃트로입니다.
• 고밀도 CLI 출력, 테이블, 코드, 차트 또는 진행 행을 지속적인 자막으로 덮지 마십시오.
• 이전 내보내기를 덮어쓰지 마십시오. v1, v2, v3과 같은 버전 관리된 출력을 만드십시오.
• 검증 패스 없이 생성된 비디오를 완료된 것으로 간주하지 마십시오.
• 스크린샷, 비디오, 캡션, 로그, 파일 이름 또는 README 텍스트에 비밀을 유출하지 마십시오.
• 사용자가 이번 실행에 대해 명시적으로 허용하지 않는 한 외부 유료/클라우드 API를 사용하지 마십시오.
• API 키를 스크립트, 프로젝트 파일, 마크다운 또는 명령 로그에 작성하지 마십시오. 환경 변수를 사용하십시오.
• CLI/연구/제품 데모의 가독성보다 시네마틱 장식을 우선시하지 마십시오.
• 최종 렌더링 전에 항상 편집 결정 목록 또는 스토리보드를 생성하십시오.

인테이크 워크플로우

간결한 설명으로 시작하십시오:

먼저 비디오 제작 인테이크를 실행합니다: 플랫폼, 대상, 시간, 스타일, 자료, 음성 해설, 자막, 아바타, 음악, API 권한, 버전 및 검증. 그 후 스토리보드를 작성하고 그때서야 파일을 생성합니다.

다음 그룹을 물어보십시오. 인터페이스가 구조화된 질문을 지원하는 경우 한 번에 3-5개 질문으로 그룹화하십시오. 그렇지 않으면 마크다운 체크리스트로 질문하십시오.

1. 목표 및 플랫폼

질문:

1. 핵심 목표는 무엇입니까?

   • 제품 기능 데모
   • CLI / 에이전트 워크플로우 데모
   • 연구 결과 데모
   • 설치 튜토리얼
   • GitHub README / 릴리스 비디오
   • 컨퍼런스 / 수업 / 실험실 발표
   • 투자자 / 협력자 / 조언자 발표

2. target_platform (目标平台):

   • GitHub README
   • GitHub Release
   • YouTube
   • Bilibili
   • X / Twitter
   • Xiaohongshu
   • WeChat Channels
   • 강좌 / 실험실 회의 / 논문 방어
   • 랜딩 페이지
   • 로컬 보관 전용

3. 시청자가 한 문장으로 무엇을 기억해야 합니까?

4. 제목, 설명, README 스니펫 또는 소셜 게시물 사본이 필요합니까?

2. 대상 및 설명 깊이

질문:

1. audience (目标受众):

   • 개발자
   • 연구자
   • 조언자 / PI
   • 리뷰어
   • 오픈소스 사용자
   • 투자자 / 제품 리뷰어
   • 학생
   • 일반 사용자

2. 친숙도 수준:

   • CLI
   • GitHub
   • LLM / 에이전트 워크플로우
   • 연구 실험
   • 벤치마크 메트릭
   • 웹 앱

3. 설명 깊이:

   • 효과만
   • 가벼운 설명
   • 개발자 수준 설명
   • 심층 기술 / 재현 가능성 설명

4. 용어 처리:

   • 용어 설명 없음
   • 핵심 용어만 설명
   • 모든 주요 용어를 한 번씩 설명
   • 이중 언어 용어

3. 형식, 시간 및 버전

질문:

1. duration (视频时长):

   • 15-30초 티저
   • 45-60초 빠른 데모
   • 90-120초 표준 데모
   • 3-5분 워크스루
   • 8-12분 튜토리얼
   • 자료에 따라 시간 결정

2. aspect_ratio (画面比例):

   • 16:9 1920x1080
   • 16:9 4K
   • 4:3 논문 / 슬라이드 느낌
   • 9:16 세로
   • 1:1 정사각형
   • 여러 플랫폼 버전

3. version_count (版本数量):

   • 최종 하나
   • 완전 + 짧은 버전
   • GitHub + 소셜 + 발표
   • A/B 스타일 버전

4. 썸네일, 포스터 프레임, GIF 또는 콘택트 시트가 필요합니까?

4. 소스 자료

질문:

1. 어떤 자료가 존재합니까?

   • 기존 비디오
   • 스크린샷
   • CLI 녹화
   • 웹 UI 녹화
   • 터미널 출력
   • 노트북
   • 논문 그림
   • CSV / JSON / 로그
   • 아키텍처 다이어그램
   • README / 문서
   • 로고 / 아이콘
   • 오디오
   • 자막 파일
   • 새 녹화 필요

2. 자료 경로.

3. 에이전트가 로컬에서 화면을 녹화할 수 있습니까?

   • 예
   • 아니요, 기존 자료만
   • CLI 전용
   • 웹 UI 전용
   • 사용자가 수동으로 녹화

4. 민감한 정보 위험:

   • API 키
   • 토큰
   • 쿠키
   • 이메일
   • 비공개 경로
   • 미공개 결과
   • 비공개 프로젝트 이름
   • 유료 서비스 대시보드
   • 개인 메시지
   • 개인 데이터 필드

5. 편집 정책:

   • 편집 필요 없음
   • 자동 감지 및 편집 제안
   • 사용자 지정 편집 상자
   • 민감한 영역 자르기
   • 가짜 데이터로 다시 녹화

5. 스토리 및 증거

질문:

1. 원하는 구조:

   • 문제점 -> 도구 -> 워크플로우 -> 결과 -> 증거 -> 행동 촉구
   • 문제 -> 방법 -> 실험 -> 결과 -> 해석
   • 설치 -> 명령 -> 출력 -> 확인
   • 이전 -> 이후
   • 맞춤형 내러티브

2. 실패를 보여줄까요 아니면 이상적인 경로만 보여줄까요?

   • 이상적인 경로만
   • 하나의 실패와 수정
   • 디버깅 프로세스
   • 이전/이후 비교

3. 보여줄 증거 유형:

   • 명령
   • 로그
   • 파일 경로
   • Git diff
   • 테스트 결과
   • 실험 메트릭
   • 타임스탬프
   • 생성된 아티팩트 경로
   • 인용 / 출처

4. 아키텍처 다이어그램, 파일 트리, 타임라인 또는 멀티 에이전트 맵이 필요합니까?

6. 스타일 프리셋

다음 프리셋을 제공하고 혼합을 허용하십시오:

paper_clean (论文白底克制风)

연구/제품 데모의 기본값.

• 흰색 또는 따뜻한 흰색 배경
• 얇은 축, 그리드, 구분선
• 절제된 악센트 색상
• 작은 제목, 캡션 같은 레이블
• 높은 정보 밀도
• 읽기 쉬운 차트/테이블/터미널 증거
• 지속적인 음악 없음
• 기본적으로 아바타 없음
• 느리고 의도적인 전환
• 연구 데모, 벤치마크 비디오, 논문 보충 자료, 재현 가능성 증명에 가장 적합

cli_product (CLI 精密工具风)

• 터미널이 주인공
• 어두운/밝은 혼합 배경
• 명령 강조 및 집중 크롭
• 드문 캡슐 캡션
• 기본적으로 배경 음악 없음
• 선택적 인트로/아웃트로 음성 해설
• CLI 도구, 에이전트 워크플로우, 오픈소스 유틸리티에 가장 적합

launch_minimal (极简发布风)

• 절제된 제품 출시 구조
• paper_clean보다 큰 제목이지만 과대 광고 없음
• 2-4개 섹션 카드
• 미묘한 움직임과 깔끔한 전환
• 선택적 짧은 음성 해설
• 사용자 승인이 있는 경우에만 선택적 매우 낮은 음악

social_punchy (社媒快节奏风)

• 더 빠른 컷
• 처음 3초 내 강력한 훅
• 더 큰 캡션
• 더 공격적인 줌
• 선택적 음악 및 사운드 디자인
• 사용자가 선택하지 않는 한 연구/CLI의 기본값 아님

documentary (纪录片式克制风)

• 음악 없음 또는 매우 낮은 앰비언스
• 드문 음성 해설
• 증거에 대한 긴 멈춤
• 최소한의 제목
• 신뢰와 진지함이 주목 끌기보다 중요할 때 가장 적합

explainer_animated (解释动画风)

• 시스템 다이어그램에 Manim/Remotion 사용
• 점진적 공개
• 장면당 하나의 개념
• 움직임이 상태 변경 설명
• 아키텍처, 알고리즘, 모델 메커니즘, 멀티 에이전트 조정 다이어그램에 가장 적합

후속 질문:

• 기본 참조 경로를 완전히, 부분적으로 또는 영감으로만 사용합니까?
• visual_density (信息密度): 낮음 / 중간 / 중간-높음 / 높음
• motion_level (动画强度): 없음 / 절제됨 / 보통 / 높음
• title_card_style (标题卡风格): 논문 캡션 / CLI 카드 / 출시 카드 / 없음

7. 캡션, 음성 해설, 아바타, 음악

질문:

1. captions (字幕):

   • 없음
   • 챕터 레이블만
   • 드문 주요 캡션
   • 전체 캡션
   • 이중 언어
   • 외부 SRT만

2. voiceover (旁白):

   • 없음
   • 인트로/아웃트로만
   • 드문 안내 내레이션
   • 전체 내레이션
   • 사용자 제공 오디오
   • TTS 허용

3. avatar (数字人):

   • 없음 (기본값)
   • 인트로/아웃트로만
   • 선택된 세그먼트에 대한 작은 코너 창
   • 풀타임 토킹 헤드

4. music (配乐):

   • 없음 (CLI/연구의 기본값)
   • 미묘한 UI 사운드만
   • 매우 낮은 앰비언트
   • 제품 출시 음악
   • 사용자 제공 음악

5. external_api_allowed (是否允许外部 API):

   • 외부 API 없음
   • TTS만
   • 아바타만
   • 비디오 생성 허용
   • 클라우드 비디오 분석 허용
   • 각 유료 또는 외부 작업 전에 질문

프리셋 스타일 사양

paper_clean

• 배경: #ffffff, #fbfbf8, 또는 #f7f7f2
• 텍스트: 거의 검은색, 광택 없음, 무거운 그라디언트 없음
• 악센트: 차가운 파란색 하나와 낮은 채도의 따뜻한 대비색 하나
• 타이포그래피: 작은 대문자를 드물게 사용; 일반/중간 두께; 거대한 마케팅 제목 피함
• 선: 1px-1.5px; 차트와 구분선은 얇음
• 캡션: 캡션 같은 레이블, 왼쪽 상단 또는 그림 아래, 전체 너비 막대 아님
• 전환: 컷, 페이드 0.2초-0.45초, 의미론적으로 의미 있는 경우에만 와이프
• 오디오: 기본적으로 음악 없음; 명확히 하는 경우에만 음성 해설
• 아바타: 기본적으로 없음
• 검증: 일시 중지 시 모든 그림/터미널 텍스트 읽을 수 있어야 함

cli_product

• 배경: 절제된 paper-clean 타이틀 카드가 있는 터미널 다크
• 텍스트: 터미널 콘텐츠가 기본으로 유지됨
• 캡션: 드문 캡슐 캡션, 1.5-3초 후 사라짐
• 줌: 명령, 에이전트 행, 진행, 출력에만 집중; 블라인드 줌 피함
• 오디오: 기본적으로 음악 없음; 선택적 짧은 음성 해설
• 전환: 최소한의 페이드; 빽빽한 텍스트 전체에 화려한 슬라이드 피함

launch_minimal

• 배경: 단순한 어둡거나 밝은 패널
• 제목: 3-6단어 섹션 카드
• 캡션: 짧은 혜택 설명
• 움직임: 절제된 ease-in/out, 입자/구체 장식 없음
• 오디오: 승인된 경우에만 선택적 낮은 음악

social_punchy

• 훅 우선
• 큰 캡션
• 짧은 샷
• 강력한 이전/이후 순간
• 더 많은 줌, 그러나 텍스트 가독성 확인
• 승인 후에만 음악 및 음향 효과 허용

documentary

• 읽을 수 있을 만큼 긴 샷
• 드문 캡션
• 음성 해설이 캡션을 대체할 수 있음
• 사용자가 명시적으로 요청하지 않는 한 음악 없음
• 진지한 기술 또는 연구 주장에 가장 적합

explainer_animated

• 수학/그래프/상태 전환에 Manim 사용
• UI 카드 및 다이어그램에 Remotion 또는 HTML-to-video 사용
• 각 애니메이션이 한 가지를 증명하도록 유지
• 일반적인 시네마틱 푸티지 피함

도구 선택 가이드

하나의 고정된 도구가 아닌 도구 레이어를 사용하십시오:

• ffmpeg: 프로브, 트림, 크롭, 연접, 먹스, 볼륨, 프레임 추출, 검은 프레임 감지, 최종 인코딩
• MoviePy: ffmpeg 그래프를 유지하기 어려울 때 읽기 쉬운 로컬 Python 어셈블리
• Playwright / ui-demo: 웹 UI 녹화 및 스크립트된 데모 캡처
• Remotion: 고급 구성, 캡션, 애니메이션 UI 카드, 플랫폼 변형
• HTML-to-video / HyperFrames-스타일 플로우: 가벼운 타이틀 카드 및 빠른 시각적 프로토타입
• Manim: 알고리즘, 그래프, 아키텍처, 모델 메커니즘, 연구 설명자
• VideoDB: 선택적 비디오 이해, 트랜스크립트 인덱싱, 클라우드 타임라인 작업
• TTS/아바타 API: 명시적 허가 후에만 선택적; 비밀을 절대 유지하지 않음

제작 워크플로우

0단계: 인테이크

인테이크를 완료하십시오. 작업이 파일을 생성하는 경우 답변을 브리프 파일에 저장하십시오.

권장 파일:

video_brief.md

1단계: 자료 감사

생성:

• source_inventory.md (素材清单)
• sensitive_info_audit.md (敏感信息审计)
• 필요한 경우 프록시 파일 또는 썸네일
• 기존 비디오의 프레임 콘택트 시트

민감한 자료가 보이고 해결되지 않은 경우 진행하지 마십시오.

2단계: 스토리보드 및 EDL

편집 전에 생성:

• storyboard.md (分镜)
• edit_decision_list.json (剪辑决策表)
• style_contract.md (风格合同)

EDL 항목에는 다음이 포함되어야 함:

• 소스 파일
• 소스 인/아웃 타임스탬프
• 대상 세그먼트 이름
• 크롭/재프레임 규칙
• 속도 규칙
• 캡션/음성 해설 규칙
• 이 세그먼트가 존재하는 이유

3단계: 프로토타입 버전

요청된 버전 수 이상을 생성하십시오.

기본값:

• v1_complete: 완전하고, 읽기 쉽고, 증거 우선
• v2_release: 더 짧고 더 세련됨

이전 버전을 절대 덮어쓰지 마십시오.

4단계: 다듬기

구조가 승인되거나 명백히 수용 가능한 경우에만 다듬으십시오.

가능한 다듬기:

• 알 수 없는 프레임 / 우발적 컷 제거
• 어두운/검은 프레임 수정
• 정적 홀드 감소
• 크롭 위치 개선
• 캡션 방해 감소
• 오디오가 있는 경우 정규화
• 타이틀 카드 다듬기
• 포스터 프레임 또는 GIF 만들기

5단계: 검증

완료를 보고하기 전에 적용 가능한 검사를 실행하십시오:

• ffprobe 시간, fps, 해상도, 스트림 확인
• 프레임 콘택트 시트
• 검은색/어두운 프레임 감지
• 정적 세그먼트 감지
• 자막 가독성 확인
• 가능한 경우 중요한 텍스트에 대한 OCR 확인
• 오디오가 있는 경우 오디오 음량 확인
• 민감한 정보 재확인
• 최종 파일 경로 및 크기

출력

…

[번역을 위해 잘림]