개요
이 스킬은 릴리스 체인지로그를 HyperFrames HTML 기반 렌더링을 사용하여 세련된 비디오 합성물로 변환합니다. 제품 업데이트가 시각적인 발표를 필요로 할 때 사용하세요 — 히어로 프레임, 주요 항목 콜아웃, 배경 패턴을 포함합니다. 입력된 체인지로그 항목을 바탕으로 MP4 파일을 생성합니다.
HyperFrames — 체인지로그 비디오
입력: 체인지로그 .md (테마 + 항목). 출력: 린트-클린, seam-gate-green HyperFrames 프로젝트. 요청 시에만 렌더링합니다.
사용 시기
- 사용자가 체인지로그/다이제스트 마크다운을 제공하고 주간 비디오를 원할 때
- 사용자가 "체인지로그 비디오" 또는 **"주간 다이제스트 비디오"**라고 말할 때
- 사용자가 애니메이션 모의 UI와 음성 해설이 포함된 브랜드 비디오를 원할 때
사용하지 말아야 할 시기
- 사용자가 제품 출시를 원할 때 (
hyperframes-product-launch-video사용) - 사용자가 모션 그래픽을 원할 때 (
hyperframes-motion-graphics사용) - 사용자가 발표자 영상을 원할 때 (
hyperframes-embedded-captions사용)
최우선 원칙: 시각화하라, 나열하지 말라
모든 테마는 실제 UI의 애니메이션 모의 버전 또는 경험의 변화를 묘사하는 신뢰할 수 있는 유사체로 표현되어야 합니다 — 절대 텍스트 불릿을 사용하지 마십시오. 스크립트를 작성하기 전에 모든 테마/항목을 시각화 레지스트리를 통해 라우팅하십시오.
워크플로우
0 · 스킬 자산에서 부트스트랩 (필수)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
그런 다음 references/build-spec.md를 처음부터 끝까지 읽으십시오 — 브랜드 토큰을 정의합니다.
1 · 파싱 + 편집 컷
- 추출: 주간 범위, 헤드라인 통계, 테마, 항목
- 예산: 총 45-60초. 제목 ≤2초, 아웃트로 ≤3.5초, 4개 테마 ≈ 각 9-12초
- 테마당 하나의 히어로 시각화 + 최대 3개의 음성 항목 유지
- 스토리 순서대로 테마 정렬: 주요 기능 → 제품 표면 → 성능 → 안정성
2 · 시각화 라우팅
각 테마에 대해 시각화 레지스트리에서 표면을 선택하고 한 줄을 작성하십시오: 테마 → 표면 → 모의 버전이 수행하는 2-4개의 순차적 동작(각각 스크립트 구문과 연결).
3 · 2계층 스크립트 (음성 vs 디스플레이)
스크립트를 토큰 라인으로 작성하십시오: 대화체, 모든 기술 용어는 spoken 음성 형태를 가지며 display는 표준 철자를 유지합니다. 자막은 display를 표시하고, 음성 해설은 spoken을 읽습니다.
4 · VO + 단어 타임스탬프
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
단어 타이밍은 하드 게이트입니다. 계속 진행하기 전에 vo-words.json이 비어 있지 않고 단어당 start/end가 있는 words: [...] 배열이 있는지 확인하십시오.
5 · 빌드
references/build-spec.md의 지침을 정확히 따르십시오: 브랜드 토큰 + 글꼴 + 애니메이션 배경 인코딩 + 장면 스캐폴드 + 크롬 + 자막 레일. 그런 다음 원칙 순서: 벡터 원장 → seam-stamp → VO 단어의 내부 비트 → seam-gate 검증.
자막은 선택 사항이 아닙니다. 계속 진행하기 전에 captions.json에서 LINES 배열을 채우십시오.
6 · 게이트 (제시하기 전에 모두 통과해야 함)
hyperframes check— 0 오류seam-gate.mjs verify— 0 실패- 미리보기 서버 재시작, 3-4개 비트 샘플 확인
- 사용자가 요청하지 않는 한 렌더링하지 마십시오
- 자막 존재 게이트 — 3-4개 프레임 샘플, 자막 레일 가시성 확인
반합리화 표
| 합리화 | 현실 |
|---|---|
| "UI 변경 사항에 대한 불릿 포인트 슬라이드" | 변경 사항을 연기하는 표면을 모의 버전으로 표현 |
| "표현할 수 없는 항목에 대한 가짜 UI" | 정직한 체크리스트 장면 |
| "TTS 텍스트에 일반 'JSON'" | 전문 용어집 음성 형태; 디스플레이는 표준 유지 |
| "발음 추측" | 질문하고, 전문 용어집을 확장 |
| "모든 체인지로그 항목 말하기" | 테마당 ≤3개; 다이제스트 링크가 나머지를 전달 |
| "모든 곳에 녹색 악센트" | 장면당 하나의 녹색 순간 |
| "이전 비디오의 index.html에서 시작" | master-skeleton.html을 항상 복사 |
| "빈 LINES 배열은 괜찮음" | 빈 LINES = 자막 없는 선적 = 재실행 |
검증
-
hyperframes check통과 (0 오류) -
seam-gate.mjs verify통과 (0 실패) - 3개 이상의 샘플 프레임에서 자막 레일 가시성 확인
- 단어 타임스탬프가 오디오와 일치
- 브랜드 토큰이 build-spec.md와 일치
- 사용자가 명시적으로 요청할 때만 렌더링