コードアニメーション解説動画
すべての画面はRemotionでコードのみで描画し、音響はPythonで合成します。最初に3つの案とプレビューを提示し、ユーザーが選択したら brief.md を作成し、1カットずつ制作します。
ハードルール
- このスキルの手順のみを使用すること。 他のワークフローやプロジェクトの方法でここに書かれた手順を置き換えないでください。
- 資料は必ず実際のもので、リンク付きであること。 各資料は自分で開くかダウンロードして確認してください。確認できないものは「未確認」とマークし、二次情報の場合は誰が読み取ったかを明記します。数字を作ったり、出典不明の記述を書かないでください。
- 各ステップごとにユーザーの確認を得てから次に進むこと: 資料リスト → 3つの案とプレビュー → サウンドレベル → カバー。
brief.mdを作成したら、ファイルの場所をユーザーに伝えてください。 - ナレーションは付けない(ユーザーから要求があった場合を除く)。情報はすべて画面上のテキストで伝えます。BGMはユーザーが提供したもの(ユーザーが使用権を持つこと)を使用し、効果音は自作してビートに合わせます。リポジトリに音楽ファイルは含めません。
- テキスト:重ならない、見やすい、十分な表示時間、長文のブロックを置かない。画面は豊かにし、主人公(人、動物、物体)は丁寧に描きます。
- デフォルト仕様:横画面 1920×1080、30fps。ユーザーが縦画面/抖音/ショート動画を希望する場合は 1080×1920(
scenes.jsonのstyleを"vflash"に設定)。長さはBGMの長さに合わせます(音楽がない場合は長さとBPMを指定可能)。
作業ディレクトリ
<テーマ>/ 例:~/videos/<テーマ>
demo.mp3 / demo.mp4 ユーザー提供のBGM、参考動画(任意)
source/ sources.md(資料リスト)、ref-notes.md(参考動画分析)、原材料
previews/ plan-a.png、plan-b.mp4、plan-c.png(3つの案のプレビュー)
brief.md 確認済みの完全なプラン、再利用可能なプロンプト
video/ Remotionプロジェクト(new_project.py または new_project.ps1 で生成)
qa/ カットごとの静止画、全編のフレーム抽出、review_log.md
<ファイル名>.mp4 完成動画
カバー/ カバー_3対4_縦.jpg、カバー_4対3_横.jpg
第0ステップ:プロジェクト作成
python <skill>/scripts/new_project.py --project "<テーマディレクトリ>"
# BGMがない場合:... --no-music --duration 60 --bpm 120
Windowsでは scripts/new_project.ps1 も使用可能。このスクリプトは順に以下を実行します:
- 環境チェック(
scripts/check_env.py)。不足しているものがあれば表示します。インストール前にユーザーの同意を得ます。 - 作業ディレクトリを作成。
- テンプレートをコピー。
- フォントをコピー。
- npm install を実行。
- 拍を検出し、
src/grid.jsonに書き込み。 - 初版のミックスを生成。
全体で1〜3分かかります。長時間のコマンドをバックグラウンドで実行する必要がある環境では、バックグラウンドで起動してから出力をポーリングしてください(references/pitfalls.md 参照)。
テンプレートには約12秒の汎用プレースホルダーが含まれており、プロジェクトがレンダリング可能であることを確認するために使用します。テーマを変更したら、シーン、字幕、効果音を書き直す必要があります。完全なマルチシーンの例は examples/bait-color/ にあります(参考用。デフォルトの内容ではありません)。
第1ステップ:何を作るか明確にする
ユーザーは以下のいずれか、または複数を組み合わせて提供できます:
- アイデア:一言のテーマでも構いません。
- 元の内容:記事、原稿、製品URL、コードリポジトリ、データテーブル。
- 参考動画、BGM。
質問は最大3つまで、計画を変えるものに限定します:長さ、アスペクト比、ナレーションの有無、指定のブランドカラーやフォント。ユーザーが指定しなかったものはデフォルト値を使用し、案内の中で明記してユーザーが変更できるようにします。
原材料の処理:
- 科学解説・事実系テーマ:
references/research.mdに従って資料を調査・確認し、source/sources.mdに書き、ユーザーに確認を依頼します。 - 記事・原稿:核心情報、対象読者、必須の事実を抽出します。事実は原材料からのみ取得し、不確かなものは書きません。
- 製品URL:ページを読み、製品名、機能、スローガン、ブランドカラーを記録します。スクリーンショットを取る場合は事前に許可を得ます。
- コードリポジトリ:READMEとキーファイルを読み、機能を抽出。機能を作りません。
- 参考動画:
- リンクは事前に許可を得てからダウンロードします。
ffprobeで仕様を計測。ffmpeg -vf "select='gt(scene,0.3)',showinfo"でカット切り替えポイントを見つけます。- 毎秒1フレームを抽出してコンタクトシートにします。
- カット構成、リズム、配色、フォント、手法を
source/ref-notes.mdに書きます。 - 構造と手法だけ学び、素材や文案はコピーしません。
- BGM:プロジェクト作成スクリプトが既に拍を検出しており、BPM、セクション境界、ドリフトを表示します。案と絵コンテはそれに合わせて構成します。
第2ステップ:3つの案を提示
references/plans.md に従って書き、3つの案の役割は固定です:
| 案 | スタイル | 技術 | 説明方法 |
|---|---|---|---|
| A | FLASHアニメ風(フラットイラスト) | Remotion + SVG フラットイラストコンポーネント | 堅実:質問→実験/データ→結論→3つのポイントを覚える |
| B | ピクセルカセット風(レトロゲーム機+CRTテレビ) | Canvas 2D ピクセルキャンバス → WebGL CRTシェーダー | ゲーム化:カセット選択=レベル選択、HUDでデータ表示、ダイアログボックスで結論、結果画面で結果表示 |
| C | その都度提案:plans.md の候補リストからテーマに最も合うものを選ぶか、Remotionで実現可能な独自案を提案 | A、Bと異なる | 別の説明方法:ワンカット、全編を通しての主人公、逆説、一つの比喩で全体を説明 |
各案には明確に記述する:名前、一言まとめ、スタイル(配色とフォント)、仕様、技術構成、カットごとの画面概要(時間帯付き)、サウンド、予想レンダリング時間、難易度とリスク、そしてなぜこの原材料に合うのか。
3つの案はスタイル、技術、説明方法のいずれも明確に異なり、単なる配色変更であってはなりません。
第3ステップ:各案のプレビュー
video/src/preview/PlanA.tsx、PlanB.tsx、PlanC.tsxで各案を最もよく表すカットを1つ構築します。時間は0から始まり、長さは2〜4秒です。テンプレート内のこれらの3ファイルは汎用プレースホルダーなので、それに従って変更します:- Aは
src/art/、src/ui/のSVGコンポーネントを使用。 - Bは
src/pixel/エンジンを使用し、PixelStageに描画。 - Cは新規作成。
PlanC.tsxの書き方に従い、画面はtのみで決定し、1カットで構築。
- Aは
- 実行:
node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9- デフォルトでは各案のキーフレームを1枚出力。コロンの後はフレームを抽出する秒数。
- 動き自体が売りの案は
B:clipと指定し、3秒のクリップを出力。 - スクリプトはフレームごとの所要時間と全編のレンダリング時間の見積もりを表示。この数値を案内に記入。
- 自分でプレビュー画像を確認:テキストがはみ出していないか、要素が重なっていないか、画面が空すぎないか、3つのスタイルが本当に異なっているか。修正してからユーザーに提出。
- 3つの案のテキストとプレビュー画像をユーザーに提示(プレビュー画像を返信に埋め込む。各アシスタントのやり方は異なる)。ユーザーは1つを選択、混合、または修正を依頼可能。変更があれば第2または第3ステップに戻り、ユーザーが確認するまで繰り返します。
第4ステップ:brief.md を作成
ユーザーが確認したら、references/brief-template.md に従って <テーマ>/brief.md を作成します。7つのブロックで構成:<role> <inputs> <direction> <structure> <build> <gotchas> <start>。確認済みの内容はすべて具体的に書き、デフォルト値を使用した箇所はその旨を明記します。作成後、ファイルの場所をユーザーに伝えます。
以降の制作は brief に厳密に従います。途中で変更が必要な場合は、まず brief を変更し、次にコードを変更します。ユーザーが後でテーマを変更したり、他のツールで使用したりする場合も、この brief をそのまま使用できます。
第5ステップ:カットごとの制作
-
最初に
src/scenes.jsonを作成:styleは"flash"または"pixel"と書き、Root はそれに応じてどの画面セットを使用するかを決定。- シーンテーブルは拍子記号で書き、カット切り替えはセクション境界に配置。
-
各カットに以下の内容を記述:
- FLASH風:
src/scenes/*.tsxにコンポーネントを書き、src/scenes/index.tsで登録。 - ピクセル風:
src/pixel/scenes.tsのPIXEL_SCENESに描画関数(c, f) => voidを記述。 - Cスタイル:第3ステップのプレビューコードを拡張し、
Film.tsxに接続するか、PixelFilm.tsxに倣って別の全編コンポーネントを作成。 - すべてのテキストは
src/captions.jsonに、すべての効果音はsrc/sfx.jsonに書き、同じ拍子記号を使用。
- FLASH風:
-
各カットが終了したら、順に実行:
npm run typechecknpm run check(字幕チェック、問題0が必須)node tools/stills.mjs --out ../qa <進入秒> <主動作秒> <退出秒>
その後、画像を1枚ずつ確認:隠れ、画面外、テキストと顔の重なり、テキストの重なりをチェック。修正してから次のカットに進みます。
-
動画の長さが30秒以上の場合は、すべてのカットを組み終えた後、まず低解像度のラフカットを出力:
node tools/render.mjs --scale 0.5 --out out/draft.mp4。リズムとトランジションを確認してから、詳細を精錬します。 -
スタイルルールは
references/style-flash.mdとreferences/style-pixel.mdを参照。共通ルールはreferences/craft.mdを参照。
第6ステップ:サウンド
ルールは references/audio.md を参照:
- 効果音と画面のアクションは同じ拍子記号で記述。
- ピクセル風は
chip_*チップ音色を使用。 - タイプライター効果は
repフィールドで効果音を連続発射。 - デフォルトレベルが最終値。
- ユーザーが大きすぎる、小さすぎる、または耳障りと言った場合、
--music-dbと--sfx-dbを使用していくつかの比較ファイルを生成してユーザーに選択させます。音声トラックのみを変更し、画面は再レンダリングしません。
第7ステップ:レンダリングと検収
- レンダリング:
npm run sfx、続けてnpm run render。所要時間は第3ステップの見積もりを参照。3200フレームの動画で、FLASH風は実測約1.8分、ピクセル風は約6分。 ffprobeで解像度、フレームレート、フレーム数、長さを確認。ebur128でラウドネスを測定。- フレーム抽出:
python tools/qa_sheet.py out/film.mp4 ../qa/final(Windowsではtools/qa_sheet.ps1も使用可能)。2枚出力:完全なコンタクトシートと、各フレームが360px幅のモバイルサイズ版。 references/craft.mdの自己チェック表で評価。7項目すべて8点以上であること:- 最も深刻な問題3つとその時刻を列挙。
- 問題のあるセクションのみ再レンダリング(
node tools/render.mjs --frames 開始-終了)、その後全体を合成。 - 各ラウンドのスコアと問題を
qa/review_log.mdに記録。
- 完成動画を
<テーマ>/<ファイル名>.mp4にコピー。
縦型ショート動画のポイント(style = vflash)
- 全編コンポーネントは
src/vfilm/:VFilm、VOverlay、汎用カードとタグ、ミニマルカバー。シーンはvfilm/scenes.tsxのVSCENE_MAPに登録。 - 字幕セーフゾーン x 40–1040、y 240–1640。テキスト表示時間はデフォルトで3.5秒以上、短いカードは3秒以上。
- 出典を画面上に重ねない。出典は
source/sources.mdのみに記述。画面には最大「イメージ」と表示。 - エンディング推奨:番号付き復習/投票 + フォロー促進。文案ルールは
references/publish-copy.mdを参照(タイトル30文字以内、概要100文字以内、ハッシュタグ含む)。 - 完成動画のラウドネス -16 LUFS、トゥルーピーク ≤ -2 dBTP:
python tools/loudnorm.py out/film.mp4。BGMがはっきり聞こえること。 - カットポイントは小節の最初の拍に合わせる:
python tools/sync_check.py。速度変化カーブはbeat_grid.pyでgrid.jsonのsegmentsに書き込み。 - 縦型カバー:
npm run vcover34/vcover43。
第8ステップ:カバー
各スタイルに3:4と4:3の2枚。縦型には別途ミニマルカバー:
- FLASH風(横画面構図):
npm run cover34、npm run cover43 - ピクセル風:
npm run pixelcover34、npm run pixelcover43 - 縦型ミニマル:
npm run vcover34、npm run vcover43
すべて2倍解像度で出力。レイアウトルールは各スタイルのドキュメントと references/publish-copy.md を参照。ショート動画のカバーは左下隅(再生数エリア)を避け、下部のカラーバーでリストを積み重ねないでください。
納品
ユーザーに伝えること:
- 完成動画のパス、
brief.mdのパス、プロジェクトディレクトリ。 - 今回の重要なクリエイティブ上の決定。
- 既知の不足点。
- レンダリング所要時間。
- 不確かでユーザーの確認が必要な事実は、別途リストにして提示。
スタイル変更、新スタイル追加
- この動画のみ変更:この動画の
video/内のファイルのみを変更し、スキルテンプレートは変更しない。各部分がどのファイルにあるかは、references/craft.mdの「スタイルが分布しているファイル」を参照。まず代表的な静止画を4〜6枚出力してユーザーにスタイルを確認してもらい、その後全編を制作。 - 今後はCのスタイルを使用:
- そのコードを
assets/template/src/<スタイル名>/に収める。 references/style-<スタイル名>.mdを作成。plans.mdの候補リストに「収録済み」とマーク。- 本ファイルの案テーブルに行を追加。
- そのコードを
- 実現できないスタイル:このワークフローはコードでベクターとピクセル画像のみを描画します。実写、写実的な3D、写実的な人物は作成できません。事前にユーザーに伝えてください。写実的な人物が必要な場合、ユーザーにビデオモデルでグリーンスクリーンの人物クリップを生成してもらい、コードはシーンとテキストのみを担当するよう指示できます。
参考ファイル(必要なときに読む)
| ファイル | 内容 |
|---|---|
references/plans.md | 3つの案のフォーマット、C案候補リスト、プレビュールール、ユーザーに提示する際の書き方 |
references/brief-template.md | brief.md の7ブロックテンプレート |
references/style-flash.md | FLASHアニメ風:スタイル仕様、コンポーネント、カバー |
references/style-pixel.md | ピクセルカセット風:画面ポイント、パレット、2層の解像度、ドットフォント、スプライト、CRT、カバー |
references/craft.md | 絵コンテルール、字幕ルール、カットごとの自己チェック、全編の自己チェックスコア、検収チェックリスト、スタイルのファイル分布 |
references/remotion-kit.md | テンプレート構造、拍子記号システム、各コンポーネントAPI、よく使うコマンド |
references/audio.md | 拍、音色テーブル(チップ音色含む)、ミックスレベルの最終値、チューニング手順 |
references/research.md | 資料調査と確認の方法 |
references/pitfalls.md | これまでの失敗(作業開始前に必読) |
references/credits.md | 参考元とフォントライセンス |
references/publish-copy.md | 縦型公開文案、投票エンディング、セーフゾーン、ラウドネス |
scripts/new_project.py、new_project.ps1、check_env.py、beat_grid.py、music_rms.py、qa_sheet.py | プロジェクト作成、環境チェック、拍検出、レベル測定、フレーム抽出 |
assets/template/ | Remotionプロジェクトテンプレート(両スタイルの全汎用コンポーネントとプレースホルダー例を含む) |
assets/fonts/ | Fusion Pixel 12px ドットフォント(OFL) |
examples/bait-color/ | 完全なマルチシーン例(参考用。デフォルトテンプレートではない) |