Communitygithub.com

remotion-software-explainer

建立同步、沉浸式的單面板 Remotion 視覺解說影片,用於軟體工程主題(系統設計、分散式系統、微服務、Kubernetes/Docker、設計模式、資料庫內部、CI/CD、網路)。採用純 Log2Base2 單階段格式:聚焦的單行合約/YAML 亮點、全螢幕動畫架構流程(含移動請求封包與即時追蹤時間軸)、逐字卡拉 OK 字幕,以及快速 1080p MP4 渲染。當使用者要求以 /remotion 解釋軟體工程、系統設計或架構時使用。

remotion-software-explainer 是什麼?

此技能能將任何系統設計、分散式架構、設計模式、資料庫內部機制或 DevOps 工作流程,轉換成同步、幀數精準的 1920×1080 30fps MP4 Remotion 解說影片,採用「單面板 Log2Base2 工作室格式」。它從不使用分割畫面或堆疊的文字卡片牆,而是透過 `<SinglePaneStage>` 元件提供統一的視覺舞台。影片結構包含一個簡潔的頂部資訊列(顯示主題與進度)、一個完整的 SVG 畫布(用於動畫呈現服務節點、請求封包與即時指標),以及一個底部卡拉 OK 字幕列。此技能支援 Claude Code、Cursor 和 Codex 等 AI 代理平台,並能透過 CLI 工具(scaffold、synthesize-voiceover、render-mp4)自動化處理整個流程,從專案初始化到最終影片輸出。其核心優勢在於「展示而非告知」:將架構概念轉化為生動的視覺敘事,非常適合用於技術教學或簡報。

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

在你喜歡的 AI 中提問

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

說明文件

Remotion 軟體工程解說員 (remotion-software-explainer)

概述

將任何系統設計、分散式架構、設計模式、資料庫內部機制或 DevOps 工作流程,轉換成沉浸式、幀數同步的 1920×1080 30fps MP4 Remotion 解說影片,採用 單面板 Log2Base2 工作室格式。

絕不將畫面分割成競爭的並列面板或堆疊的文字卡片牆。每個影片都使用 一個統一的視覺舞台 (<SinglePaneStage>):

  1. 極簡頂部資訊列(44px,內建於 SinglePaneStage):
    • 左側顯示主題標題 + 活躍章節標籤;右側顯示細緻的步驟計數器 + 細進度條。
  2. 一個統一的 Log2Base2 舞台(SinglePaneStage — 100% 寬度):
    • 聚焦的單行重點標題:在活躍的規格/合約行中,以 borderBottom: "2px solid #FACC15" 高亮顯示被口頭說明的元素(例如 replicas: 3、ConsistentHash、WAL、CircuitBreaker),不添加任何水平內距,並在 triggerFrame 時顯示 一個 緊湊的活躍說明標籤(術語 → 架構角色)。
    • 全寬沉浸式 SVG 畫布(viewBox="0 0 1600 680"):漸進式向量服務節點(客戶端、API 閘道器、負載均衡器、微服務、訊息佇列、快取、資料庫分片、K8s Pod)隨口述依序出現,並以動畫虛線管道相連,管道上帶有 移動的請求封包、即時的快取命中率/吞吐量儀表板,以及直接在同一開放畫布上流動的請求追蹤跨度。
  3. 極簡底部字幕列(VoiceoverCaptionBar — 68px):
    • 由精確的 TTS WordBoundary 時間戳驅動的乾淨、居中、逐字高亮的卡拉 OK 風格字幕。

相依性

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md)
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md)

快速開始

# 1. 建立專案骨架
uv run python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/path/to/project" \
  --output "/path/to/project/scaffold-status.json"

# 2. 合成旁白
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-software-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 MP4
uv run python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/path/to/project" \
  --composition-id "SoftwareExplainer" \
  --out-name "SoftwareExplainer.mp4" \
  --concurrency 8 \
  --output "/path/to/project/render-report.json"

沉浸式敘事與工作流程

  1. 保持 snippet 聚焦(2–4 行),以便 <SinglePaneStage> 能高亮 一個 活躍的合約行,並逐步揭示架構節點——絕不在第 0 幀就傾倒 15 個方塊。
  2. 對於包含移動請求封包、故障轉移串聯或自動擴展動畫的 beat,設定 "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-physics-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Physics (Mechanics, Electromagnetism, Thermodynamics, Optics/Waves, Quantum Mechanics, Relativity) in a pure Log2Base2 single-stage format—with a focused single-line governing law spotlight, full-screen animated free-body/field/wave simulations and live telemetry on one canvas, millisecond-accurate WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain physics with /remotion or animate a physical law/system.

相關技能