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%は機械的に翻訳可能です。このスキルはそのマッピングをエンコードし、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コンポジションをRemotion へ(または他のフレームワークへ)エクスポートし直すのはワークフローではありません — 翻訳はRemotion → HyperFramesのみです。その旨を明確に伝えてください。
- 非Remotionソース。 After Effectsプロジェクト(
.aep)、Framer Motion / プレーンReact / CSSアニメーション、またはその他のツールのソースはRemotionコンポジションではありません — 翻訳すべきRemotionソースが存在しません。/general-videoでネイティブに再作成するか、HyperFramesで表現できない場合は拒否してください。
迷った場合は、/general-video(一般的な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。
ブロッカーが発生した場合、停止します。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状態を設定します。 - 最後に1つの
<script>タグ。gsap.timeline({paused: true})を1つ含みます。すべてのRemotionのuseCurrentFrame()派生は、このタイムライン上の適切なオフセットでのtweenになります。 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のシーク駆動モデルにおける決定論的なフレームキャプチャの対象ではありません。ランタイム相互運用パターンを推奨します。 - HyperFramesと一緒にRemotionのレンダリングパイプラインを実行しません。 それはPR #214のランタイム相互運用パターンです — このスキルのリントに失敗するコンポジションのための別のソリューションです。
(@remotion/lambda はブロッカー ではありません — Lambda設定はデプロイメントであり、アニメーションではありません。スキルはそれを警告として削除し、残りを翻訳します。references/escape-hatch.md を参照。)
自分の翻訳を評価する方法
テストコーパスオーケストレータを実行します:
./assets/test-corpus/run.sh
T1、T2、T3(レンダリング+差分)およびT4(リント検証)を実行し、ティアごとの合格/不合格テーブルを出力し、集約JSONレポートを生成します。これを使用して、クリーンチェックアウトでスキルがエンドツーエンドで動作していることを確認し、リファレンスを編集した後の回帰チェックとしても使用します。
検証済みベースライン(2026-04-27現在):
| ティア | コンポジションの形状 | 平均SSIM | 閾値 |
|---|---|---|---|
| T1 | 単一要素フェードイン | 0.974 | 0.95 |
| T2 | マルチシーン + spring + オーディオ + イメージ | 0.985 | 0.95 |
| T3 | データ駆動、カスタムサブコンポーネント、カウントアップ | 0.953 | 0.90 |
| T4 | エスケープハッチ(8つのリントケース) | 8/8 合格 | n/a |