60秒の解説動画を作成する
このリポジトリのパイプラインを使って、トピックを完成した1080x1920の動画に変換します。コストはかかりません。リサーチ、執筆、修正はあなたが行い、スクリプトがチェックとレンダリングを行います。リポジトリのルートディレクトリから作業してください。ストーリーボードを書く前に.claude/skills/make-explainer/rules.mdを読んでください。
絶対ルール
- 画面上のすべての数字、日付、名前、引用は
facts.json内の事実に基づき、そのソースはあなたがWebFetchで実際に開いたものに限ります。記憶から数字を入力してはいけません。主張にソースが付けられない場合は、それを削除してください。ナレーションはあなたが開いたページに書かれていることのみを述べ、読んでいない背景情報を補足してはいけません。 - ストーリーボードを通すために
src/、tests/、バリデーター、またはこのスキルを編集しないでください。ストーリーボードまたは事実を修正してください。ソースを再度読まずに、事実のデータをストーリーボードに合わせて変更したり、その逆を行ったりしないでください。 - レビューゲート(ステップ6)で停止してください。ユーザーがレビューシートを承認するまで
npm run produceを実行しないでください。 - 金融と投資は教育と歴史に限定されます。アドバイス、予測、「あなたは~すべき」は禁止です。すべての数字について、期間とソースを明記してください。
ワークフロー
動画に関するすべてのデータはvideos/<スラッグ>/(小文字、数字、ハイフン)に保存されます:facts.json、storyboard.json、review/。
- ブリーフィング。 トピック、動画が証明する一文の主張、視聴者を決めます。主張が不明確な場合のみ、質問を1つ行います。デフォルトの音声は
en-US-AndrewNeural、音楽はnullです。 - リサーチ。 WebSearchで検索し、次にWebFetchで一次情報源(BLS、連邦準備制度、SEC、企業の財務報告、Wikipedia、博物館や図書館のページなど歴史的な日付用)を開きます。ページから数字をコピーします。5~8個の事実を書きます:
id、claim(ソースが述べているままの単位と期間を含む完全な文)、value(一つの数値の場合)またはdataset(グラフやリストが表示する正確なデータ)、source(名前とURL)。主張に「デモデータ」という文言を残さないでください。 - 検証。
npm run verify-facts -- --facts videos/<スラッグ>/facts.json --out videos/<スラッグ>/verify.jsonを実行します。not-found、partial、unreachableのすべてについて、ソースを再度開き、事実を修正または削除してください。このツールは参考用です。正確性はあなたの責任です。小さな整数(8、9、27など)はほとんどのページに現れるため、supportedはそれだけでは信頼できません。自分でソース行を読んでください。何らかの理由でfacts.jsonを編集した後は、verify-factsを再度実行してください。レビューシートは古い結果をマークします。 - スクリプトとストーリーボード。 ナレーション全体で約155語(55~60秒)、6~10シーン、シーン1にフック、1シーンにつき1つのアイデア、シーンタイプは多様に(連続して3つ同じタイプを避ける)。
storyboard.schema.jsonで正確なフィールドと制限を確認し、fixtures/finance.storyboard.json、fixtures/history.storyboard.json、fixtures/ancient.storyboard.jsonの形をコピーしてください。videos/<スラッグ>/storyboard.jsonを書き込みます。 - チェックと修正。
npm run check -- --storyboard videos/<スラッグ>/storyboard.json --facts videos/<スラッグ>/facts.jsonを実行します。すべての問題(各メッセージはシーンIDと修正方法を示します)を修正し、再実行します。最大6ラウンドまで。それでもブロックされるものがあれば、正確に報告してください。警告(長さ、アドバイスの表現、トレースされていないテキスト)は、修正するか正当化する必要があります。長さの見積もりは約10%の誤差(実際の語速は毎秒2.5~3.2語)なので、55~60秒を目指してください。produceが最終的な判断を下し、長さが拒否された場合はナレーションを調整して再実行するだけです。 - レビューゲート。
npm run sheet -- --storyboard videos/<スラッグ>/storyboard.json --facts videos/<スラッグ>/facts.json --verify videos/<スラッグ>/verify.json --out videos/<スラッグ>/reviewを実行します。ユーザーにvideos/<スラッグ>/review/review.htmlを開くよう伝えます。要約を提供します:主張、シーンリスト、語数と推定長さ、各事実とそのソースチェック、すべての警告。承認または編集を求めます。停止して待ちます。 - 制作。 承認後:
npm run produce -- --storyboard videos/<スラッグ>/storyboard.json --facts videos/<スラッグ>/facts.json --out out/<スラッグ>を実行します。約2分かかります。長さが拒否されたり、シーンが短すぎる場合は、ナレーションを変更し、checkを再実行し、再度制作します(音声テキストはキャッシュされます)。ファイルパス、長さ、ラウドネスを報告します。あなたが判断しなかったことを明確に述べてください:音声の品質、発音、ペース、味わい。ユーザーに動画を見るよう依頼します。
問題が発生した場合
- 理解できないチェックメッセージ: シーンIDが示されています。
rules.mdでそのシーンの制限を確認してください。修正方法を推測しないでください。 - 事実とシーンが矛盾する場合: ソースを再度開いてください。ソースに基づいて間違っている方を修正し、一方を他方にコピーしないでください。
- 地図の地域が見つからない場合: メッセージが提案する表記(「アメリカ合衆国」など)を使用してください。地域は
focusボックスと重なる必要があります。 - 音声の問題(ネットワーク):
npm run produceはEdge TTSのためにインターネット接続が必要です。--voice standinは、ドライラン用にほぼ無音のプレースホルダー音声を提供します。 - セットアップが不足している場合:
npm installとnpm run setup:ttsを一度実行してください。
ユーザーへの出力
簡潔に保ちます:ファイルパス、動画が主張している内容、長さ、ラウドネス、使用された事実とソース、およびあなたが受け入れて理由を説明した警告。