Remotion ソフトウェアエンジニアリング解説 (remotion-software-explainer)
概要
システム設計、分散アーキテクチャ、デザインパターン、データベース内部構造、DevOpsワークフローを、フレーム同期された没入型の 1920×1080 30fps MP4 Remotion解説動画に変換します。画面を分割して競合するペインやテキストカードを並べることはありません。すべての動画は 1つの統合ビジュアルステージ (<SinglePaneStage>) を使用します:
- 最小限のトップバー (
44px、SinglePaneStageに内蔵) :- 左側にトピックタイトル + アクティブセクションピル;右側に控えめなステップカウンター + 細いプログレスバー。
- 1つの統合 Log2Base2 ステージ (
SinglePaneStage— 100% 幅) :- 焦点を絞った1行のスポットライトヘッダー: アクティブなスペック/契約行 (
replicas: 3、ConsistentHash、WAL、CircuitBreaker) 内の、読み上げ中の要素をborderBottom: "2px solid #FACC15"(水平方向のパディングは絶対に追加しない) で強調表示します。さらにtriggerFrameにおいて、1つの コンパクトなアクティブコールアウトピル (term→architectural role) を表示します。 - 全面没入型 SVG キャンバス (
viewBox="0 0 1600 680"): サービスノード (Client、API Gateway、Load Balancer、Microservices、Message Queue、Cache、DB Shards、K8s Pods) が読み上げに合わせて段階的に表示され、アニメーション化された破線パイプラインで接続されます。移動するリクエストパケット、ライブキャッシュヒット/スループットゲージ、リクエストトレーススパンが、同じ オープンキャンバス上を直接流れます。
- 焦点を絞った1行のスポットライトヘッダー: アクティブなスペック/契約行 (
- 最小限の下部キャプションバー (
VoiceoverCaptionBar—68px) :- TTS の
WordBoundaryタイムスタンプに基づいた、単語単位でハイライト表示されるクリーンな中央揃えのカラオケ字幕。
- TTS の
依存関係
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"
没入型ストーリーテリングとワークフロー
snippetは焦点を絞って (2〜4行) 記述し、<SinglePaneStage>が 1つの アクティブな契約行をスポットライトで照らし、アーキテクチャノードを段階的に表示できるようにします。フレーム0に15個のボックスを一度に配置しないでください。- 移動するリクエストパケット、フェイルオーバーカスケード、オートスケーリングアニメーションがあるビートには
"motionStepFrames": 2を設定します。 - 示す、語るな: リクエストパケットがノード間を移動する様子を、レイテンシー/キュー/トレースバーのライブデータと共に、同じ 全面
1600×680SVG キャンバス内 (必要に応じて<clipPath>を使用) でアニメーション化します。分割画面のボックスで個別に表現しないでください。 - 必ず
npm run lintを実行し、代表的な静止フレーム (npx remotion still) をread_fileで確認し、最終的な.mp4ファイルをout/ディレクトリ、プロジェクトルート、およびワークスペースルートに保存します。