生動画からリール
実績あり:Linux Day 2 と Linux Day 1(効果音付き)の2本のリール。 library/Reel.tsx は Day 1 のリールです。そのパターンをコピーしてください。新しいスタイルを発明しないでください。
macOS および Linux / Windows WSL で動作します。セットアップ:リポジトリの README.md を参照してください。
必須ルール
- すべてのオーバーレイは
work/words.txtの秒数を基準にタイミングを合わせます。時間を推測しないでください。 src/(ライブラリ)内のコンポーネントのみを使用します。ライブラリコンポーネンがビートに合わない場合にのみ、新しいコンポーネントを追加します。- 顔ははっきり見えるようにします。セーフゾーン(1080x1920):
- 上部のタグとタイトル:y 90~400。
- 顔と首:y 約450~1350。ここには、全画面タイトルカード(最大3秒)以外何も配置しません。
- その他はすべて首の下(シャツの一番上のボタン)に配置:y 1360~1880。
PanelはBELOW_NECK(1360)から始まります。fitを使用して縦長のパネルをスケーリングし、1880 までに収めます。 - 新しい動画ごとにネックラインを見つける:y グリッド付きのフレームを取得して確認します。
ui.tsxのBELOW_NECKを更新します。
- ユーザーがチャットで要求しない限り、動画全体をレンダリングしないでください。
scripts/stills.shを使用して確認します。フックがRENDER_OK=1なしでのremotion renderをブロックします。 - ユーザーに確認せずに何もダウンロード(モデル、フォント、音楽、サウンドパック)しないでください。
- デバッグする前に、
reference/known-problems.mdを読んでください。 - OpenCode では、プラグイン
~/.config/opencode/plugins/reel-from-rawが Claude フック(レンダリングブロック、タイプチェック、スチルリマインダー)と同じ処理を行います。シート画像は read ツールで開いてください。モデルが画像を見られない場合は、ユーザーにシートを確認するよう依頼してください。
スコープルール(厳守)
- ユーザーが依頼したことだけを行います。リクエストに必要なファイルと値のみを変更します。
- チェック(タイプチェック、スチルチェック、フックまたはプラグインからのリマインダー)は、あくまでチェックです。このファイルまたは
reference/style-spec.mdのルールに違反するものだけを修正します。チェックが原因で、スタイルの変更、コンポーネントの追加、シーンの追加、テキスト、タイミング、音量の変更は絶対に行わないでください。 - 他に変更すべき点があると思われる場合は、1行でユーザーに伝えてください。変更しないでください。
- 動画を編集中に
~/.claude/skills/reel-from-raw/(このスキル)を編集しないでください。動画プロジェクトのみを編集します。 - 作成したテストファイル(例:
src/__probe.ts)は、終了前に削除する必要があります。
ワークフロー(新しい動画)
各ステップを実行します。各スクリプトは、成功時に OK: を出力します。 ERROR が発生した場合は停止して修正します。
| # | ステップ | コマンド / アクション |
|---|---|---|
| 1 | プロジェクト作成 | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (例:~/Coding/motion-videos/<name>)。ライブラリ、サウンドファイル、フックをコピーし、npm パッケージをインストールします(または $REEL_SEED からクローンします)。 |
| 2 | 文字起こし | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (英語のみの場合は en を使用)。その後、reference/glossary.md を使用して聞き間違いを修正します。 |
| 3 | 無音カット | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>。 --start/--end を使用して、誤った開始や末尾を削除します。 |
| 4 | ビートシート | reference/beat-sheet-prompt.md に従います。 work/beats.md を記述します。ユーザーが計画を承認したい場合に表示します。 |
| 5 | ビルド | src/Reel.tsx は Day 1 のリールです。ビートシートからこれを書き換えます。 Root.tsx で、id(例:LinuxDay3)と実際の handle を設定します。リールで使用しないシーンコンポーネントを削除します。 At ヘルパーと r() ヘルパーは保持します。 |
| 6 | 型チェック | 自動:編集のたびにフックが tsc --noEmit を実行します。報告されたすべてのエラーを修正します。 |
| 7 | ビジュアルチェック | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto を実行し、すべての out/stills/sheet*.jpg を読み取ります。ビートフレームも確認します:stills.sh <dir> 120,450,...。 reference/style-spec.md と照らし合わせて確認します。修正して繰り返します。 |
| 8 | サウンドチェック | 効果音はコンポーネントに付属しています(「効果音」を参照)。 public/sfx/typing.wav と public/sfx/pop.wav が存在することを確認します。ユーザーが要求しない限り、表以外の音を追加しないでください。 |
| 9 | プレビュー | プロジェクト内で npx remotion studio --no-open --port <free> を実行する launch.json エントリを追加します。ユーザーに URL http://localhost:<port> を提供します。ユーザーはそこで音声を聴きます。 |
| 10 | レンダリング(リクエストがあった場合のみ) | RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle(バックグラウンドで実行、90秒で約3〜5分)。 |
効果音
src/sfx.tsx にすべての効果音が格納されています。 SFX は音の一覧です。 <Sfx src at volume frames name> は、現在のシーケンス内の at フレームで1つの音を再生します。
SFX のキー | ソース | インターネット要否 |
|---|---|---|
whoosh, ding, click, switch, whip | @remotion/sfx (remotion.media 上のファイル) | はい(Studio とレンダリング用) |
pop | public/sfx/pop.wav (コードで生成) | いいえ |
typing | public/sfx/typing.wav (scripts/make-typing-sound.py で生成) | いいえ |
ライブラリコンポーネントはすでにこれらの音を再生します。手動で追加する必要はありません。
| タイミング | ファイル(プロジェクト内) | 音 | 音量 |
|---|---|---|---|
| フックタイトル / サブチップ | scenes/Intro.tsx (Hook) | whoosh / whip | 0.54 / 0.48 |
| 日付タイトルカード | scenes/Intro.tsx (DayTitle) | whoosh / ding | 0.6 / 0.36 |
| コマンドリストチップ | scenes/Intro.tsx (CommandList) | チップごとに pop | 0.36 |
| コマンドタグ / コマンド名 | scenes/Commands.tsx (CommandTag) | whoosh / switch | 0.54 / 0.48 |
| メモパッド行 | scenes/Commands.tsx (NoteCard) | 行ごとに typing | 0.6 |
| 下部パネル表示 | ui.tsx (Panel) | pop | 0.48 |
| ターミナルコマンド入力 | ui.tsx (Terminal) | コマンド行ごとに typing | 0.6 |
| ライトリーク | Reel.tsx | whoosh | 0.48 |
| 完了バッジ / フォロークリック | scenes/Outro.tsx (DayDone, FollowCard) | ding / click | 0.48 / 0.72 |
volume のない <Sfx> | sfx.tsx(デフォルト) | - | 0.42 |
音量は 0(無音)から 1(最大)です。すべての音を声より小さく保ってください。
よくあるリクエスト(正確なレシピ)
| ユーザーの依頼 | 正確な手順 |
|---|---|
| 「すべての効果音を N% 上げて/下げて」 | <Sfx 行のすべての volume={x} と、sfx.tsx のデフォルト値に (1 ± N/100) を掛けます。小数点第2位に丸めます。 CutVideo.tsx には触れないでください(それが音声です)。変更前後に grep -rn "<Sfx" src を実行し、変更された値を表示します。 |
| 「キーボード/タイピングの音量だけを変更して」 | src={SFX.typing} の行のみを変更します(ui.tsx の Terminal と scenes/Commands.tsx の NoteCard)。 |
| 「特定の音 X だけを変更して」 | 上の表でその行を見つけます。その volume のみを変更します。 |
| 「キーボードの音が弱い / 新しい音を作って」 | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav。最初に古いファイルのコピーを保管してください。ユーザーが異なる感触を要求した場合にのみ、スクリプト内の数値を編集します。 |
| 「音を削除して」 | 該当する <Sfx .../> 行を削除します。 |
| 「レンダリング前にどこで聴ける?」 | Studio(ステップ9)。再生または Space キーを押します。Studio は編集を保存するたびに自動的にリロードします。 |
| 「自分でレンダリングするには?」 | ターミナル: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle。Studio UI:レンダーボタン(タイムライン上部のバーの右端)→ Video タブ → Output name を設定 → Render video。進捗は Jobs タブに表示されます。OpenGL 設定はすでに angle です。 |
| 「レンダリングして」 | ステップ10、RENDER_OK=1 を使用。その後、出力ファイルのフルパスを提供します。 |
| 「ハンドルを変更して」 | Root.tsx の defaultProps.handle。 |
タイミングの仕組み
src/timeline.ts:CUTS(削除された生の秒数)、out(sec)は、生の秒数を出力フレームにマッピングします。<At from={rawSec} to={rawSec} name="...">は、その発話範囲のブロックを表示します。r(t0, t)は、ブロック内のフレーム遅延を提供し、「t で単語が発話されたときにこれをポップさせる」ために使用します。CutVideoは、セグメントごとにズーム 1.0 / 1.14 を交互に繰り返します(カットごとのパンチイン)。これ以上ズームを追加しないでください。
ライブラリマップ
| ファイル | エクスポート | 用途 |
|---|---|---|
theme.ts | DISPLAY(Anton)、SANS(Inter)、MONO、色 C、extrude() | すべてのテキストと色。新しいフォントや色は追加しない。 |
sfx.tsx | SFX、Sfx | 効果音(上記参照) |
ui.tsx | Pop、useIn、useOut、BELOW_NECK、Panel、TermFrame、Terminal | スプリングポップイン、下半分のパネル、タイプライター風ターミナル |
scenes/Intro.tsx | Hook({title, sub, subAt})、DailyStep({children})、DayTitle({day})、CommandList({commands, line, lineAt})、LightLeak | オープニング、セクション遷移 |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color})、FolderPath、FileGrid、MoveSwap、NoteCard | セクションごとに1つのトピック:上部にタグ、Panel 内にビジュアル |
scenes/Commands.tsx(Day 2、ハードコードされたテキスト) | IdCard、OwnerSwap、PhoneApps、Snapshot、TopView、PdfSearch | 再利用する前にテキストの props を追加 |
scenes/Outro.tsx | DayDone({day})、NextDay({day, commands, at})、FollowCard({handle}) | エンディング(NextDay はオプション) |
Reel.tsx | Reel | Day 1 リール全体。構造の例として使用。 |
テキストを変更する際は、サイズ、色、アニメーションを維持してください。