菜单
Use when プレイリストの作成・動画割り当て・状態確認をしたいとき。「プレイリスト作って」「プレイリスト整理」「動画をプレイリストに追加」「プレイリスト状況」「削除済み動画を整理」「初投稿」「初回投稿」「初回公開前にプレイリスト初期化」「/playlist」など、`config/channel/playlists.json` に基づくプレイリスト CRUD の場面で使用すること
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| 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 — 状態表示の読み取り専用 viewerUse when YouTube Analytics データの収集・最新化が必要なとき。「データ更新」「統計を取得」「分析の準備」で発動。/analytics-analyze の前段
Use when コレクションの楽曲を DistroKid 配信用に準備し、distrokid-helper Chrome 拡張へ渡すローカルサーバーを起動したいとき（30-distrokid 生成 / disc 分割 / metadata.md / ジャケット 3000×3000 新規生成 / uv run yt-collection-serve 起動）。『DistroKid 準備』『配信準備』『アルバム化』『distrokid-helper』で発動。DistroKid Web への転記・アップロード操作そのものは Chrome 拡張側の責務
Use when Suno UI で生成した曲のプレイリストを一括 DL + マスター化するとき（前工程 /suno、次工程 /videoup）。Lyria チャンネルでは不要
Use when Suno UI に投入する曲をブラウザで連続生成 + playlist 追加 + 一括ダウンロードしたいとき。uv run yt-collection-serve で suno-prompts.json を配信し、suno-helper Chrome 拡張で 1 タブ完結の自動実行（pattern 注入 → Generate → 完了待機 → 次へ → 全件完了で playlist 一括追加 → ZIP 一括 DL）を回す operator 手順。`/suno` でプロンプトが揃った後、または既存 collection の途中再開で使用する
Use when Suno ボーカル曲の歌詞を生成するとき。「歌詞生成」「vocal」「rap」「suno-lyric」で発動。/suno の前工程。Style / UI 投入は /suno と /suno-helper の責務
Use when Suno UI 投入用の音楽プロンプトを生成するとき。「Suno プロンプト」「Style 文」で発動。歌詞は前工程 /suno-lyric、後工程 /suno-helper → /masterup。Lyria チャンネルは /lyria