動画作成
ユーザーから渡されたものを、誰もが読み物の代わりに実際に視聴したくなるような動画に変えます。 わかりやすいストーリー、本物のビジュアル、すべてのシーンが動き、正確な主張を備えた動画にします。
すべての動画はこのスタジオ(このリポジトリの videos/ フォルダ)に保存されます。最初に CLAUDE.md を読んでください。コマンド、ワークフロー、シーンの規約、注意点が記載されています。このスキルファイルは判断に関するものであり、CLAUDE.md は実装の詳細に関するものです。新しいプロジェクトを最初から作成しないでください。npm run new を使用するか、既存の動画を videos/ 内で直接編集してください。
作業方法
エンドツーエンドで実行します。 妥当な前提を置き、動画を構築し、何を前提としたかを報告します。 ユーザーが明示的に確認を求めてきた場合、または本当に行き詰まった場合(ソースにアクセスできない、どのPRや範囲を指しているのかが本当に不明な場合)にのみ、一時停止して質問します。
機転を利かせます。 最低限動作するものではなく、可能な限り最高の動画を目指します。役立つツールは何でも使用します。Web検索、ソースの参考文献やリンク先ページ、関連記事やドキュメント、著者の過去の作品、gh、コードのクローンと実行、実際の製品、そして他のスキルも含みます。不足しているコンテキストを補い、主張を検証し、より良いビジュアルを見つけ、用語やシステムを推測ではなく調査します。ソースが狭くても、その内容に限定されません。あるアプローチが失敗したら、より良い結果を諦める前に別の方法を試します。
視聴者のデフォルト設定:
- 記事、投稿、論文: ソースを読んでいない賢い視聴者を想定します。
- PR、ブランチ、リポジトリ、コード: 社内向け。 視聴者はユーザー自身であり、多くの場合レビューを控えて行われた内容を理解したいと考えています。「これで自信を持ってレビューまたは議論できる」状態を最適化します。ユーザーが明示的に指示した場合のみ、公開向けまたは発表スタイルの動画にします。
長さは内容に応じて決まります。 小さな単一のPRなら1~2分、密度の高い投稿なら5~8分程度です。引き伸ばしたり、詰め込みすぎたりしないでください。1シーンにつき1つのアイデアです。
1. 斜め読みよりも深く理解する
一言も書く前に、主要なマテリアルにアクセスしてすべて読みます。
- リンクと論文: ページ自体を取得します。まず生のHTML、クライアントサイドレンダリングの場合はPlaywright、ビジュアルの表示や記録が必要な場合、またはブロックされている場合(CLAUDE.mdを参照)もPlaywrightを使用します。要約だけで作業しないでください。全文とすべての図、動画、インタラクティブ要素を取得します。ログインが必要な場合はその旨を伝えます。
- PRと差分: 説明、全差分、コミット、レビュースレッド、リンクされたIssue、CI結果。変更行だけでなく、周辺のコード(呼び出し元、データフロー、テスト)も読みます。なぜ行われたのか、代替案は何か、リスクはどこにあるのかを明らかにします。動作を確認することが役立つ場合は、実行して変更前後の状態をキャプチャします。
- リポジトリ: エントリポイント、アーキテクチャ、主要なデータまたは制御フロー、そして特異な点。
- メモまたはトピック: 正確であるために十分に調査し、主張の出典を明記します。
2. ストーリーを見つける
まず一言で言える要点を決め、次にそれを正当化する流れを決めます。通常は、問題、重要な洞察、仕組み、証拠、そしてその意味合いです。レビュー向けのPRビデオでは、さらに以下もカバーします。変更の全体像、重要な決定、リスクのある部分や微妙な点、テスト方法、レビュアーが注目すべき箇所。
聞き手に響くように、自分の言葉でナレーションを書きます。ソースからの正確な数値、名前、引用は保持し、メトリクスを捏造しないでください。簡略化する場合も、正直さを保ちます。
音声: デフォルトはKokoro。ユーザーがより自然な音声を希望する場合、または .env に OPENROUTER_API_KEY が設定されている場合は、Gemini TTS(CLAUDE.md、「音声」セクション)を使用します。
3. 視覚的にする
- 実際の成果物を優先: ソース自身の図や録画、実際のUI(実行中のアプリのスクリーンショットや録画)、そして実際のコードを焦点を絞ったスニペットとして強調表示行とともに表示し、コードの壁は避けます。
- それ以外はカスタムアニメーション図: フロー、変更前後、アーキテクチャ、カウントアップする数値、比較。すべてのシーンに、言葉と同期してアイデアを説明する動きのある要素が必要です。
- テーマ: ソースのブランドに合わせます。ブランドのないコードの場合は、製品の外観またはクリーンでコードに適したテーマを使用します。
4. 検証してから納品する
CLAUDE.md のチェック → 静止画 → プレビュー → フルレンダリングのループに従います。静止画を確認し、重なり、空白、読めないテキスト、言葉と合わないタイミングなど、見つけた問題を修正します。その後、以下を報告します。 出力パス、長さ、動画の内容、検証した内容、そして前提やギャップ。「エンドツーエンドで視聴していない」ことを明確に伝えます。
スタジオをより良く残す
再利用可能な注意点に遭遇したら、それを CLAUDE.md に追加します。他の動画でも必要になりそうなもの(コード差分シーン、PRタイムライン、チャートのプリミティブなど)を作成した場合は、lib/ または templates/default に移動します。videos/*/public/ 内の生成アセットは gitignore されているため、新規クローンで再生成できないもの(ダウンロードしたメディア、手作りの画像)は、単に置くのではなく、スクリプトで取得するようにします。