Communitygithub.com

remotion-software-explainer

创建同步、沉浸式的单画面Remotion软件工程解释视频(系统设计、分布式系统、微服务、Kubernetes/Docker、设计模式、数据库内部原理、CI/CD、网络),采用纯Log2Base2单阶段格式——包含聚焦的单行契约/YAML高亮、全屏动画架构流程(带有行进请求包和实时追踪时间线),WordBoundary卡拉OK字幕,以及快速1080p MP4渲染。当用户要求用/remotion解释软件工程、系统设计或架构时使用。

remotion-software-explainer 是什么?

此技能将任何系统设计、分布式架构、设计模式、数据库内部原理或DevOps工作流转化为沉浸式、帧同步的1920×1080 30fps MP4 Remotion解释视频,采用单画面Log2Base2工作室格式。它使用统一的视觉阶段(<SinglePaneStage>),包含44px的简洁顶部栏、全宽1600×680的SVG画布(带有渐进的矢量服务节点、动画虚线管道、行进请求包、实时缓存命中率/吞吐量仪表盘和请求追踪跨度),以及68px的底部字幕栏(支持逐词卡拉OK高亮)。该技能依赖`remotion-best-practices`和`uv`技能,支持通过CLI命令进行脚手架搭建、语音合成和渲染。它强调通过动画可视化来“展示而非讲述”,避免分割屏幕,确保所有动画元素(请求包、故障转移级联、自动扩展动画)都在同一画布上流畅呈现。

兼容平台✓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% 宽度):
    • 聚焦的单行聚光灯标题:在活动规范/契约行中高亮显示当前语音元素(例如 replicas: 3、ConsistentHash、WAL、CircuitBreaker),使用 borderBottom: "2px solid #FACC15"(绝不添加水平内边距),并在 triggerFrame 处添加一个紧凑的活动标注标签(term → architectural role)。
    • 全宽沉浸式 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. 在包含行进请求包、故障转移级联或自动扩展动画的节拍中,设置 "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.

相关技能