Remotion から HyperFrames へ
構築前にルートを確認してください。 このスキルは、既存の Remotion (React) コンポジションのソースを HyperFrames に移植するためにのみ使用します。新しいコンポジションを作成する場合 (Remotion ビデオにインスパイアされた場合でも) → 作成ワークフロー
/general-videoを使用します。スコープ外 (一方通行、Remotion のみ): 逆方向のエクスポート (HyperFrames → Remotion または任意のフレームワーク) はなく、非 Remotion ソース (After Effects、Framer Motion、プレーンな React / CSS) には変換する Remotion ソースがないため、/general-videoを使用して再作成します。不明な場合、または Remotion が簡単に言及されているだけの場合? 最初に/hyperframesを読んでください。
概要
Remotion (React ベース) のビデオコンポジションを HyperFrames (HTML + GSAP) コンポジションに変換します。ほとんどの Remotion イディオムには直接的な HyperFrames の同等物があり、一般的なコンポジションの約 80% は機械的に変換可能です。このスキルはマッピングをエンコードし、損失の多い 20% に対して、HF のシーク駆動モデルに適合しないパターンの変換を拒否し、代わりに PR #214 のランタイム相互運用パターンを推奨することで防御します。
このスキルには、階層化されたテストコーパス (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 コンポジションを Remotion (または他のフレームワーク) にエクスポートすることはワークフローではありません — 翻訳は Remotion → HyperFrames のみです。その旨を明確に伝えてください。
- 非 Remotion ソース。 After Effects プロジェクト (
.aep)、Framer Motion / プレーンな React / CSS アニメーション、またはその他のツールのソースは Remotion コンポジションではありません — 翻訳する Remotion ソースがありません。/general-videoを使用してネイティブに再作成するか、HyperFrames で表現できない場合は断ってください。
迷った場合は、/general-video (一般的な HyperFrames 作成フロー) を使用してネイティブの HyperFrames コンポジションを作成することをデフォルトにしてください。
ワークフロー
ステップ 1: ソースを lint する
Remotion ソースディレクトリに対して scripts/lint_source.py を実行します。lint は、クリーンに変換できないパターンを検出します:
- ブロッカー (拒否 + 相互運用を推奨):
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="stage">には、コンポジションのdata-composition-id、data-start="0"、data-duration(秒単位)、data-fps、data-width、data-height、およびスカラープロップごとに 1 つのdata-*を含めます。 data-start/data-duration/data-track-indexを持つシーン div のフラットリスト。- レイアウト用のインライン
<style>。CSS はすべてのアニメーションプロパティのfrom状態を設定します。 - 一番下にある単一の
<script>タグ。これには、一時停止された 1 つのgsap.timeline({paused: true})が含まれます。すべての RemotionuseCurrentFrame()の派生は、このタイムライン上の適切なオフセットでのトゥイーンになります。 window.__timelines["<composition-id>"] = tl;は、タイムラインを HF のランタイムに登録します。
カスタム React サブコンポーネントは、プロップインターフェースをテンプレートとして使用して、繰り返し HTML としてインライン化されます (インスタンスごとの data-* パターンについては parameters.md を参照)。
ステップ 4: 検証する
評価ハーネスを実行します — 完全なガイドは references/eval.md を参照。クイックパス:
# Remotion ベースラインをレンダリング (フィクスチャで npm install した後)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4
# HF 翻訳をレンダリング
cd ../hf-src && npx hyperframes render --skill=remotion-to-hyperframes --output ../hf.mp4
# SSIM 差分
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff
しきい値: ソースの複雑さの階層の p05 より約 0.02 低い値 (eval.md の検証済みしきい値テーブルを参照)。差分が失敗した場合は、scripts/frame_strip.sh を実行して どの フレームが分岐したかを確認し、関連するタイミング/シーケンス/メディアリファレンスを再読してください。
重要: 両方のレンダリングは、一致するピクセル形式を使用する必要があります。Remotion ソースの remotion.config.ts で Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") を設定してください — そうしないと、差分は翻訳の忠実性ではなく、エンコーダの違い (~0.05 SSIM の低下) を測定することになります。
ステップ 5: ギャップを文書化する
クリーンに翻訳されなかったもの (ドロップされたボリュームランプ、近似されたカスタムプレゼンテーション、代替されたフォント) はすべて、HF 出力の隣に TRANSLATION_NOTES.md を配置します。形式については references/limitations.md を参照してください。
このスキルが明示的に行わないこと
- React の状態機械を翻訳しません。
useState+useEffectを介してアニメーションを駆動するコンポジションは、HyperFrames のシーク駆動モデルにおける決定論的なフレームキャプチャターゲットではありません。ランタイム相互運用パターンを推奨します。 - Remotion のレンダリングパイプラインを HyperFrames と一緒に実行しません。 それは PR #214 のランタイム相互運用パターンです — このスキルの lint に失敗するコンポジションのための別のソリューションです。
(@remotion/lambda はブロッカーでは_ありません_ — Lambda 設定はデプロイメントであり、アニメーションではありません。スキルはそれを警告として削除し、残りを翻訳します。references/escape-hatch.md を参照してください。)
自分の翻訳を評価する方法
テストコーパスオーケストレーターを実行します:
./assets/test-corpus/run.sh
T1、T2、T3 (レンダリング + 差分) と T4 (lint 検証) を実行し、階層ごとの合格/不合格テーブルを出力し、集計 JSON レポートを生成します。これを使用して、クリーンチェックアウトでスキルがエンドツーエンドで機能していることを確認し、リファレンスを編集した後のリグレッションチェックとして使用します。
検証済みベースライン (2026-04-27 時点):
| 階層 | コンポジションの形状 | 平均 SSIM | しきい値 |
|---|---|---|---|
| T1 | 単一要素のフェードイン | 0.974 | 0.95 |
| T2 | マルチシーン + spring + オーディオ + 画像 | 0.985 | 0.95 |
| T3 | データ駆動型、カスタムサブコンポーネント、カウントアップ | 0.953 | 0.90 |
| T4 | エスケープハッチ (8 lint ケース) | 8/8 合格 | n/a |