Remotion → HyperFrames
概要
Remotion(React ベース)の動画コンポジションを HyperFrames(HTML + GSAP)のコンポジションに変換します。ほとんどの Remotion イディオムには直接対応する HyperFrames の同等機能があり、典型的なコンポジションの約80%は機械的に変換可能です。このスキルはそのマッピングをコード化するとともに、損失が大きい20%のパターンについては変換を拒否し、代わりに PR #214 のランタイム相互運用パターンを推奨することで対応します。
このスキルには 階層化テストコーパス(T1~T4、合計4つのフィクスチャ)が付属しており、測定された SSIM 閾値に基づいて変換結果を評価します。評価を実行せずに変換を行わないでください——「見た目が正しい」ように見えても、検証済みベースラインより SSIM が0.05低い変換は、暗黙のうちに誤っています。
使用するタイミング
このスキルは、ユーザーが明示的に Remotion からの移行を依頼した場合にのみ使用します。 トリガーとなるフレーズの例:
- 「Remotion プロジェクトを HyperFrames に移植して」
- 「この Remotion コードを HyperFrames に変換して」
- 「Remotion から移行したい」
- 「この Remotion コンポを翻訳して」
- 「これを HyperFrames HTML として書き直して」
以下の場合はこのスキルを使用しないでください:
- (a) ユーザーが 新しい HyperFrames コンポジションを作成している場合(類似の Remotion 動画を A/B テストしている場合も含む)
- (b) ユーザーが移行を依頼せずに Remotion に言及しただけの場合
- (c) ユーザーが変換を依頼せずに参考資料として Remotion コードを共有した場合
- (d) ユーザーがソースの移行を明示的に依頼せずに「Remotion の動画と同じものを」と依頼した場合——これは新しい HyperFrames ビルドとして扱います
迷った場合は、hyperframes スキルを使用してネイティブの HyperFrames コンポジションを作成することをデフォルトとします。
ワークフロー
ステップ 1: ソースのリント
Remotion ソースディレクトリに対して scripts/lint_source.py を実行します。リントは、クリーンに変換できないパターンを検出します:
- ブロッカー(変換を拒否し、相互運用を推奨):
useState、useReducer、空でない依存配列を持つuseEffect/useLayoutEffect、非同期calculateMetadata、サードパーティ React UI ライブラリ(MUI、Chakra、Mantine、antd、shadcn、Radix、NextUI) - 警告(該当構造を削除した上で変換):
@remotion/lambda設定、delayRender、useCallback、useMemo、カスタムフック - 情報(注釈付きで変換):
staticFile、interpolateColors
ブロッカーが1つでも発火した場合は 停止 します。references/escape-hatch.md を読み、推奨メッセージを表示します。警告は変換を停止しません——ステップ3で該当構造を削除し、そのギャップを TRANSLATION_NOTES.md に記録します。@remotion/lambda 設定は典型的な警告ケースです。スキルはインポートと renderMediaOnLambda(...) 呼び出しを削除しますが、コンポジションの残りの部分は変換します。
ステップ 2: 変換計画の立案
references/api-map.md を読みます——これはすべての Remotion API とその HF 相当機能、またはトピック別リファレンスへの索引です。ソースで使用されている内容に基づいて、必要なトピックリファレンスを特定します:
| ソースに含まれるもの | 読み込むリファレンス |
|---|---|
Composition、defaultProps、schema、calculateMetadata | parameters.md |
Sequence、Series、Loop、AbsoluteFill、Freeze | sequencing.md |
useCurrentFrame、interpolate、spring、Easing、interpolateColors | timing.md |
Audio、Video、Img、IFrame、staticFile、delayRender | media.md |
TransitionSeries、@remotion/transitions | transitions.md |
@remotion/lottie | lottie.md |
@remotion/google-fonts/<Family>、Font.loadFont、@font-face | fonts.md |
すべてを読み込まないでください——特定のソースに必要なものだけを読み込みます。
ステップ 3: HF コンポジションの生成
index.html を出力します:
- ルート `<div id=