Communitygithub.com

remotion-physics-explainer

創建同步、沉浸式單面板 Remotion 物理解釋影片(力學、電磁學、熱力學、光學/波動、量子力學、相對論),採用純 Log2Base2 單階段格式——包含聚焦的單行支配定律重點、全螢幕動畫自由體/場/波模擬與即時遙測於同一畫布、毫秒精準的 WordBoundary 卡拉 OK 字幕,以及快速的 1080p MP4 渲染。每當使用者要求透過 /remotion 解釋物理或動畫化物理定律/系統時使用。

remotion-physics-explainer 是什麼?

Remotion Physics Explainer 是專為 AI 代理(如 Claude、Gemini)設計的技能,能將任何物理概念、定律或問題轉化為沈浸式、影格同步的 1920×1080 30fps MP4 解釋影片。它採用創新的「單面板 Log2Base2 Studio 格式」,所有模擬、方程式與字幕都整合在一個統一的視覺舞台上,而非分割畫面。該技能支援力學、電磁學、熱力學、光學/波動、量子力學與相對論等物理領域,透過 `<SinglePaneStage>` 組件呈現:頂部迷你欄顯示主題與進度;中央全寬 SVG 畫布(1600×680)即時動畫化自由體圖、場線、波前與向量疊加;底部卡拉 OK 風格字幕則根據 TTS 的 WordBoundary 時間戳逐字高亮。主要平台為 Remotion(React 影格動畫框架),相依於 remotion-best-practices 與 uv 技能。運作流程包括腳手架專案、合成神經語音與時間戳、以及渲染最終 MP4,並強調在單一畫布內展示而非講述——同時動畫化力、場、能量交換與即時圖表。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/uzowurumauritius-rgb/remotion-stage/tree/main/skills/remotion-physics-explainer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Remotion Physics Explainer(remotion-physics-explainer)

概述

將任何物理概念、定律或問題轉化為沈浸式、影格同步的 1920×1080 30fps MP4 Remotion 解釋影片,採用單面板 Log2Base2 Studio 格式。

切勿將畫面分割為競爭的並排窗格或堆疊的文字卡片牆。每支影片皆使用一個統一的視覺舞台(<SinglePaneStage>):

  1. 極簡頂部欄(44px,內建於 SinglePaneStage 中):
    • 左側顯示主題標題 + 活躍區段標籤;右側顯示細微的步驟計數器 + 細進度條。
  2. 一個統一的 Log2Base2 舞台(SinglePaneStage — 100% 寬度):
    • 聚焦的單行重點標頭:以 borderBottom: "2px solid #FACC15" 高亮目前口說的物理符號(F, m, a, E, B, λ, Ψ, ΔS)在活躍方程式行中(切勿添加水平內距),並在 triggerFrame 處加上一個緊湊的活躍呼叫標籤(符號 → 物理意義 + SI 單位)。
    • 全寬沉浸式 SVG 畫布(viewBox="0 0 1600 680"):寬敞的即時物理模擬——擺錘、拋物線軌跡、帶電粒子在 $\vec{B}$ 場中彎曲、干涉波前、能量棒傳遞與即時向量疊加——直接在同一開放畫布上動畫化。
  3. 極簡底部字幕欄(VoiceoverCaptionBar — 68px):
    • 由精確的 TTS WordBoundary 時間戳驅動的乾淨居中卡拉 OK 逐字高亮字幕。

相依性

  • remotion-best-practices(~/.gemini/skills/remotion/SKILL.md):必須遵守所有 Remotion 動畫規則(useCurrentFrame(), interpolate(), spring(), <Sequence premountFor>, <Audio>, @remotion/google-fonts,以及零 CSS 轉場)。
  • uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md):執行 uv run --with edge-tts 所需。

快速開始

# 1. 腳手架 Remotion 物理解釋器專案
uv run python3 \
  ~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/path/to/project" \
  --output "/path/to/project/scaffold-status.json"

# 2. 合成自然神經語音 + 精確 WordBoundary 時間戳
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/path/to/project" \
  --beats-json "/path/to/project/beats.json" \
  --voice "en-US-AndrewNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/path/to/project/public/voiceover/manifest.json"

# 3. 渲染最終 1080p 30fps MP4
uv run python3 \
  ~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/path/to/project" \
  --composition-id "PhysicsExplainer" \
  --out-name "PhysicsExplainer.mp4" \
  --concurrency 8 \
  --output "/path/to/project/render-report.json"

沉浸式故事講述與工作流程

  1. 保持 snippet 聚焦(2–4 行),以便 <SinglePaneStage> 每次重點顯示一個活躍方程式和一個活躍符號呼叫標籤。
  2. 在包含連續物理運動(擺錘、波動、場、粒子)的節拍上設定 "motionStepFrames": 2。
  3. 展示,而非講述:在同一全寬 1600×680 SVG 畫布內(使用 <clipPath> 處理移動圖表/波動),同時動畫化力、場、能量交換與即時運動圖表,切勿使用分割畫面框。
  4. 務必執行 npm run lint,使用 read_file 檢查代表性靜止影格(npx remotion still),並將最終 .mp4 儲存至 out/、專案根目錄以及工作區根目錄。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

remotion-code-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for source code (Mobile/Web UI, Backend, AI/ML, Algorithms) in a pure Log2Base2 single-stage format—with a focused single-line code spotlight, full-screen animated memory boxes, pointer arrows, data packets, and live execution state on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain code with /remotion, build a code walkthrough video, or turn a voiceover script into an MP4 explainer.

remotion-electronic-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Electronic Engineering (Semiconductors, PN Junctions, Diodes, BJTs, MOSFETs, CMOS Logic, Op-Amp IC Stages, ADC/DAC, PCB Signal Integrity) in a pure Log2Base2 single-stage format—with a focused single-line device equation spotlight, full-screen animated carrier/channel diagrams and live I-V curves on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain electronic engineering, semiconductors, transistors, or analog/digital ICs with /remotion.

remotion-math-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Mathematics (Calculus, Linear Algebra, Differential Equations, Probability, Proofs) in a pure Log2Base2 single-stage format—with a focused single-line equation spotlight, full-screen 3Blue1Brown x Log2Base2 animated geometric/data motion graphics, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain math with /remotion, animate a derivation or theorem, or turn a math script into an MP4 explainer.

remotion-software-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Software Engineering (System Design, Distributed Systems, Microservices, Kubernetes/Docker, Design Patterns, Database Internals, CI/CD, Networking) in a pure Log2Base2 single-stage format—with a focused single-line contract/YAML spotlight, full-screen animated architecture flows with traveling request packets and live trace timelines on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain software engineering, system design, or architecture with /remotion.

相關技能