| name | video-upload |
| description | Use when コレクションの動画が完成し、YouTubeへのアップロード自動化が必要なとき。Complete Collection のアップロードと live 移行を実行。動画ファイルの生成（MP3→MP4）は /videoup |
Overview
Complete Collection を YouTube にアップロードし、planning/ → live/ へ自動移行します。/video-description スキルで事前生成した概要欄・タイトル・タグを使用します。
前提
config/channel/ が存在すること（load_config() でロード可能）。
存在しない場合、ユーザーに確認:
- 新規チャンネル →
/channel-new を案内
- 既存チャンネル（YouTube で既に運営中）→
/channel-new（既存チャンネル取り込みモード）を案内
When to Use
- コレクションの動画ファイルが揃い、YouTube へのアップロードが必要なとき
- アップロード設定の確認や OAuth 認証のセットアップが必要なとき
Quick Reference
| 引数 | 説明 | 例 |
|---|
$ARGUMENTS | コレクションディレクトリパス（省略可） | /video-upload collections/planning/20260304-clm-fairy-forest-collection |
| 未指定 | collections/planning/ から自動検出 | /video-upload |
Channel Adaptation
実行前に config/channel/youtube.json の content_model を読み取り、チャンネルに適応する:
| content_model.type | 動作 | 対応言語の出所 |
|---|
collection | Complete Collection アップロード → live 移動（単一動画） | config/localizations.json / load_config().localizations.* |
single_release | 言語ごとに別動画をアップロード | content_model.languages（発音言語リスト） |
collection 型
- 下記フローのとおり Complete Collection を1本アップロード
collection_uploader.py を使用- 多言語ローカライゼーションは
config/localizations.json の supported_languages が Canonical ソース（v2.0.0 以降は単一ソース化）
supported_languages が 2 言語以上の場合のみ scene_phrases / 概要欄多言語版 / YouTube localization メタデータを生成・検証する。単一言語チャンネルでは scene_phrases は不要
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 を相互記載
uv run yt-upload-auto を使用- single_release 型では
content_model.languages が発音言語リストとして解釈される（collection 型とは意味が異なる）
uv run yt-upload-collection --plan は collection 専用の事前確認であり、single_release 型では使わない。公開時刻は uv run yt-upload-auto の実アップロード経路（metadata の publish_at または config/channel/youtube.json の既定時刻 fallback）に従う
Instructions
あなたは YouTube アップロード自動化スペシャリストです。YouTube Data API v3、OAuth 2.0 認証、Collection Uploader の運用に精通しています。
対象コレクション
$ARGUMENTS
引数が指定されている場合はそのディレクトリを、未指定の場合は collections/planning/ 配下のコレクションを自動検出します。
前提条件チェック
アップロード前に以下を確認する（詳細は references/posting-checklist.md 参照）:
- マスター動画:
01-master/*.mp4 または 03-Individual-movie/*master*.mp4 — 存在しなければエラー終了
- サムネイル:
10-assets/thumbnail.jpg → 10-assets/thumbnail.png の候補順で探索 — いずれも存在しなければエラー終了。main.png/jpg は textless 動画背景なので upload thumbnail には使わない
- 概要欄:
20-documentation/descriptions.md — 存在しない場合は /video-description スキルを実行して自動生成する（対象コレクションパスを引き継ぐ）。生成完了後にアップロードフローへ進む
- 初投稿時のプレイリスト初期化:
config/channel/playlists.json が存在する場合は /playlist スキルで uv run yt-playlist-status を実行する。(未作成) があるときは、初投稿前に uv run yt-playlist-manager --init --dry-run → ユーザー確認 → uv run yt-playlist-manager --init で playlist ID を作成・書き戻してからアップロードへ進む
collection アップロードフロー
content_model.type = "collection" のとき、以下を自動実行:
- 公開タイミング確定（必須） — ユーザーに公開方法を案内・確認する前に必ず
uv run yt-upload-collection --plan [-c NAME] を実行し、実際の公開挙動を確定する。config/schedule_config.json の予約設定や config/channel/youtube.json の既定時刻により、privacy=public でも status.publishAt が設定される場合があるため、plan 結果なしに「即時公開」と案内しない
- Complete Collection アップロード — マスター動画、メタデータ（descriptions.md から読み込み）、サムネイル設定
- live 移動 —
collections/planning/ → collections/live/
- コミュニティ投稿準備 —
config/channel/community.json が存在する場合、/community-post を呼び出してテンプレ展開 → pbcopy → YouTube Studio 起動まで自動で行う（投稿ボタン押下は Studio 上で手動）。community.json が無いチャンネルではスキップ
メタデータは descriptions.md から title / description / tags を優先使用。存在しない場合は BAHMetadataGenerator で自動生成にフォールバック。
プレイリストへの動画追加は後続のアップロード経路が担う。collection 型では collection_uploader 内部の assign_video() に任せる。初投稿時に /playlist で行うのは未作成プレイリストの作成と playlist_id 書き戻しであり、個別動画の手動 assign ではない。
single_release アップロードフロー
content_model.type = "single_release" のときは uv run yt-upload-auto を使い、言語ごとに別動画をアップロードする。uv run yt-upload-collection --plan は collection uploader の公開予定計算なので、この分岐では実行しない。公開時刻を案内する場合は、uv run yt-upload-auto が読む metadata の publish_at と config/channel/youtube.json の既定時刻 fallback に基づくことを明示し、collection 用 plan 結果を流用しない。
コマンドリファレンス
uv run yt-upload-collection [-c NAME]
uv run yt-upload-collection --status [-c NAME]
uv run yt-upload-collection --plan [-c NAME]
uv run yt-upload-auto
エラーハンドリング
- トラッキングによるリジューム（中断後の再実行で未完了分のみ処理）
- 指数バックオフによるリトライ（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" のような時刻指定（暗黙オプトイン）
- チャンネル既定時刻 —
config/channel/youtube.json の youtube.default_publish_time / default_publish_timezone を設定すると、schedule_config.json で予約設定が無い場合の fallback として次回の予約時刻を自動適用する
- 即時公開のまま —
auto_schedule_enabled: false を明示すれば、他のキーが設定されていても即時公開を強制する
collection 型では、ユーザーに公開方法を提示する前の挙動確認は必ず --plan を実行する。--plan はアップロード API は叩かないが、予約日時計算のため YouTube read API を呼ぶ場合がある:
uv run yt-upload-collection --plan -c <NAME>
「即時公開」と断定してよいのは、plan 結果が 📅 公開設定: 即時公開 (public) の場合のみ。📅 公開設定: 限定公開 (unlisted) / 📅 公開設定: 非公開 (private) が出た場合は、その公開範囲でアップロードされることを明示する。📅 公開予定: <日時> が出た場合は「今アップロード → <日時> に自動で一般公開」と、実際の公開予定時刻を明示して案内する。
詳細とトラブルシュート（"設定したのに即時公開された" の早期発見手順）は 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 の再開可能アップロードを使うため、ネットワーク中断後はコマンド再実行で途中から続行できる。
| 状況 | 兆候 | 対処 |
|---|
| OAuth 未認証/失効 | auth.oauth_handler の FileNotFoundError（client_secrets.json 不在）/ AuthError / HTTP 403 | 初回認証フローを再実行。403 が続く場合は auth/token.json を削除しスコープを確認のうえ再認証 |
| YouTube quota / rate | HTTP 429 / 403 quotaExceeded | 日次 quota（既定 10,000 units・太平洋時間 0 時リセット）を待つか呼び出しを抑える |
| API 障害 / サービス停止 | HTTP 503 / タイムアウト | Google Cloud / YouTube のステータスを確認し、時間を置いて再実行 |
Cross References
/video-description — アップロード前に descriptions.md を生成/playlist — 初投稿前のプレイリスト初期化、状態確認、手動 assign、クリーンアップ（アップロード時の自動 assign は本スキル内で実行される）/metadata-audit — アップロード後のローカル ↔ YouTube 整合性監査/community-post — アップロード完了後にコミュニティ投稿テンプレを展開して Studio を起動（config/channel/community.json がある場合のみ）
