Sci-Glow Video Skill (발광선묘 과학 비디오 전 제작 워크플로우)은(는) 무엇을 하나요?
개요
하드코어 과학 주제를 '한 문장 아이디어'에서 안정적으로 60초(또는 지정 시간) 발광선묘 과학 애니메이션 완전한 제작물로 변환합니다: 순수 텍스트 내레이션, 문헌 검증표, 정확한 싱크 자막, 60fps 모션 블러 마스터 MP4, 가로/세로 4K 안전 영역 커버, 그리고 플랫폼별 운영 문안.
핵심 철학: 하드 퀄리티 게이트 자동 재작업(양적 밝기 + 제로 BOM 체크섬 + 독립 읽기 전용 서브 에이전트 블라인드 리뷰 ≥ 8.5점), P0/P1 결함이나 과다 노출 회색 화면이 존재할 때 마스터 렌더링을 절대 강제하지 않습니다.
종속성
이 스킬은 다음 상위 기능을 조정 및 강화하며, 기본 엔진을 재구현하지 않습니다:
Lead-지식 설명 애니메이션(lead-knowledge-animation): 결정적 Canvas/DOM 런타임(motion.js,kit.js)과 기본 스캐폴드(new_film.mjs,beats.py,timeline.py,fonts.py,sfx.py,mix.py,render.mjs,cover.mjs,verify.mjs,qa_video.py,review_pack.py)를 제공합니다. 출처:AzenYes/leaderai-media-toolkit.Lead-자체 미디어 구술 대본(lead-media-script): 콜드 오프닝 훅 문법, 일상적인 유추 표현 구조, 그리고 비리빌리/틱톡/위챗 비디오/샤오홍슈/YouTube 플랫폼별 게시 문서 규격을 제공합니다. 출처:AzenYes/leaderai-media-toolkit.uv(uv run): 이 스킬과 함께 제공되는 순수 표준 라이브러리 보조 CLI 스크립트scripts/sci_glow_cli.py를 실행합니다.- 선택적 과학 연구 검색 스킬 (호스트에 설치된 경우 우선 호출):
pubmed-database또는literature-search-openalex, 권위 있는 논문 저널과 실제 수치 확인용; 설치되지 않은 경우 웹 검색을 사용하여 1차 문헌 확인.
빠른 시작
# 1. 환경 및 IBM Plex Sans SC 8폰트 두께 자체 점검 (글꼴 누락 시 자동 속도 제한 다운로드)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json
# 2. 사용자 MP3의 스펙트럼 하이라이트 계산, Top-3 시작 지점 및 사전 사이드체인 파라미터 출력
uv run <skill_dir>/scripts/sci_glow_cli.py analyze-bgm --bgm "<BGM.mp3>" --target-duration 60 --top-k 3 --output work/bgm_analysis.json
# 3. 프로젝트 이중 디렉토리 초기화 및 안전 기본 파라미터 작성 (3:4 1080x1440 및 bloom 0.26 포함)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<프로젝트 루트 디렉토리>" --date 20261118 --topic 광유전학 --ratio 3x4 --output work/scaffold.json
유틸리티 스크립트
모든 보조 계산은 scripts/sci_glow_cli.py를 통해 제공되며, --output을 사용하여 UTF-8 BOM 없는 JSON을 작성하고, 터미널에 대량의 원시 로그를 출력하는 것을 금지합니다:
| 서브 명령 | 핵심 기능 | 필수 매개변수 |
|---|---|---|
preflight | Node 18+, FFmpeg, Chrome, Playwright 확인 (npmmirror 안내 + 브라우저 중복 다운로드 방지), 상위 두 스킬 및 IBM Plex 8폰트 두께 확인; --auto-fix-fonts로 누락된 .otf 자동 보완 | --output |
scaffold-project | 口播文案输出/<날짜 주제 과학>/ 및 .code/<날짜 주제 과학 애니메이션>/ 디렉토리 생성, new_film.mjs 실행 및 3:4 크기와 bloom: 0.26 활성화 패치 적용 | --workspace, --date, --topic, --ratio, --output |
analyze-bgm | FFmpeg으로 8kHz 모노 웨이브폼 디코딩, 전체 주파수 RMS + <180Hz 저주파 엔벨로프 추출, Drop 1(제목 카드) → Breakdown → 최종 하이라이트 Drop 검색, Top-K --music-start 및 --music-dips 출력 | --bgm, --target-duration, --top-k, --output |
validate-lines | UTF-8 BOM 검증/제거, 1080px 너비에서 글자 수 확인 (훅 <=12자, 자막 <=15자), 균형 괄호, 문장 끝 구두점 없음 및 5s 훅 상한 확인, 자동 역산산 고정 총 시간 tail | --lines, --target-duration, --ratio, --output (선택 --fix-bom, --apply-tail) |
audit-qa | 상위 qa_video.py 호출 후 골드 핑거프린트(mean 17-20, p99 >= 130, bright <= 3.5%, 제로 데드존, 제로 플리커 프레임)에 따라 신호등 및 파라미터 처방전 생성, 독립 블라인드 리뷰 프롬프트 생성 | --video, --film-dir, --round, --output |
워크플로우
다중 선택 병렬 요구 사항 또는 이중 모델 분할 작업 시 multi-agent-batch-playbook.md를 동시에 로드합니다; 화면 및 레이아웃 파라미터는 visual-and-layout-guardrails.md를 엄격히 준수해야 합니다.
단계 0: 작업 시작 전 환경 점검 및 음악 확인
preflight --auto-fix-fonts --output ...실행; Playwright 누락 시 다음 안내 실행:$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com.- 음악 게이트: 사용자가 곡을 지정한 경우에만 사용; 미지정 및 기기에 적합한 곡이 없는 경우 사용자에게 음악 파일 경로를 추가하거나 순수 음향 효과로 전환하도록 적극적으로 문의 (임의로 건너뛰지 않음).
단계 1: 제로 장벽 대본 작성 및 1차 문헌 확인 (Lead-자체 미디어 구술 대본 재사용)
- 처음 3초는 반드시 구체적인 숫자/반직관적 사실로 주목을 끌고, 이후 일상적인 구체적 유추를 먼저 제시한 후 과학 용어 도입.
- 최소 2–3편의 1차 저널 출처 확인 (
Nature/Science/NEJM/Cell), 데이터 조작 엄금. 口播文案输出/<YYYYMMDD 주제 과학>/디렉토리에 순수 텍스트.txt및 실행 계획.md생성.
단계 2: BGM 스펙트럼 하이라이트 정렬 및 자막 정확한 시간 고정
analyze-bgm --bgm <path> --target-duration <T> --top-k 3 --output work/bgm.json실행하여 최적music_start_sec선택, 상위beats.py로work/beats.json출력.work/lines.json작성: 제목 카드T.at을 Drop 1에, 전환 위기at을 Breakdown에, 돌파 순간at을 최종 하이라이트 Drop에 고정, 끝에 회귀 이미지 마무리 남겨둠.validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.json실행, 모두 녹색 통과 후 상위timeline.py --beats work/beats.json --music-start <start> --film film/실행.
단계 3: 시각 시스템 설계 및 결정적 코드 구현 (Lead-지식 설명 애니메이션 재사용)
[!IMPORTANT] 코딩 및 시각 파라미터는 visual-and-layout-guardrails.md를 반드시 준수:
bloom: 0.20–0.28,K.fog: 0.024–0.028,K.hud.corner비활성화,scenes.js는 IIFE로 래핑, 전환 제목은mode: 'rise', blur: 0사용 및+0.36s지연.
- 먼저
scaffold-project실행하여 이중 디렉토리 생성. - 충돌하지 않는 주 색상 팔레트 설계,
film/core.js에서 이 영화 전용 과학 은유를 위해 3–5겹의 발광 정밀 프리미티브 수동 작성 (일반 사각형 카드/막대인간 반복 금지). film/scenes.js,film/index.html및film/cover.html작성, 상위fonts.py film/서브셋 및verify.mjs film/index.html --tol 24전체 포인트 제로 차이 검증 통과.
단계 4: 사이드체인 믹싱 및 이중 버전 4K 커버 안전 영역 검사
- UTF-8 BOM 없음으로
work/cues.json작성,sfx.py --variants 3및mix.py실행 (analyze-bgm이 제공한--music-start및--music-dips입력,-14.0 LUFS / -1.5 dBFS정렬). cover.mjs film/cover.html --out out --name <주제> --guides실행,work/封面检查/이미지를 직접 확인하여 가로 버전 핵심 정보가 중앙4:3(x ∈ [240, 1680]) 내에 엄격히 위치하는지 확인.
단계 5: 30fps 드래프트 양적 검사 + 독립 읽기 전용 서브 에이전트 블라인드 리뷰 루프
자세한 내용은 blind-review-protocol.md 참조.
- 먼저 반해상도 드래프트 출력:
render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4(단일 영화는--workers 8사용 가능, 다중 영화 병렬 시 엄격히--workers 4제한). audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json실행. 밝기 또는 데드존이 기준 미달이면 먼저 처방전에 따라 파라미터를 직접 수정하여 드래프트 재출력.review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1실행, 읽기 전용research블라인드 리뷰 서브 에이전트 파생 (out/review_r1/디렉토리만 읽을 수 있음, 소스 코드는 절대 볼 수 없음) 9차원 점수 매기기 실행.- P0/P1 결함이 하나라도 있거나 **평균 점수
< 8.5**이면 60fps 마스터 출력을 절대 금지하고, 항목별 수정, 자체 점검, 재검토를 모두 녹색이 될 때까지 반복.
단계 6: 60fps 모션 블러 마스터 직접 출력 및 완전한 인도
- 블라인드 리뷰 모두 녹색 통과 후 최종 버전 한 번만 렌더링:
render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<주제>.mp4. audit-qa및qa_video.py --sheet --ref-sheet를 한 번 더 실행, 완성된 영화 연락표를 직접 확인하고out/draft*.mp4임시 드래프트 삭제.Lead-자체 미디어 구술 대본및copy_template.md에 따라work/문안과 커버.md완성, 사용자에게 전체 파일 세트 및 사람 귀 청취가 필요한 오디오 재녹음 시점 목록 제공.
속도 제한
analyze-bgm,validate-lines,scaffold-project,audit-qa는 모두 로컬에서 실행되며 외부 네트워크 요청 없음.preflight --auto-fix-fonts가 CDN에서 누락된.otf글꼴을 가져올 때, 내장 크로스 프로세스 OS 파일 잠금 +time.monotonic()속도 제한기(1.0 req/s) 사용, 5xx 오류에 대해 3회 지수 백오프 재시도, HTTP 429 발생 시RateLimitError를 던지고 요청 종료.
일반적인 실수
- PowerShell UTF-8 BOM으로 인한
mix.py충돌: PowerShell 5.1의 기본Set-Content -Encoding UTF8은EF BB BF파일 헤더를 씁니다. 모든.json은 반드시 Pythonencoding='utf-8',cli도구 또는[IO.File]::WriteAllText(BOM 없음)로 작성해야 합니다. - 기본
bloom: 0.9및mode: 'center'사용으로 인한 흐릿함: 큰 광선 주체에0.9글로우는 반드시bright > 3.5%를 초과하고,center제목의 14px 블러는 라이트 스윕 전환을 망칩니다. 반드시 visual-and-layout-guardrails.md에 따라0.20–0.28로 낮추고rise(blur: 0)로 변경해야 합니다. - 다중 영화 병렬 처리 시 Chromium Workers 과부하 및 '자기 자신 검토': 3–4개 영화 병렬 처리 시 반드시
--workers 4로 속도 제한; 동시에 코드를 작성한 동일 컨텍스트가 자기 평가를 통해 통과시키는 것을 절대 금지하며, 반드시 격리된 디렉토리out/review_rN/의 읽기 전용 블라인드 리뷰 서브 에이전트가 서명하여 통과시켜야 합니다.