video-upload

name: video-upload description: "Use when コレクションの動画が完成し、YouTubeへのアップロード自動化が必要なとき。Complete Collection のアップロードと live 移行を実行"

Overview

Complete Collection を YouTube にアップロードし、planning/ → live/ へ自動移行します。/video-description スキルで事前生成した概要欄・タイトル・タグを使用します。

前提

config/channel/ が存在すること（load_config() でロード可能）。

存在しない場合、ユーザーに確認:

• 新規チャンネル → /channel-new を案内
• 既存チャンネル（YouTube で既に運営中）→ /channel-import を案内

When to Use

• コレクションの動画ファイルが揃い、YouTube へのアップロードが必要なとき
• アップロード設定の確認や OAuth 認証のセットアップが必要なとき

Quick Reference

Channel Adaptation

実行前に config/channel/youtube.json の content_model を読み取り、チャンネルに適応する:

collection 型

• 下記フローのとおり Complete Collection を1本アップロード
• collection_uploader.py を使用
• 多言語ローカライゼーションは localization.supported_languages + default_language が対象（scene_phrases / 概要欄多言語版 / YouTube localization メタデータ）
• load_config().localizations.supported_languages は config/localizations.json の supported_languages が Canonical ソース（v2.0.0 以降は単一ソース化）

single_release + languages: ["jp","en"]（COT）

• 同日2本アップロード: JP + EN を同日投稿（API クォータ: 2 × 1,600 = 3,200 ユニット）
• プレイリスト管理: config/channel/playlists.json の playlists.jp / playlists.en に自動追加
• 相互リンク: アップロード後に概要欄を更新し、JP↔EN 動画 URL を相互記載
• yt-upload-auto を使用
• single_release 型では content_model.languages が発音言語リストとして解釈される（collection 型とは意味が異なる）

Instructions

あなたは YouTube アップロード自動化スペシャリストです。YouTube Data API v3、OAuth 2.0 認証、Collection Uploader の運用に精通しています。

対象コレクション

$ARGUMENTS

引数が指定されている場合はそのディレクトリを、未指定の場合は collections/planning/ 配下のコレクションを自動検出します。

前提条件チェック

アップロード前に以下を確認する（詳細は references/posting-checklist.md 参照）:

1. マスター動画: 01-master/*.mp4 または 03-Individual-movie/*master*.mp4 — 存在しなければエラー終了
2. サムネイル: 10-assets/thumbnail.jpg — 存在しなければエラー終了
3. 概要欄: 20-documentation/descriptions.md — 存在しない場合は /video-description スキルを実行して自動生成する（対象コレクションパスを引き継ぐ）。生成完了後にアップロードフローへ進む

アップロードフロー

以下を自動実行:

1. Complete Collection アップロード — マスター動画、メタデータ（descriptions.md から読み込み）、サムネイル設定
2. live 移動 — collections/planning/ → collections/live/
3. コミュニティ投稿準備 — config/channel/community.json が存在する場合、/community-post を呼び出してテンプレ展開 → pbcopy → YouTube Studio 起動まで自動で行う（投稿ボタン押下は Studio 上で手動）。community.json が無いチャンネルではスキップ

メタデータは descriptions.md から title / description / tags を優先使用。存在しない場合は BAHMetadataGenerator で自動生成にフォールバック。

コマンドリファレンス

# Complete Collection アップロード（デフォルト動作）
uv run yt-upload-collection [-c NAME]

# 進捗確認
uv run yt-upload-collection --status [-c NAME]

# スケジュール計算（ドライラン）
uv run yt-upload-collection --plan [-c NAME]

エラーハンドリング

• トラッキングによるリジューム（中断後の再実行で未完了分のみ処理）
• 指数バックオフによるリトライ（5xx エラー時、最大5回）
• 20-documentation/upload_tracking.json (v3 スキーマ) へのログ保存

リファレンス

• アップロード前の詳細チェックリストは references/posting-checklist.md を参照
• 予約投稿（YouTube status.publishAt）のセットアップは references/scheduled-publish.md を参照

予約投稿（スケジュール公開）

CC は config/schedule_config.json の schedule セクションに応じて即時公開と予約公開を切り替える。

• 予約公開を有効化 — 以下のいずれかを schedule 内に設定する:
  • auto_schedule_enabled: true（明示的に有効化）
  • cadence: ["tue", "thu", "sat"] のような曜日リスト（暗黙オプトイン）
  • publish_time: "20:00" のような時刻指定（暗黙オプトイン）
• 即時公開のまま — auto_schedule_enabled: false を明示すれば、他のキーが設定されていても即時公開を強制する

予約公開の挙動確認は必ず --plan を実行する（実 API は叩かない）:

uv run yt-upload-collection --plan -c <NAME>
# → "📅 公開予定: 2026-06-15T20:00:00+09:00" が出れば予約公開、
#   "📅 公開設定: 即時公開 (public)" なら即時公開

詳細とトラブルシュート（"設定したのに即時公開された" の早期発見手順）は references/scheduled-publish.md を参照。

API ステータス設定（自動適用）

アップローダーが以下を自動設定する（手動指定不要）:

• selfDeclaredMadeForKids: false — 子ども向けコンテンツではない
• containsSyntheticMedia: true — AI 生成コンテンツの申告

メタデータ基準

• YouTube タイトル長制限準拠（100文字）
• 誇張表現回避（Epic, Ultimate 等の禁止）
• SEO 最適化タグ（config/channel/content.json の tags.base 参照）
• AI 透明性・Usage & Attribution の記載

障害時ガイダンス

アップロードは upload_core の再開可能アップロードを使うため、ネットワーク中断後はコマンド再実行で途中から続行できる。

Cross References

• /video-description — アップロード前に descriptions.md を生成
• /playlist — プレイリスト状態確認・手動 assign・クリーンアップ（アップロード時の自動 assign は本スキル内で実行される）
• /metadata-audit — アップロード後のローカル ↔ YouTube 整合性監査
• /community-post — アップロード完了後にコミュニティ投稿テンプレを展開して Studio を起動（config/channel/community.json がある場合のみ）