knowledge-video

ナレッジ動画

1つのトピックを、最後まで見たくなるナレッジ動画に仕上げます。以下は有効な進め方であり、固定された手順ではありません。ステップを統合、省略、並べ替えたり、このトピックに合う文章、見た目、動きを自分で設計したりできます。

ユーザーの言語で話してください。以下のファイル名は初期設定です。

大まかな進め方

1. 調査 → article.md：情報源を探し、出典付きの記事を書きます。まずトピックがどのような構成になりそうか（時系列、因果関係の連鎖、概念、比較、俗説、1つの物語）を確認してから、どのポイントを扱うか決めます。ポイントの数はユーザーが決めます。音楽の長さを基準に2つか3つの選択肢を提案し、1つをおすすめします
2. 台本 → script.md：記事を、ついスクロールを止めてしまう動画の台本に書き直します
3. 画像 → images.md または image-prompts.md：実際の画像、または AI イラスト用のプロンプトを作成します（画像 API は呼び出せない前提です。ユーザーが自分のツールを使います）
4. 見た目とストーリーボード → looks/、storyboard.md：いくつかの方向性をユーザーに示し、音楽に合わせてストーリーボードを作成します
5. レンダリング → opening-preview.mp4 → final.mp4：まず短いオープニングを作成し、仕上がりを確認してから動画全体を作成します

デフォルトでは、次に進む前に各ステップの成果をユーザーに見せます。レンダリング後では、方向性を間違えたときのコストが最も大きくなるからです。「最後まで進めて」と言われた場合は作業を続け、選んだ内容とその理由を storyboard.md に記録します。

各ステップ：プロンプトを埋めてから、それに従う

Anthropic のプロンプトガイドに従い、背景、要件、確認事項はそれぞれ別の XML タグに記述し、各行に理由を添えます。パーツを分けることで内容が混ざらず、理由を把握することで、書かれていない内容にもモデルが応用できます。このトピックとユーザーの発言をもとに、タグの内容を自分で記入します。

• 概要 prompts/brief.md：最初に一度記入し、各ステップの後に更新します。<context> は1つだけにします。トピック、対象ユーザー、伝えたいこと、長さ、向き、音楽、ユーザーの好みと苦手なもの、これまでのステップで決まったこと、ファイルの場所を記入します

• このステップのプロンプト prompts/<step>.md：4つのタグを記入します

  • <role>：このステップを担当する役割と、その役割が最も重視することを記入します。役割はステップごとに異なります。このステップに合う役割を選びます。たとえば、調査では情報源を最も重視する知識編集者、台本では視聴者がスワイプして離れてしまわないことを最も重視する脚本家、画像ではピクチャーエディターまたはイラストレーター、見た目ではアートディレクター、ストーリーボードではストーリーボードアーティスト、構成では動きの1つ1つで何を説明するかを最も重視するモーションデザイナーです
  • <task>：このステップで作成するものと、その保存先を記入します
  • <style>：それぞれに理由を添えて、推奨するアプローチを記入します。ルールではなく推奨です。references/ の例から選ぶか、このトピックに合わせて新たに設計します。ユーザーが希望を伝えている場合はそれに従い、避けてほしいこともここに記録します
  • <check>：ステップを完了とする前に、項目ごとに確認すべきことを記入します。「必須条件」も含めます

  毎回 <role>、<task>、<check> を記入します。調査とレンダリングでは通常不要な <style> は省略します。ユーザーが話していないことはトピックから推測し、不確かな点は報告時に質問します。記入したプロンプトとステップの成果を一緒に提示します。ユーザーがプロンプトを編集した場合は、編集後の内容をもとにステップをやり直します。

担当者：ポイントの数や見た目など、ユーザーとのやり取りが必要なステップは自分で行います。大規模で独立して進められるステップ（調査、画像の検索または画像プロンプトの作成、構成の作成、レンダリング）はサブエージェントに任せます。渡すのは概要、このステップのプロンプト、ファイルパスだけにして、必要な情報だけを含むクリーンなコンテキストにします。サブエージェントは、ユーザーとのやり取りを把握していないため、どちらも必要な情報がすべて揃っていなければなりません。完了したら、その出力を読み、セルフチェックを行ってからユーザーに提示します。サブエージェントを使わない場合は、自分でプロンプトに従います。

守るべきこと

• 事実には出典を付ける：年、名前、数値、引用はすべて、信頼できる出典（論文、機関、アーカイブ、本人の発言）にたどれるようにし、article.md にリンクします。出典を確認できないものは削除し、推定値にはその旨を明記し、伝聞による主張には誰の証言かを記載します。冒頭の問いかけから結びまで、画面に表示するすべての文言を article.md と一致させます
• 素材は使用許諾を確認する：画像、音楽、効果音、フォントは、この用途でライセンス上使用可能であることを確認します（ファイルのページを確認してください）。クレジットは credits.md に記載します
• 実在の人物の顔をAIで描かない。動画でAI生成のイラストを使う場合は、プラットフォームの「AI生成コンテンツ」ラベルを有効にします
• 映像は時間だけで決まるようにする：ランダム性を使う場合はシードを指定し、毎回同じフレームがレンダリングされるようにします（HyperFrames では必須です）
• 納品前に、動画全編を自分で確認します。テキストが表示され、読む時間があり、意味が理解できること（推論の手順が飛ばされておらず、提示した謎が後で解消されること）、年や数値が記事と一致すること、音声と映像が同期していることを確認します

使用できるツール

映像には HyperFrames（npx hyperframes init / docs / check / snapshot / render）を使います。スキルがインストールされている場合は、コンポジションの作成時にそれらに従います。scripts/ にある小さなツールは、必要に応じて使ってください。

スクリプト	機能
beats.py	音楽のテンポ、ビート、小節線、小節ごとの音量変化を調べます
music_loops.py、cut_music.py	繰り返し使える小節や継ぎ目なくカットできる箇所を見つけ、小節リストから新しい音楽を作ります
timing.py	各画面のコピーをビートグリッドに配置し、重要な画面を指定した小節に固定します
sfx.py	Kenney の CC0 効果音をダウンロードし、効果音のキューを1つのトラックにミックスします
qa.py	すべての画面のコンタクトシートと、重要なビート前後のフレームを作成します

以前の動画から得られたもの

参考資料であり、ルールではありません。まずこのトピックに合わせて設計し、迷ったときや同じ問題に直面したときに参照してください。

• references/example-ai-history.md：最初にテストした制作の記録。各ステップの出力とタイミング
• references/example-fish-and-bears-paw.md：『Information Theory』の夜空の粒子表現を3回改訂した記録（動きが平板 → コピーを追いにくい）
• references/prompt-examples.md：テスト済みの動画で使った、記入済みプロンプト2例。詳細さの目安を確認できます
• references/notes.md：コピーとペース配分に関する所見。推論の連鎖をうまく伝える方法も含みます
• references/images.md：ライセンスの確認、プロンプトの作成、レイヤーごとの生成
• references/visuals.md：高密度のコラージュ、夜空の粒子、タイムライン上の場面、写真カード、生成した画面へのUIの配置、コードで描画するもの
• references/sound.md：音楽の編集、効果音、音量
• references/pitfalls.md：レンダリングに失敗したときや映像が意図と異なるときに、まず確認します