Communitygithub.com

Sci-Glow Video Skill (발광선묘 과학 비디오 전 제작 워크플로우)

하드코어 과학 주제를 60fps 발광선묘 애니메이션 풀 패키지(입담 대본, 문헌 검증표, BGM 드롭 싱크 자막, 횡/세로 4K 커버, 플랫폼별 운영 문안)로 안정적으로 전환합니다. 양적 밝기 검사와 독립적 맹검 피드백 루프로 P0/P1 결함 제로 방출이 보장됩니다.

Sci-Glow Video Skill (발광선묘 과학 비디오 전 제작 워크플로우)란 무엇인가요?

이 스킬은 하드코어 과학 주제를 '한 문장 아이디어'에서 60fps 발광선묘 애니메이션 동영상의 완전한 제작물로 변환하는 엔드-투-엔드 워크플로우를 제공합니다. 여기에는 문헌 검증표를 포함한 순수 텍스트 내레이션, BGM 스펙트럼의 드롭 지점과 정확히 동기화된 자막, 60fps 모션 블러 마스터 MP4, 가로/세로 4K 안전 영역 커버, 각 플랫폼(비리빌리, 틱톡 등)에 맞춘 운영 문안이 포함됩니다. 핵심 철학은 '하드 퀄리티 게이트의 자동 재작업'입니다. 픽셀 밝기, BOM 체크섬 및 9차원 독립 읽기 전용 서브 에이전트 블라인드 리뷰 점수(≥8.5)를 기준으로 합니다. 이 워크플로우는 `lead-knowledge-animation`(Canvas/DOM 애니메이션)과 `lead-media-script`(내레이션 템플릿) 위에 구축되며, 단일 질문 또는 배치 다중 선택 프로젝트에 사용할 수 있습니다. `uv run`을 통해 `scripts/sci_glow_cli.py` 유틸리티를 사용하여 사전 점검 환경 확인, BGM 분석, 프로젝트 스캐폴딩, 자막 검증, QA 감사(밝기 게이트 포함)를 자동화합니다. 시각적 레이아웃은 발광 파라미터(`bloom` 0.20–0.28), 세로형 3:4 비율의 5존 충돌 방지 레이아웃, 그리고 결함이 발견될 때 60fps 렌더링을 엄격히 금지하는 P0/P1 제로 결함 출시 기준을 규정하는 [visual-and-layout-guardrails.md]를 엄격히 준수해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zy27488/sci-glow-video-skill/tree/HEAD

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

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

문서

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을 작성하고, 터미널에 대량의 원시 로그를 출력하는 것을 금지합니다:

서브 명령핵심 기능필수 매개변수
preflightNode 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-bgmFFmpeg으로 8kHz 모노 웨이브폼 디코딩, 전체 주파수 RMS + <180Hz 저주파 엔벨로프 추출, Drop 1(제목 카드) → Breakdown → 최종 하이라이트 Drop 검색, Top-K --music-start 및 --music-dips 출력--bgm, --target-duration, --top-k, --output
validate-linesUTF-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: 작업 시작 전 환경 점검 및 음악 확인

  1. preflight --auto-fix-fonts --output ... 실행; Playwright 누락 시 다음 안내 실행: $env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com.
  2. 음악 게이트: 사용자가 곡을 지정한 경우에만 사용; 미지정 및 기기에 적합한 곡이 없는 경우 사용자에게 음악 파일 경로를 추가하거나 순수 음향 효과로 전환하도록 적극적으로 문의 (임의로 건너뛰지 않음).

단계 1: 제로 장벽 대본 작성 및 1차 문헌 확인 (Lead-자체 미디어 구술 대본 재사용)

  1. 처음 3초는 반드시 구체적인 숫자/반직관적 사실로 주목을 끌고, 이후 일상적인 구체적 유추를 먼저 제시한 후 과학 용어 도입.
  2. 최소 2–3편의 1차 저널 출처 확인 (Nature / Science / NEJM / Cell), 데이터 조작 엄금.
  3. 口播文案输出/<YYYYMMDD 주제 과학>/ 디렉토리에 순수 텍스트 .txt 및 실행 계획 .md 생성.

