Remotion → HyperFrames
概要
Remotion(Reactベース)動画コンポジションをHyperFrames(HTML + GSAP)コンポジションに変換します。ほとんどのRemotionイディオムには直接的なHyperFrames相当品が存在し、典型的なコンポジションの約80%は機械的に変換可能です。このスキルはマッピングをエンコードし、HFのシーク駆動モデルに適合しないパターンの変換を拒否し、代わりにPR #214のランタイム相互運用パターンを推奨することで、損失が発生する20%を防止します。
このスキルには階層型テストコーパス(T1〜T4、計4フィクスチャ)が同梱されており、測定されたSSIMしきい値に対して変換品質を評価します。評価を実行せずに変換を行わないでください — 「正しく見える」変換でも、検証済みベースラインより0.05低いSSIMでレンダリングされる場合、それは暗黙的に誤っています。
使用タイミング
このスキルは、ユーザーが明示的に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を出力します:
- コンポジションの
data-composition-id、`data-start=