브라우저 데모 비디오
비디오를 코드로 스크립트화하므로 테이크가 반복 가능합니다. 음성 변경이나 레이블 하나 수정되면 자동으로 재테이크되며, 수동 재녹화가 필요 없습니다. 파이프라인:
script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
│ │
└──────────record.cjs◀───────────┘ Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
│
post.py ──▶ MP4 (cuts removed, narration + click sounds, −16 LUFS, chapters)
│
review.py ──▶ contact sheets + loudness/chapter check → you inspect, then deliver
엔진: 이 스킬의 scripts/ 디렉토리. 비디오별 프로젝트: ~/Movies/Demos/<slug>/ (/tmp는 절대 사용하지 않음, 지워질 수 있음). video.config.cjs, script.cjs, audio/, takes/ 디렉토리를 포함합니다. 실행 가능한 예제: examples/hello-orders/ (호스트 셸에 임베디드된 작은 페이지; 설정 확인에 사용). 첫 번째 테이크 전에 references/lessons.md를 읽으세요.
요구사항: Chrome, Node(Playwright 포함, record.cjs가 자동 찾거나 설정에서 playwright 지정), ffmpeg/ffprobe, Python 3, Polly용 AWS CLI.
1. 비디오 합의 (코드 작성 전)
확인하고 사용자가 반응할 수 있는 개요를 제안하세요:
- 대상 시청자. 내부 비디오는 역할, 권한, 컨트롤 및 알려진 제한을 다루고, "알아야 할 사항" 챕터로 끝납니다. 리더십 및 고객 비디오는 결과와 해피 패스만 다룹니다.
- 전체 흐름, 챕터별로, 목표 길이. 내부 심층 분석에는 약 10–12분이 적합했습니다.
- 녹화 위치 (결정). 워크스루는 실제 버튼을 클릭하고 실제 상태를 기록하므로, 실제 공유 데이터에서는 실행되지 않습니다. 복사본, 테스트 워크스페이스, 또는 현실적인 데이터가 있는 개발 환경과 테이크 간 초기화 방법을 권장합니다. 해당 복사본이 프로덕션에 기록된다면 명시적 동의가 필요합니다.
- 신원 (결정). 흐름에 두 명(제작자와 검토자)이 필요한 경우, 실제 팀원이 두 번째 창에 로그인하거나, 한 사람이 두 역할을 모두 수행하고 비디오에서 화면에 표시합니다. 사용자를 생성하거나 비밀번호를 처리하지 마십시오. 테스트 계정이 필요하면 사용자가 직접 생성합니다.
- 음성 (결정). 기본값은 Polly 생성 "Amy" (en-GB)이며, 실제 시청자에게 잘 반응했습니다. 모든 것을 생성하기 전에 각 후보 음성의 약 30초 샘플을 제공하세요:
aws polly synthesize-speech --profile <dev profile> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<제품 용어가 포함된 구절>" sample-Amy.mp3비프로덕션 AWS 계정을 사용하세요. macOSsay는 오프라인에서 작동하지만 합성음처럼 들립니다. 사용자 자신의 목소리가 가장 자연스러운 옵션입니다. - 프레이밍. 프레임에는 제품만 표시됩니다: 호스트 사이드 패널, 목록, 배너는 없습니다. 설정의
setup훅에서 설정하세요.
2. 프로젝트 설정
P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/
video.config.cjs에서 다음을 입력하세요: 일회용 환경의 url, 제품이 iframe에서 실행되면 frame, ready, setup(프레이밍), theme(제품 강조 색상 및 푸터), voice, helpers.waitLoaded(제품의 로드 완료 신호).
단계를 작성하기 전에 UI를 매핑하세요. 열고, 안정적인 선택자(id, roles, data-*, 표시 텍스트)를 나열하고, 느린 로드를 기록하세요. 생성된 키보다 표시된 텍스트(tr:has-text("-1,250.00") [data-resolve])에 기반한 선택자를 선호하세요.
3. 장면 스크립트 작성
각 단계에는 { id, chapter?, pre?, say?, act?, gap? }이 있습니다. h API는 templates/script.cjs 상단에 문서화되어 있습니다.
- 내레이션이 타이밍을 결정합니다.
act는 클립이 재생되는 동안 실행되며,h.at(0.6)는 두 번째 액션을 단어와 맞춥니다. 각say는 한두 문장으로 유지하세요. - 숫자는 말하는 대로 작성하세요 ("ninety-seven percent", "the fourteenth of September").
- 실제 사용자의 실제 결정을 사용하세요. 가능한 경우, 화면의 수치가 팀이 알고 있는 것과 일치하도록 합니다.
- 각 챕터 앞에 챕터 카드(
h.card)를 배치하고, 3–6단어 레이블이 있는 링을 추가하세요.note()는 안전 속성, 주의 사항 또는 "실제 사용 시…"와 같이 설명이 필요한 경우에만 사용하세요. - 모든 느린 로드는
h.cut(() => h.waitLoaded(), 'Loading …')로 감싸세요. 해당 구간은 후반 작업에서 제거됩니다. - 화면과 내레이션에서 모든 단순화를 설명하세요. 예를 들어, 한 사람이 두 역할을 수행하는 경우: 이를 제어하는 컨트롤을 보여주고, "이 녹화만을 위해" 설정을 변경하고, 실제 사용에서 어떻게 되는지 설명하세요.
- 다운로드를 가리키되 클릭하지 마세요 (lessons 참조).
4. 음성 생성
node $K/scripts/tts.cjs "$P". 변경된 줄만 재생성됩니다. Claude는 결과를 들을 수 없으므로, 위험한 단어(약어, 이름)를 명시하고 사용자에게 확인을 요청하세요. macOS say를 사용하는 경우, 약어를 문자로 철자하세요 ("S A P").
5. 드라이 런, 로그인, 녹화
- 드라이 런.
TARGET=preview로 설정하고previewUrl을 로컬 빌드(있는 경우)로 지정하세요. 그렇지 않으면 일회용 환경에서 짧은 세그먼트를 실행하세요:ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Read 도구로 몇 개의 프레임을 확인하세요(takes/prod/frames/*.jpg, 오류 시failure.png), ffprobe로 프레임이 1920×1080인지 확인하세요. 이후 환경을 초기화하세요. - 로그인.
node $K/scripts/record.cjs "$P" login을run_in_background와 함께 실행하세요. 사용자가 열린 창에서 로그인한 후 닫습니다. 사용자가 완료했다고 말했지만 창이 열려 있으면pkill -INT -f "record.cjs.* login". - 전체 테이크. 환경을 초기화한 후,
node $K/scripts/record.cjs "$P" record를run_in_background와 함께 실행하세요. 시작하기 전에, 사용자에게 내레이션 길이의 약 1/3이 추가로 소요되며, 보이는 Chrome 창을 클릭하지 말아야 한다고 알려주세요. 완료 알림을 기다리세요; sleep으로 폴링하지 마세요. 로그에서 모든ok단계와FAILED또는CRASHED줄이 없는지 확인하세요.
6. 조립 및 검토
python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" # run_in_background; 10분 비디오에 약 10분 소요
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review" # 선택사항: step_id:0.8 picks
모든 review/s*.jpg 시트를 읽으세요. 잘린 레이블이나 겹치는 레이블, 잘못된 요소의 링, 제거되지 않은 로딩 상태, 남은 오버레이를 확인하세요. 음량은 약 -16 LUFS, 챕터 수는 스크립트와 일치해야 합니다. 스크립트에서 문제를 수정하고, 환경을 초기화한 후 재테이크하세요. 재테이크는 저렴합니다.
7. 전달 및 정리
- 전달. 비디오를
$P/<slug>.mp4로 복사하고open하세요. 이전 버전이 있으면 덮어쓰지 말고 이름을 바꿔 보관하세요(예:old-<voice>-<slug>.mp4). - 보고. 길이, 해상도, 챕터, 음성, 녹화 위치, 표시된 모든 단순화, 확인할 수 없었던 사항(오디오), 남은 시각적 결함을 알려주세요.
- 정리 전에 물어보세요. 일회용 복사본이나 환경을 제거하기 전,
takes/를 삭제하기 전(프레임은 GB를 차지함) 사용자의 승인을 받으세요. 나중에 재녹화할 수 있도록script.cjs, 설정 및audio/는 보관하세요. - 기록하세요. 작업이 티켓이나 노트 파일에 속하는 경우, 비디오 위치와 복사본 삭제가 보류 중임을 거기에 기록하세요. 해당 파일만 커밋하세요.