단계 2: BGM 스펙트럼 하이라이트 정렬 및 자막 정확한 시간 고정

  1. analyze-bgm --bgm <path> --target-duration <T> --top-k 3 --output work/bgm.json 실행하여 최적 music_start_sec 선택, 상위 beats.py로 work/beats.json 출력.
  2. work/lines.json 작성: 제목 카드 T.at을 Drop 1에, 전환 위기 at을 Breakdown에, 돌파 순간 at을 최종 하이라이트 Drop에 고정, 끝에 회귀 이미지 마무리 남겨둠.
  3. 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 지연.

  1. 먼저 scaffold-project 실행하여 이중 디렉토리 생성.
  2. 충돌하지 않는 주 색상 팔레트 설계, film/core.js에서 이 영화 전용 과학 은유를 위해 3–5겹의 발광 정밀 프리미티브 수동 작성 (일반 사각형 카드/막대인간 반복 금지).
  3. film/scenes.js, film/index.html 및 film/cover.html 작성, 상위 fonts.py film/ 서브셋 및 verify.mjs film/index.html --tol 24 전체 포인트 제로 차이 검증 통과.

단계 4: 사이드체인 믹싱 및 이중 버전 4K 커버 안전 영역 검사

  1. UTF-8 BOM 없음으로 work/cues.json 작성, sfx.py --variants 3 및 mix.py 실행 (analyze-bgm이 제공한 --music-start 및 --music-dips 입력, -14.0 LUFS / -1.5 dBFS 정렬).
  2. cover.mjs film/cover.html --out out --name <주제> --guides 실행, work/封面检查/ 이미지를 직접 확인하여 가로 버전 핵심 정보가 중앙 4:3 (x ∈ [240, 1680]) 내에 엄격히 위치하는지 확인.

단계 5: 30fps 드래프트 양적 검사 + 독립 읽기 전용 서브 에이전트 블라인드 리뷰 루프

자세한 내용은 blind-review-protocol.md 참조.

  1. 먼저 반해상도 드래프트 출력: render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4 (단일 영화는 --workers 8 사용 가능, 다중 영화 병렬 시 엄격히 --workers 4 제한).
  2. audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json 실행. 밝기 또는 데드존이 기준 미달이면 먼저 처방전에 따라 파라미터를 직접 수정하여 드래프트 재출력.
  3. review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1 실행, 읽기 전용 research 블라인드 리뷰 서브 에이전트 파생 (out/review_r1/ 디렉토리만 읽을 수 있음, 소스 코드는 절대 볼 수 없음) 9차원 점수 매기기 실행.
  4. P0/P1 결함이 하나라도 있거나 **평균 점수 < 8.5**이면 60fps 마스터 출력을 절대 금지하고, 항목별 수정, 자체 점검, 재검토를 모두 녹색이 될 때까지 반복.

단계 6: 60fps 모션 블러 마스터 직접 출력 및 완전한 인도

  1. 블라인드 리뷰 모두 녹색 통과 후 최종 버전 한 번만 렌더링: render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<주제>.mp4.
  2. audit-qa 및 qa_video.py --sheet --ref-sheet를 한 번 더 실행, 완성된 영화 연락표를 직접 확인하고 out/draft*.mp4 임시 드래프트 삭제.
  3. 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를 던지고 요청 종료.

일반적인 실수

  1. PowerShell UTF-8 BOM으로 인한 mix.py 충돌: PowerShell 5.1의 기본 Set-Content -Encoding UTF8은 EF BB BF 파일 헤더를 씁니다. 모든 .json은 반드시 Python encoding='utf-8', cli 도구 또는 [IO.File]::WriteAllText(BOM 없음)로 작성해야 합니다.
  2. 기본 bloom: 0.9 및 mode: 'center' 사용으로 인한 흐릿함: 큰 광선 주체에 0.9 글로우는 반드시 bright > 3.5%를 초과하고, center 제목의 14px 블러는 라이트 스윕 전환을 망칩니다. 반드시 visual-and-layout-guardrails.md에 따라 0.20–0.28로 낮추고 rise (blur: 0)로 변경해야 합니다.
  3. 다중 영화 병렬 처리 시 Chromium Workers 과부하 및 '자기 자신 검토': 3–4개 영화 병렬 처리 시 반드시 --workers 4로 속도 제한; 동시에 코드를 작성한 동일 컨텍스트가 자기 평가를 통해 통과시키는 것을 절대 금지하며, 반드시 격리된 디렉토리 out/review_rN/의 읽기 전용 블라인드 리뷰 서브 에이전트가 서명하여 통과시켜야 합니다.

관련 스킬