解説動画スキル(Hellboy) は何をしますか?
あなたは1つの技術トピックを、非技術者が初見で理解できる2~3分の1080×1920 MP4に変換します。視覚スタイル、テンポ、スクリプト構造は、参照チャンネル(docs/01-style-bible.md で分析済み)からクローンされています。2つの要素は意図的にオリジナルです:キャラクター(Hellboy) と音声です。
あなたはテキストファイル(スクリプトと storyboard.json)のみを記述します。engine/ 内のエンジンが音声、キャプション、アニメーション、キャラクター、音楽、レンダリングを担当します。
ユーザーがトピックだけを指定した場合
追加の質問をせずに全工程を実行します:
- トピックからスラッグを作成し(例:
how-dns-works)、python engine/make_video.py new videos/<slug>を実行します。 videos/<slug>/script.md(docs/02)を作成し、次にvideos/<slug>/storyboard.json(docs/03 + docs/04)を作成します。examples/upi-explained/のパターンをコピーします。python engine/validate_storyboard.py videos/<slug>を実行します。すべてのERRORを修正し、0 error(s)と表示されるまで繰り返します。python engine/make_video.py preview videos/<slug>を実行します。画像が表示されたら、build/preview.pngを docs/06 セクションBと照合し、修正します。python engine/make_video.py render videos/<slug>を実行します。パスoutput/<slug>.mp4、再生時間、2行の要約を返信します。
非交渉事項
- Hellboyは再描画されません。 彼は
character/hellboy/hellboy.jsからのみ提供されます。show、arm(down/point/explain)、expressionの設定のみ許可されます。character/hellboy/CHARACTER_BIBLE.mdを一度読んでください。 - 音声は固定されており、
engine/config.jsonにあります。動画ごとに変更しないでください。 - 長さ:ナレーション360~470語、2:00~2:50。 1文は20語以下。
- すべての文で画面上の何かが変化します。 アイテムは、そのキーワードが話されるとき(
"at")に表示されます。 - 正確さはシンプルさに勝ります。 何かを省略することで単純化し、決して誤ったことを言って単純化しないでください。
- バリデーターが合格すること(
0 errors)がレンダリングの前提条件です。
ワークフロー(この順序で実行)
| # | ステップ | 参照ドキュメント | 出力 |
|---|---|---|---|
| 1 | スキャフォールド | – | python engine/make_video.py new videos/<slug> |
| 2 | スクリプトの計画と作成 | docs/02-script-writing.md | videos/<slug>/script.md(360~470語、7ビート) |
| 3 | ビジュアルの計画 | docs/03-visual-planning.md | シーンリスト:ナレーション → タイプ、見出し、キャラクター |
| 4 | ストーリーボードの作成 | docs/04-storyboard-reference.md | videos/<slug>/storyboard.json(または meta.json + scenes.jsonl → assemble) |
| 5 | 検証 | – | python engine/validate_storyboard.py videos/<slug> → 0エラーになるまで修正 |
| 6 | プレビュー + QA | docs/06-qa-checklist.md | make_video.py preview videos/<slug> → build/preview.png を確認、修正 |
| 7 | レンダリング | docs/05-production.md | make_video.py render videos/<slug> → output/<slug>.mp4 |
| 8 | 最終QA | docs/06-qa-checklist.md | スコア ≥ 85、すべてのMUST項目合格 |
小規模/ローカルモデル? ステップ2~5の代わりに docs/07-small-model-playbook.md に従ってください。作業を1シーンずつのプロンプトに分割します。
7ビートスクリプト(暗記)
フック(22語以内:「Xを解説。」/「Xは実際どう動く?」/ 驚きの主張 / 共感を呼ぶアクション)→ 緊張(謎)→ ロードマップ(「さあ、追ってみましょう…」)→ 本文(3~6チャプター:概念 → 平易な意味 → 日常例 → 結果;名前のある人物を使った1つの一貫した例)→ ひねり(「でも、ここが面白いところなんです…」)→ まとめ(「こんな風に覚えましょう」各チャプター1行)→ 決めゼリフ(フックと呼応する断片:「1回のスキャン。4つのプレイヤー。2秒。」)。
シーンのレシピ(暗記)
- 1シーン = 1~3文(8~28語、3~8秒)。動画あたり20~32シーン。
visual.typeはdocs/03-visual-planning.mdの判定表から選びます。動画あたり7~12種類の異なるタイプを使用します。- Hellboyは40~70%のシーンに表示します(常に:最初のシーン、ひねり、まとめ、最後のシーン)。
sequence、hub、diagram、compareの場合は非表示にします。 - 大きな図は2~4シーンにわたって構築し、
"continue": true+"shown": trueアイテムと同一の見出しを使用します。 - 見出しは2~6語で、1つの
*アクセント*単語を含めます。画面上のラベルは1~4語。
コマンド(リポジトリルートから)
# 最初に有効化: source .venv/bin/activate | Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new videos/<slug> # テンプレート
python engine/make_video.py assemble videos/<slug> # meta.json + scenes.jsonl → storyboard.json
python engine/validate_storyboard.py videos/<slug> # 必須:0エラー
python engine/make_video.py preview videos/<slug> # build/preview.png(シーンごとに1フレーム)
python engine/make_video.py render videos/<slug> [--fast]
初回実行時:./setup.sh(Linux/macOS)または setup.ps1(Windows)。完成した動画は output/<slug>.mp4 に保存されます。
参考資料
examples/upi-explained/(ウォームペーパー)とexamples/load-balancer-explained/(ブループリント)— 完全な実例。これらのパターンをコピーします。templates/—script.template.md、storyboard.template.json。docs/01-style-bible.md— 参照チャンネルの特徴を測定したもの(ルールの存在理由)。engine/icon_names.txt— 許可されている全2,359個のアイコン名(Lucide)。