Communitygithub.com

Sachin-pro-dev/PITCHFRAME-push-to-prod

ローンチビデオ用のRemotionシーンプランを生成し、MP4にレンダリングします。ビートコンポーネントで表現できない場合にのみ拡張します。Pitchframeがコード生成とレンダリングのステップで使用します。

PITCHFRAME-push-to-prod とは?

このスキルは、Pitchframeのローンチビデオ生成パイプラインにおいて、ブリーフからplan.jsonを生成し、Remotionを使用してMP4にレンダリングする役割を担います。参照プロジェクトで定義されたビデオ文法に従い、データ駆動でビデオを構成するため、コンポーネントの直接編集は最小限に抑えることを原則としています。特に、4パート(セットアップ、ヒーロー、ペイオフ、CTA)の構成、厳密なフレーム演算、そしてカラーパレットの自動生成による一貫性が重視されています。レンダリング失敗時にはデータを修正し、コンポーネントを書き換えないという堅牢な設計思想に基づいています。対応プラットフォームはClaude Code, Cursor, Codexなど、RemotionとNode.js環境で動作する開発者ツールです。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Sachin-pro-dev/PITCHFRAME-push-to-prod/tree/HEAD/skills/pitchframe-remotion

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コード生成とレンダリング

あなたはブリーフをplan.jsonに変換し、それをレンダリングします。参照プロジェクトはすでにローンチビデオの文法を実装しており、あなたはそれにデータを渡すだけで、ビデオをゼロから書くわけではありません。

参照プロジェクトの洗練度は、このツールが生成するすべてのビデオの洗練度です。 したがって、強力なデフォルトは次のとおりです。plan.jsonを書き、他は変更しないこと。個々の実行に追加するアニメーションの1行1行は、次のビデオには決して届かないポリッシュであり、レンダリングを壊す新しい方法です。

ファイルマップ

