القائمة
Use when プレイリストの作成・動画割り当て・状態確認をしたいとき。「プレイリスト作って」「プレイリスト整理」「動画をプレイリストに追加」「プレイリスト状況」「削除済み動画を整理」「初投稿」「初回投稿」「初回公開前にプレイリスト初期化」「/playlist」など、`config/channel/playlists.json` に基づくプレイリスト CRUD の場面で使用すること
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use when まだコレクションディレクトリが存在せず、新規コレクション制作を立ち上げたいとき。「新しいコレクション始めたい」「制作開始」「新規ワークフロー」など、企画選択からディレクトリ作成・素材準備までを行う初期化フェーズで使用する。既存コレクションの進行は /wf-next
Use when /suno で生成したプロンプトを Suno UI で曲にしたあと、そのプレイリストを DL + クロスフェードマスター化したいとき。前工程: /suno（プロンプト生成 → Suno UI で人手楽曲生成）。プレイリスト URL を指定して MP3 一括 DL + マスター音源を自動生成（次工程: /videoup）。Lyria チャンネルでは /lyria が自動で音源を出力するため本スキルは不要
Use when Suno UI に投入する音楽プロンプトを生成したいとき。SunoAI V5.5 向けの YAML 定義（インストは `tracks_per_collection` で曲数指定の独立 entry 並列、ボーカルは `/suno-lyric` で作成済みの歌詞を前提に pattern × tracks_per_pattern 設計）から suno-prompts.md / suno-prompts.json を作成する（次工程 `/suno-helper` でブラウザ自動生成 + playlist 一括追加、その後 `/masterup` で DL + マスター化）。プロンプト作成・Style 文など Suno 連続生成の前段で使用すること。Lyria チャンネルでは /lyria を使う
Use when コレクションの楽曲を DistroKid 配信用に準備し、distrokid-helper Chrome 拡張へ渡すローカルサーバーを起動したいとき（30-distrokid 生成 / disc 分割 / metadata.md / ジャケット 3000×3000 新規生成 / yt-collection-serve 起動）。『DistroKid 準備』『配信準備』『アルバム化』『distrokid-helper』で発動。DistroKid Web への転記・アップロード操作そのものは Chrome 拡張側の責務
Use when YouTube コミュニティ投稿の下書きを生成したいとき。`--type` で behind-the-scenes / next-teaser / poll (deprecated) / day-of-reminder / weekly-feedback を切り替え、本文を生成して `pbcopy` でクリップボードに送る。「コミュニティ投稿作って」「community post」「day-of reminder」「sunday vote」「weekly feedback」「視聴者投票」「公開当日リマインダー」など、YouTube Studio に手動投稿するコミュニティ投稿の下書きが必要な場面で使用すること
Use when YouTube コミュニティ投稿用テキストを生成し、クリップボードコピーと YouTube Studio 起動まで行いたいとき。固定テンプレ運用（動画 1 本 = 投稿 1 本）の Flow365 TTP。「コミュニティ投稿」「community post」「投稿準備」「Studio で投稿」「コミュニティタブ」など、動画公開と前後する投稿準備に関わる場面で使用すること。`/video-upload` の最終ステップから自動で呼ばれる。
| name | playlist |
| description | Use when プレイリストの作成・割り当て・確認をするとき。「プレイリスト作って」「初投稿」「初回投稿」「初回公開前にプレイリスト初期化」「/playlist」で発動 |
uv run yt-playlist-status と uv run yt-playlist-manager を 1 スキルに統合し、プレイリストの状態確認・作成・動画割り当て・クリーンアップを案内する。
config/channel/playlists.json を Canonical ソースとして読み、定義されたプレイリストを YouTube 上に反映する。テーマ別マッチングルール（auto_add_activities / auto_add_themes）や全動画自動追加（auto_add）に対応。
config/channel/playlists.json が存在し、playlists セクションが定義されていること。未定義の場合は /channel-new（再生成モード）を案内する。
playlists.json に定義したプレイリストを YouTube 上に初期化したいときplaylist_id を書き戻したいとき| モード | コマンド | 説明 |
|---|---|---|
| status | uv run yt-playlist-status | 全プレイリストの ID・動画数・マッチングルールを表示（読み取り専用） |
| init | uv run yt-playlist-manager --init [--dry-run] | playlists.json 定義の全プレイリストを作成 + live/ 配下の全動画を割り当て |
| assign | uv run yt-playlist-manager --assign VIDEO_ID --theme THEME [--dry-run] | 単一動画を該当プレイリストに追加（テーマからマッチング） |
| clean-deleted | uv run yt-playlist-manager --clean-deleted [--dry-run] | 全プレイリストから削除済み/非公開動画のエントリを除去 |
uv run yt-playlist-manager --status も同じ PlaylistStatusViewer に委譲するため、uv run yt-playlist-status と等価。
uv run yt-playlist-status
playlist_id・動画数・マッチングルールを一覧表示(未作成) が表示されたら Step 2 の init モードに進むconfig/channel/playlists.json の定義に従って全プレイリストを作成 + live/ 配下の動画を一括割り当て:
uv run yt-playlist-manager --init --dry-run # まずプレビュー
uv run yt-playlist-manager --init # 実反映
注意: --dry-run フラグなしが実反映。yt-channel-settings のように --apply 経由ではないので、dry-run → 確認 → 本番の 2 段階運用を徹底する。
実行後、playlists.json の各エントリに playlist_id が書き戻される。
初投稿前の扱い: collections/live/ がまだ空でも --init を実行してよい。この場合は未作成プレイリストの作成と playlist_id 書き戻しが主目的で、初回動画の追加は後続の /video-upload に任せる。collection 型では /video-upload 内部の自動 assign (assign_video()) が追加を担う。初投稿前に (未作成) が残っているとアップロード時の自動 assign がスキップされるため、公開前に必ず初期化する。
新しい動画を YouTube にアップロードしたあと、該当プレイリストに追加:
uv run yt-playlist-manager --assign <VIDEO_ID> --theme <THEME>
<THEME> は workflow-state.json の theme 値（content.json の theme_scenes で定義されたキー）"all" プレイリストには末尾追加、それ以外は先頭追加（YouTube 表示順制御）自動連携: /video-upload から呼ばれる collection_uploader 内部でも同じ assign_video() が走るため、通常運用では手動 assign は不要。手動 assign が必要なのは: 過去動画の再割り当て / 新テーマ追加後のレトロフィット / マッチングルール変更後の再同期。
YouTube 側で削除された動画が playlistItems に残ったままになることがあるため、定期的に除去:
uv run yt-playlist-manager --clean-deleted --dry-run # 影響範囲をプレビュー
uv run yt-playlist-manager --clean-deleted # 実反映
| 状況 | 兆候 | 対処 |
|---|---|---|
| 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 のステータスを確認し、時間を置いて再実行 |
/video-upload — アップロード時に内部で assign_video() が呼ばれる（手動 assign 不要が基本）/channel-new（再生成モード） — playlists.json の初期定義config/channel/playlists.json — Canonical ソースsrc/youtube_automation/scripts/playlist_manager.py — 実装本体src/youtube_automation/scripts/playlist_status.py — 状態表示の読み取り専用 viewer