---

name: history-long-video description: "既存ショート動画を結合してYouTubeロング動画を制作。「ロング動画」「YouTube長尺」「まとめ動画」などの作業に使う。"

history-long-video

既存ショート動画を結合して、YouTube向けロング動画（横長 1920x1080）を制作するスキル。

概要

• ターゲット: 10〜15分の横長まとめ動画（YouTube向け）
• 入力: 制作済みショート動画（output/{slug}/final.mp4）
• 出力: 横長 1920x1080 MP4 + YouTubeチャプターマーカー + サムネイル
• 依存: history-short-video（ショート動画の制作）、VOICEVOX Engine

作業前に必ず読むこと

1. history-video-base/SKILL.md を読む（音声・画像・BGM・FFmpeg 等の共通仕様）
2. この SKILL.md を最後まで読む
3. LEARNINGS.md を読む
4. VOICEVOX Engine が起動しているか確認

ワークフロー

1. 企画定義（series.json の long フィールド）
2. AI監査: 事実確認 + 読み確認（Phase 1.5 参照）
3. ソースショート動画の確認（全 final.mp4 が存在するか）
4. compose-long-video.py でロング動画合成
5. Web UIで動画プレビュー確認
6. ユーザー確認（タイトル・説明文・サムネイルを提示）
7. YouTube アップロード（private → 確認 → public）
8. LEARNINGS.md に学びを追記

Phase 1: 企画定義（series.json）

ロング動画は series.json の各シリーズ内 long フィールドで定義する。

構造例は references/example-series-long.json を参照。

各フィールド:

• id: 出力ディレクトリ名（output/{id}/final.mp4）
• title: 動画タイトル。｜ で区切ると改行表示。【前編】【後編】 で分巻を明示
• chapters[].title: {時代名} — {サブタイトル} 形式。— で分割してカード表示
• chapters[].sourceSlug: ソースショート動画のスラグ

Phase 1.5: AI監査（事実確認 + 読み確認）

history-video-base の「AI監査ポリシー」に従い、合成前に必ず実行する。

レイヤー1: 事実確認

Claude Code が series.json の long フィールド内テキストを監査する:

• title: 動画タイトルの歴史的正確さ
• chapters[].title: 各チャプター名の時代名・サブタイトルが正しいか
• チャプターの時系列順序が正しいか

レイヤー2: 読みAI監査

チャプタータイトルは VOICEVOX でナレーション化される。 Claude Code が各タイトルの難読語・歴史固有名詞を抽出し、base-dictionary.json に辞書エントリがあるか確認。 未登録なら base-dictionary.json と VOICEVOX ユーザー辞書の両方に追加。

レイヤー3: 実文脈読みテスト（最重要）

• 全チャプタータイトル・オープニングテキストを VOICEVOX audio_query API に投げ、返ってきたカタカナ読みを全文チェック
• 辞書登録済みでも priority 不足や文脈依存で誤読されるケースがある（例: 「徳川家康」→「ケヤスシ」、「豊臣家」→「トヨトミカ」）
• 誤読発見時は priority: 10 で辞書再登録し、修正後に全テキストを再テスト
• 手動ピックアップではなく、全テキスト網羅テストであること

テストスクリプト: scripts/voicevox-reading-test.py

3レイヤーすべて通過してから合成に進む。

Phase 2: ソース確認

すべてのソースショートが制作済みか確認する。

# 各ソースの final.mp4 存在確認
for slug in jomon-yayoi kofun-asuka nara ...; do
  ls scripts/video-gen/output/$slug/final.mp4
done

未制作のショートがあれば、先に history-short-video スキルで制作する。

Phase 3: ロング動画合成

VOICEVOX Engine を起動してから実行すること。 VOICEVOX の設定詳細は history-video-base を参照。

cd ~/Dev/content-studio/scripts/video-gen
python3 compose-long-video.py {long-id}
# e.g., python3 compose-long-video.py jidai-long-zenpen

compose-long-video.py の処理内容

1. ベース辞書登録（register_base_dict()）

   • base-dictionary.json の全語を VOICEVOX ユーザー辞書に一括登録
   • ナレーション生成前に必ず実行（未登録だと固有名詞の誤読が発生する）

2. VOICEVOX でナレーション生成

   • オープニング: "{シリーズ名}。{タイトル}。"
   • 各チャプター: "第N章、{時代名}。{サブタイトル}。"
   • Speaker: まい（ID 1431611904）

3. オープニングカード生成（横長 1920x1080）

   • HTML → Playwright スクリーンショット → ナレーション付きクリップ
   • 左: craftgarden バッジ + タイトル、右: チャプター一覧

4. チャプターカード生成（各章の冒頭）

   • 中央に時代名（88pt）+ サブタイトル
   • ナレーション付き

5. ショート動画を横長変換

   • 縦 1080x1920 → 横 1920x1080
   • 中央に縦動画、背景にぼかし拡大版（boxblur + eq=brightness=-0.15）

6. クロージングカード（CTA エンドカード）

   • assets/cta-endcard-landscape.png（横長版、QRコード付き）
   • 5秒間の無音クリップ

7. 全セグメント結合

   • 構成: オープニング → [チャプターカード → ショート横長] × N → クロージング
   • 映像コピー + オーディオ再エンコード（タイムスタンプ不連続を解消）
   • faststart 適用（moov atom を先頭に移動 → シーク性能改善）

8. YouTube チャプターマーカー生成

   • output/{id}/chapters.txt に MM:SS チャプター名 形式で出力

重要な技術的注意点

項目	正しい方法	やってはいけないこと
concat 時の音声	-c:v copy -c:a aac -b:a 128k	-c copy（音声もコピーするとシーク時にデコーダ破綻）
カードの音声チャンネル	-ac 2（ステレオに統一）	モノラルのまま結合（ショートがステレオなので不一致でノイズ発生）
moov atom	-movflags +faststart 必須	faststart なし（シーク時に無音・ガチャガチャ音）
動画配信	public/video-output symlink で静的配信	自作 Range request ハンドラ（バグの温床）

音声チャンネル統一方針・ffmpeg 共通オプションの詳細は history-video-base を参照。

Phase 4: Web UI でプレビュー

動画プレビューの仕組みは history-video-base を参照。

http://localhost:3001/videos/series/{series-id}

• 「ロング」タブで動画を再生・シーク確認
• チャプター遷移の音声が途切れないか確認
• エンドカードの表示確認

Phase 5: サムネイル作成

YouTubeサムネイル（1280x720）を作成する。

1. HTML テンプレート作成（output/{id}/thumbnail.html）
2. Playwright でスクリーンショット: scripts/generate-thumbnail.py

サムネイルデザイン方針:

• craftgarden カラー（詳細は history-video-base を参照）
• 左: タイトル（キーワードをハイライト色 #A8D5A2）
• 右: チャプター一覧（コンパクト表示）
• 右上: 時間バッジ（「13分で総復習」など）

Phase 6: YouTube アップロード

Step 1: private でアップロード

cd ~/Dev/content-studio/scripts/youtube-upload
python3 upload.py \
  --video {long-id} \
  --test \
  --title "タイトル" \
  --description "説明文"

Step 2: サムネイル設定

スクリプト: scripts/youtube-set-thumbnail.py

Step 3: 説明文テンプレート

テンプレートと注意事項: references/template-youtube-description.md

Step 4: ユーザー確認 → 公開

スクリプト: scripts/youtube-publish.py

チェックリスト

• history-video-base/SKILL.md を読んだ
• LEARNINGS.md を読んだ
• series.json の long 定義を確