スクリプト動画
ここでの動画はスクリプト、すなわち何を話し、画面に何を表示し、それがいつ行われるかを記述したファイルです。
小さなエンジン(starter/ 内)が、これをブラウザでの画像に変換し、さらに音声、キャプション、チャプターを含む .mp4 に変換します。
動画がテキストであるため、記述、チェック、行ごとのレビュー、すべてのフレームの確認、翻訳、そして再編集なしでの一語の修正が可能です。
エンジンは簡単な部分です。教えるための動画には、視聴者が追える順序で、知っている言葉で、声が指すものを画像で示す、真実のストーリーが必要です。 このスキルのほとんどはその部分に関するものです。段階を順に進めてください。各段階で次の段階が読み込むファイルが生成されるため、長時間のセッションでも作業が維持され、別のエージェントが引き継ぐこともできます。
依頼者が修正する必要のない動画を引き渡すことを目指してください。 依頼者の時間は、あなたが節約しているコストです。そのため、決められることは決めて文書化し、依頼者が提供したすべてのサービス、鍵、事実を使用し、引き渡す前に依頼者の立場で動画を確認してください(「引き渡し前に」を参照)。依頼者が最初に気づくのは、チェッカーが見つけられるようなルール違反ではほとんどありません。それは、動画が答えていない推測、実体のない主題、そして未完成に聞こえる動画です。
世界に関するすべての動画に適用される3つの原則があります。それぞれここで一度だけ述べます。以下の段階でこれらを適用し、references/research.md が方法を提供します。
- コアの深さで伝え、一段深く調査する。 引き渡す動画はコアです。約束を守り、真実で公正な最短の説明であり、実際のストーリーがある主題では約10〜20分、単一のメカニズムではそれより短くなります。依頼者が指定した長さは制限であり、優先されます。その場合、調査の深さはそれに合わせて縮小します。調査はさらに一段階深く、詳細の深さ(人々、決定的な日々、正確な手段、競合する人物、調査で判明したこと)まで行い、コアが知識に基づいて選択され、かつ隣接する主題が明らかになるようにします。すなわち、主要トピックに触れ、独自のストーリーを持つ出来事、機関、またはアイデアです。それぞれが
research/next-videos.mdの行となり、既知のことが記載され、それ以上調査されません。詳細(各人物のその後の人生、各文書の全文、機関の全歴史)の下には、別の動画の調査があります。ある仕事では、そこに進むと、依頼者が望んだ18分のコアに対して動画が6時間に膨れ上がりました。延長版はリクエストがあった場合のみ作成します。 - すべての実例は、主要トピックが機能していることを示します。 実際のストーリーは、動画の主題となる事柄が実際にその中で発生している場合にのみ動画に入れます。情報源が伝える通りに。先物市場に関する動画の場合、取引所で取引された先物契約、証拠金請求、決済された契約などです。近いだけのストーリー(同じ時代、有名な名前、似ているが別の方法で行われた賭け)は、たとえ有名で依頼者が提案したとしても、除外します。これをラウンド1の情報源で、深く掘り下げる前に確認します。ある仕事では、先物動画のために提案された最も有名なストーリーは、銀行とのプライベート取引を通じて行われた賭けであることが判明し、2つの版で語られた後に削除されました。ただし、短いことは薄いことではありません。コアでは、各実例は、その人物、日付、正確な手段、金額、異なる結果になり得た方法、結末、そして主要トピックについて示すことをもって語られます。
- 調査には境界と終わりがあります。 すべてのリードは、検索に費やす前に主要トピックに対してテストされます。失敗したリードは一行で書き留めて放置します(「面白い」では開きません)。計画されたラウンドは3つ(アウトライン、詳細、そして動画で述べるすべての情報源でのダブルチェック)と、コアが必要とする名前付きアイテムのみのための短い第4ラウンドがあります。それ以上は依頼者の判断です。
デフォルトの視聴者: その主題に初めて触れる人。8歳の子供でも追えるように、大人が幼稚だと感じない落ち着いたプロフェッショナルな表現で書いてください。シンプルであることは幼稚であることと同じではありません。短い文、日常的な言葉、一度に一つのアイデア、赤ちゃん言葉は使わないでください。これは、ブリーフが異なる視聴者を指定している場合のみ変更します。
セットアップ
このスキルの starter/ フォルダをユーザーのプロジェクトにコピーし(例えば video/ として)、次を実行します。
cd video
npm install # 小さな依存関係が1つ。マシン上のChromeを使用します。
node tools/check.mjs # サンプル動画がパスするはずです。
必要なもの:Node 18以降、Chrome、EdgeまたはChromium(画像を描画するため)、ffmpeg(音声を録音し、エクスポートするため)。不足しているものがあれば、references/troubleshooting.md を参照してください。スキルフォルダ自体の中で作業しないでください。コピーの中で作業してください。
コピーには1つのサンプル videos/hello.json が含まれています。15秒のプレーンなデータで、翻訳と縦長レイアウトが含まれており、セットアップが機能することを確認するために使用します。各段階が何を生成すべきかは、node tools/new.mjs が作成するファイルにあります。各ファイルは独自のチェックリストから始まります。ユーザー自身の動画を開始する際に、サンプルを削除してください。
段階
すべての動画は node tools/new.mjs <id> "<Title>" で開始します。これにより、notes/<id>/(以下に名前が付けられたファイルとそのチェックリスト)と、videos/<id>.mjs のスクリプトスケルトンが作成されます。
| # | 段階 | 生成物 | 完了条件 | 参照先 |
|---|---|---|---|---|
| 0 | ブリーフィング | notes/<id>/brief.md | 視聴者、約束(「視聴後、視聴者は…できる」)、長さ、形式、言語が文書化され、依頼者が名前を指定して要求したすべてのものが含まれていること。 | 以下 |
| 1 | 調査方法 | research/00-how-to-research.md | この分野を知る人々がどのようにして物事を見つけるか、そして初心者がどこで間違えるかを理解していること。 | references/research.md |
| 2 | 調査(3ラウンド) | research/NN-name.md、research/leads.md、research/next-videos.md、research/index.md | leads.md のすべてのリードがクローズされている(調査済み、見つからず、次回動画、トピック外、または未解決)。各実例が実例テストに合格し、詳細の深さまで知られている。他の見解や誤解が調査されている。ラウンド3では、動画に向かうすべての主張がその情報源で再読され、各主張に情報源と信頼ラベルがある。依頼者が覚えていることには判定がある。完全なリストは references/research.md のセクション11を参照。 | references/research.md |
| 3 | マインドマップ | mindmap.json | 調査されたすべてのアイデアが、core(動画内)、support(調査済みで真実、コアからは除外)、または cut(未確認、不公平、またはトピック外)である。core のアイデアだけで約束が果たされる。node tools/mindmap.mjs <id> がエラーを報告しない。 | references/planning.md |
| 4 | ストーリーボード | storyboard.md、assets.md | すべてのビートに画像、要旨、コンポーネント、音(通常はなし)がある。下部のチェックがチェックされている。 | references/planning.md |
| 5 | スクリプト | videos/<id>.mjs | node tools/check.mjs <id> がエラーを報告せず、すべての警告を確認したこと。スクリプトはコアの長さであること。 | references/authoring-kit.md、references/components.md |
| 6 | 正確性レビュー | review/accuracy.md、research/index.md(完全な説明の場合は review/coverage.md のみ) | dump --claims のすべての行に判定と情報源がある。各実ストーリーについて、作成者ではないチェッカーがスクリプト、ノート、情報源を比較した(またはセカンドエージェントがいない場合は自分で行い、ファイルに「独立していない」と記載)。研究がスクリプトに対して再読され、コアが必要で不足していたものが追加された。修正はノートに書き戻されている。 | references/script-review.md |
| 7 | 理解度レビュー | review/WhatIHaveLearned.md、review/lost-points.md | 日記がギャップなく約束に到達し、迷う可能性のあるすべての方法に修正または理由があること。 | references/script-review.md |
| 8 | ビジュアルレビュー | review/visual.md | すべての静止画を確認し、切り取られ、覆い隠され、空白で、または読めないものがないこと。 | references/visual-review.md |
| 9 | 音声とサウンド | out/tts/ に録音されたライン、assets/<id>/ のサウンド | スクリプトが段階6〜8に合格し、音声が録音されていること。タイミングは実際の音声に従う。イベントサウンドが設定されている。音楽がある場合は、ストーリー部分の下にのみ配置する。 | references/voice-and-assets.md |
| 10 | エクスポートと最終確認 | out/<id>.mp4、.srt、.vtt、.chapters.txt | エクスポートされたファイル自体のフレームを確認し、音声をチェックしたこと。 | references/export-and-publish.md |
| 11 | 他の言語と形式(依頼があれば) | videos/i18n/<id>.<lang>.json | 各言語が check に合格し、その静止画が確認されていること。 | references/localization.md |
| 12 | 公開キット | publish.md | タイトル、説明、チャプター、キャプション、サムネイル、情報源、クレジットの準備ができていること。 | references/export-and-publish.md |
| 13 | 引き渡し | 依頼者へのメッセージ | 依頼者の目線でのパスが完了していること。メッセージには、何が決定されたか、何が修正されたか、何が未解決かを記載する。 | references/finishing-and-revising.md |
段階4以降に適用される執筆ルールは、references/writing-for-everyone.md(言葉と文)および references/teaching-techniques.md(アイデアを定着させる方法)にあります。references/visual-design.md はレイアウト、色、動きを扱います。最初のスクリプトを書く前に、これら3つを読んでください。
段階0:ブリーフィング
ユーザーが言ったことから brief.md を記入します。それ以外については、最善の推測を書き、「(推測)」とマークします。立ち止まって質問しないでください(「決定、記録、継続」を参照)。最も重要な1行は約束です。「視聴後、視聴者は…できる」で始まる1文です。その後のすべての決定(何を調査するか、何を削除するか、動画がいつ完成するか)は、これに対してテストされます。視聴者がすでに知っていることも記録します。なぜなら、そこから動画が始まるからです。
ブリーフに、依頼者の言葉そのままの彼らが名前を指定して要求したすべてのものをコピーします。使用するサービス、鍵とその場所、含める例やイベント、覚えている事実、混乱した部分、制限(「ほとんど音楽なし」)などです。これらはそれぞれ、引き渡す前にチェックする行です。名前付きのサービスは、段階9ではなく、今すぐ到達可能性を確認します。覚えている事実は、繰り返すべきものとしてではなく、検証すべきものとして調査に送られます。
ここで調査が必要かどうかを決定します。コンテンツが完全に提供されている場合(ユーザー自身の製品、彼らが書いたスクリプト、説明したプロセス)で、独自の事実を追加しない場合にのみ、段階1と2をスキップします。1つの数字、日付、名前、または「なぜなら」を追加する場合は、調査してください。
段階1と2:調査
主題を調査する前に、調査方法を調査します。人々がこの分野をどのように学び、調査するかについて2、3回検索し、さらに1段階上のレベルで検索します(債券市場の場合:「債券市場を理解する方法」、次に「経済について学ぶ方法」)。これにより、どの情報源が重要か、どの数字が重要か、初心者がどこで間違えるかがわかります。その後、3つのラウンドがあります。
- アウトライン。 トピックごとに1つのノート。上部に要約があります。情報源付きの事実、実際のイベント(最初に実例テストにかける)、日常的な比較、および最も有力な反対意見と誤解。メインラインと同じくらい注意深く調査します。
- 詳細。 ノートが説明せずに言及しているすべての人物、場所、日付、数字、用語、メカニズム、原因、引用を
research/leads.mdにリストします。主要トピックに関連するものを、詳細の深さまで1回調査します。隣接する主題はnext-videos.mdに送られます。残りはトピック外としてマークされます。 - ダブルチェック。 新しい主題はありません。動画で述べるすべてのことを、その情報源で再度読みます。驚くべき主張、ストーリーの規模を示す数字、引用、指名された人に悪影響を及ぼすものについては、2つ目の独立した情報源を見つけます。
検索を開始する前に計画し、3番目をラウンド3のために残しておきます。他のエージェントを起動できる場合は、各実イベントを独自のエージェントに割り当て、ダブルチェックはノートを書いていないエージェントに割り当てます。
完成した動画が活用できなければならない2つのこと:
- 詳細の深さまで知られている実際のイベント。 架空の人物はアイデアを追いやすくします。実際のイベントは視聴者にそれを信じさせ、記憶させます。歴史のある主題(市場、テクノロジー、機関)については、少なくとも2つ調査します。誰かが勝った例を示す場合、それがどのように失敗し得たかを調査し、誰かが負けた例を見つけます。勝ちだけでは間違った教訓を教えます。自然のメカニズムや方法(空がなぜ青いか、結び方)の場合、実際の観察、測定、または発見で十分か、あるいは不要です。その場合はブリーフに「なし、理由:…」と書きます。
- 依頼者が覚えていること、検証済み。 これはリードであり、多くの場合部分的に間違っています。各部分を検証し、正しい部分を使用し、何を修正したか、その理由を伝えます。「依頼者がそう言ったから」という理由で主張を繰り返したり、黙って削除したりしないでください。
詳細:references/research.md。
段階3:マインドマップ
mindmap.json は、動画に含まれる可能性のあるすべてのアイデアの短いツリーです(ノードの種類は references/planning.md のセクション1にリストされています。node tools/mindmap.mjs は間違っている場合に名前を示します)。各ノードは、アイデアが何であるか、その詳細が研究のどこにあるか("file.md#Heading")、視聴者が最初に必要とするアイデア、および他の場所のどのアイデアに接続するかを数語で示します。各アイデアは、core(動画内:約束に必要、実際のストーリーを語るために必要、または公平性のために必要)、support(調査済みで真実、コアから除外:説明用の素材、依頼者が尋ねた場合の延長版、または次回動画)、または cut(未確認、公平に語れない、または主要トピックに影響しない。実例テストに失敗した実際のストーリーは cut)です。ツールは、すべてのポインターがどこかに導き、必要なものの前に教えられていないことを確認します。詳細:references/planning.md。
段階4:ストーリーボード
ビートごとに1行の表です。視聴者が見るもの、声が言うことの要旨、それを描画するコンポーネント、新しい単語が登場するかどうか、声以外に聞こえるもの(例:効果音、音楽)。
(以降の翻訳は以下同様に、原文の全てを生成します)