コース動画
あなたは学生のコース資料を学習動画に変換します。このスキルを他と差別化する唯一のルールは次の通りです。
すべての数字、例、主張は学生のコース資料に由来するものでなければなりません。何も創作してはいけません。 学生はこれらの動画を、自分の教授が採点する試験勉強に使用します。たとえ正しい経済学・物理学などの知識であっても、架空の数字を使った「わかりやすい」例や、異なる表記の公式、コース外の事実はバグです。
0. 必要条件(1回確認)
python3 -m pip install -r requirements.txt && python3 -m playwright install chromium
ffmpeg -version | head -1 # brew install ffmpeg / apt install ffmpeg
オプション:3Dシーンとマスコットプレゼンター用のBlender 4.2以上(PATHにない場合はBLENDER=/path/to/blender)、
PDFスライド読み取り用のpdftotext(poppler)またはpip install pypdf、録音の文字起こし用のopenai-whisper、
Grok音声用のXAI_API_KEY(指定しない場合は無料のMicrosoft Neural Voiceが使用されます)。
1. ソースの収集
<course>/sources/フォルダを作成し、コース資料のみを入れます:
講義録(.txt/.srt/.vtt)、スライド(.pdfまたはエクスポートされたテキスト)、学生のノート、問題集、模擬試験。
- 録音はあるが文字起こしがない場合 →
whisper lecture.mp4 --model base --output_format txt --output_dir sources/ - .docx →
textutil -convert txt file.docx(macOS)またはpandoc file.docx -t plain -o file.txt - どの講義・トピックを動画で扱うか学生に確認してください。依頼がない限り、他の週の資料で水増ししないでください。
書き始める前にソースを完全に読んでください。教授の正確な表記、用語、例題、数値をメモしてください。
2. スクリプトの作成(コンテンツJSON)
engine/SCHEMA.md(ビジュアルタイプ、キューワード、クイズ形式、レイアウト制限)に従って、<course>/<name>.jsonを作成します。
examples/lemonade/は完全な小規模サンプルです。
ルール:
- 例題:講義で使われている例題を、講義と同じ数字で使用します。講義で「価格4ドル、3単位」と扱っている場合、動画でも「価格4ドル、3単位」であって「価格10ドル、5単位」ではありません。
- クイズ:コースの練習問題、クリッカー問題、または例題から出題します。新しい問題を作成する場合は、ソース内の数字のみを使用し、クイズのラベルにその旨を明記します(「模擬試験」ではなく「練習問題」など)。
- 派生数字(計算した合計、差など)は問題ありませんが、それぞれをトップレベルの`