pitchframe/
├── plan.json               ← シーンプラン。これがビデオです。
├── palette.json            ← 抽出された色。データであり、散文ではありません。
├── public/assets/*.png     ← キャプチャされたスクリーンショット。
├── scripts/
│   ├── extract-palette.mjs ← tailwind → CSS vars → ライブURL
│   ├── apply-palette.mjs   ← palette.jsonからsrc/theme.tsを書き込み
│   └── capture.mjs         ← 開発サーバー + Playwrightキャプチャ
├── src/
│   ├── Root.tsx            ← LaunchVideoコンポジションを登録
│   ├── LaunchVideo.tsx     ← ビートをSequencesにマッピング。クロスディゾルブを所有。
│   ├── theme.ts            ← 生成済み。すべての色がここで解決されます。
│   ├── lib/
│   │   ├── types.ts        ← プランのコントラクト
│   │   └── motion.ts       ← イージング、フェード、クリックパルス、ホールドドリフト
│   ├── components/         ← Background, Cursor, FocusOverlay, Zoom, Panel, …
│   └── scenes/
│       ├── TypographyBeat.tsx
│       ├── InteractionBeat.tsx   ← ヒーローモーメント
│       ├── UIBeat.tsx
│       └── CTABeat.tsx
└── output.mp4

プランの作成

構造とスキーマについてはpitchframe-launch-videoをロードしてください。簡略版:

  • 4つのパート — セットアップ、ヒーロー、ペイオフ、CTA。この順序で。常に。
  • 正確に1つのinteractionビート、そしてそれは少なくともフレームの30% を占めます。
  • 時間はデフォルトではなく、ブリーフ内のthesis_weightから取得します。
  • video_thesisとhero_momentをプランにコピーして、批評パスが動画を主張に対してチェックできるようにします。

レンダリング前に計算を正しく行う

レンダリングの失敗は2分のコストがかかります。ビートがずれたプランは、再レンダリングに加えて、それに気づくまでの時間がかかります。毎回手動で確認してください:

  • ビートは連続している — 各frames[0]は前のframes[1]と等しい。
  • 最初のビートは0から始まり、最後のビートは正確にtotal_framesで終わる。
  • total_frames === duration_seconds * fps。
  • タイポグラフィビートは45フレーム未満なし。
  • インタラクションビートはtotal_framesの30%以上。

座標を推測せず、理由を考えて決める

target_element.coordinatesとzoom_targetはスクリーンショットのパーセンテージです。これらは興味深いピクセルがどこにあるかという主張であり、焦点が10%ずれるとヒーローショットが空のクロームに集中してしまいます。

スクリーンショットを開き、要素を見つけ、パーセンテージに変換し、結果がビートが表示しようとしているものと一致するか確認してください。アクションの結果がターゲット以外の場所で発生する場合(ドラッグの目的地、更新されるフィールドなど)、zoom_targetをカーソルが触れたものではなく、結果 に向けてください。

色:プランにもコンポーネントにも決して入れない

theme.tsはapply-palette.mjsによってpalette.jsonから生成されます。色が書き込まれるのはここだけです。

node pitchframe/scripts/extract-palette.mjs      # → palette.json
node pitchframe/scripts/apply-palette.mjs        # → src/theme.ts

これに従うルール:

  • plan.jsonに色を決して入れないでください。 プランはどの単語が強調されるかを示し、テーマは強調色が何かを示します。
  • コンポーネントにカラーリテラルを決して入れないでください。 テーマが公開していない色合いが必要な場合は、ジェネレーターに派生トークンを追加して、将来のすべてのビデオでもそれを取得できるようにします。
  • theme.tsを手動で編集しないでください。 次回の生成で上書きされます。

2つの製品のビデオが同じように色づけされているように見える場合、theme.tsが再生成されていません。それが他の何かに触れる前に最初に確認すべきことです。

レンダリング

cd pitchframe && npx remotion render LaunchVideo output.mp4

3つのチェックを事前に行うことで、1秒のコストで2分のレンダリング失敗を防げます:

  1. plan.jsonがパースできること。上記の計算が成立すること。
  2. プランで指定されたすべてのスクリーンショットがpublic/assets/に存在すること。インタラクションビートには**before_screenshotとafter_screenshotの両方**が必要です。
  3. node_modulesがpitchframe/に存在すること。存在しない場合は、そこで最初にnpm installを実行します。

20秒のビデオで20〜60秒を見込んでください。

レンダリングが失敗した場合

何かを変更する前に実際のエラーを読んでください。

症状原因修正
Cannot find module '../plan.json'スキャフォールドが不完全npx pitchframe install を再実行
Cannot find name 'ACCENT' 等theme.tsが生成されていないapply-palette.mjs を実行
フォントの遅延レンダリングタイムアウトオフライン、またはGoogle Fontsにないフォントpalette.jsonでfonts.sansをInterに設定し再生成
画像デコードエラースクリーンショットが壊れているか不完全そのショットを再キャプチャ
コンポジション時間の不一致total_framesがビートと一致しない計算を修正
OOM / Chromeクラッシュ巨大なスクリーンショット幅約4000px以上のものをダウンスケール。--concurrency=2

レンダリングの失敗に対して、コンポジションを書き換えて対応しないでください。データを修正してください。

レンダリングが2回失敗したら、停止して証拠を保持してください。 plan.json、palette.json、およびアセットをそのままにして、どのファイルを確認すべきかを示してください。調査可能なプランがある失敗したレンダリングは復旧可能ですが、書き換えで「修正」されたものは復旧できません。

コンポーネントに触れなければならない場合

ビートコンポーネントが本当に表現できないプランが必要な場合のみ。そこにたどり着いた場合の3つのルール:

  1. 追加し、書き換えないこと。 新しいカメラ移動は、lib/camera.tsのSHOTSへのエントリであり、再構築されたコンポーネントではありません。そして、それはpitchframe-motion-languageにリストされている必要があります。そうでなければ、誰もそれを選択しません。
  2. lib/motion.tsとlib/camera.tsを使用すること。 EASE、EASE_OUT、clickPulse、heldDrift、entranceBlurがジャンルです。手動のイージングは、1つのビートが別のビデオから来たように見える原因です。スプリング、バウンス、エラスティックカーブは禁止です。 カメラシステムは正確に1つです。 Stage.tsxの外にperspectiveや3D変換を追加しないでください。このリポジトリには以前2つあり、それらはずれ、ショットは同じ人物によって撮影されたように見えなくなりました。
  3. データ駆動を維持すること。 追加するものはすべて、plan.jsonのフィールドから到達可能でなければなりません。それをトリガーする唯一の方法がコンポーネントの編集である場合、それは一回限りのものであり、参照に属しません。

ここで常に間違っていること:カラーリテラル。製品名やコピーをコンポーネントにハードコードすること。新しいトップレベルコンポジション。1920×1080 / 30fpsのコントラクトを変更すること。アニメーションライブラリをインポートすること。

新しいビートタイプを追加することは、ほとんどの場合間違った答えです。 スキーマには4つしかありません。なぜなら、ローンチビデオには4つ必要だからです。新しいビートタイプは通常、変装した機能ビートであり、スキーマが機能リストを表現できるようになると、プランはそれらを含み始めます。

レンダリング成功後

パスと編集手段を報告してください:

Done. Video ready at ./pitchframe/output.mp4

To edit, just ask:
  "hold the hero moment longer"
  "zoom on the field that changed instead"

編集はpitchframe-editingによって処理され、パイプラインを再実行するのではありません。

関連スキル