菜单
Use when Vertex AI Lyria 3 でマスター音源を自動生成したいとき。skill-config と Lyria 3 `interactions` REST API を組み合わせ、コレクション尺に合わせて複数セグメント (1 リクエスト = 最大 ~184 秒のオーディオ、API は MP3 を返し保存時に PCM s16le WAV へ変換) を生成しクロスフェード結合してマスター音源を出力する（人手介入なし、/masterup 不要、次工程は /videoup）。Suno で人手生成するチャンネルでは /suno を使う
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use 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 プレイリストの作成・割り当て・確認をするとき。「プレイリスト作って」「初投稿」「初回投稿」「初回公開前にプレイリスト初期化」「/playlist」で発動
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 の責務
| name | lyria |
| description | Use when Vertex AI Lyria 3 でマスター音源を自動生成するとき（/masterup 不要、次工程 /videoup）。Suno 人手生成チャンネルは /suno を使う |
Vertex AI Lyria 3 REST API (interactions エンドポイント) を使い、config/skills/lyria.yaml のスタイル定義とユーザー指定テーマからプロンプトを組み立て、Lyria 3 API を呼んでマスター音源を生成する。
Lyria 3 Pro は 1 リクエストあたり最大約 184 秒（~3 分） までのオーディオを返す。本スキルは config/channel/audio.json の audio.target_duration_min から必要セグメント数 N を自動算出し、yt-generate-lyria-master CLI 経由で N セグメント生成 → クロスフェード結合まで一気通貫で実行する（generate_master.generate_master() の WAV 経路を再利用）。
前提確認や Step 1 に入る前に、以下を必ず Read（Codex では同等のファイル閲覧）で開く。SKILL.md の説明や記憶から設定値を推測しない。
.claude/skills/lyria/config.default.yamlconfig/skills/lyria.yaml（存在する場合）読み込み後は youtube_automation.utils.skill_config.load_skill_config("lyria") と同じ deep-merge 前提で、チャンネル上書きを優先して扱う。存在しない override は未設定として扱い、勝手に作成しない。
以下が揃っていること:
config/channel/ が存在する（config/channel/audio.json の audio.target_duration_min を参照）_disabled が false であること（config/skills/lyria.yaml で上書きしない限り、配布された config.default.yaml の default false が使われる）gcloud auth application-default login + set-quota-project）。Vertex AI interactions エンドポイントは ADC で呼び、project_id は ADC quota project から自動解決される（GOOGLE_CLOUD_PROJECT は任意で上書き可）config/skills/lyria.yaml はオプション。yt-skills sync で配布される config.default.yaml がそのまま使われるため、default 動作で問題なければ作成不要。カスタマイズしたい場合のみ config.default.yaml をコピーして config/skills/lyria.yaml に置き、必要な値だけ上書きする（deep-merge される）。
不足する場合、ユーザーに確認:
config/channel/ が無い新規チャンネル → /channel-new を案内config/channel/ が無い既存チャンネル → /channel-new（既存チャンネル取り込みモード）を案内_disabled: true のチャンネル → /suno を案内して終了する（Lyria を使わない方針）/suno + /masterup の代替として、API 完全自動の音楽生成を行いたいとき/channel-new（方向性検討モード）で suno/lyria を検討 → /channel-new（再生成モード）が config/channel/youtube.json の music_engine に書き込む/wf-new の yt-init-collection --music-engine lyria でコレクション毎に上書き可能（省略時はチャンネル設定を継承）/wf-new が workflow-state.json の music_engine = "lyria" を判定して /lyria を自動実行する。手動で /lyria <theme> を叩いた場合もこのスキルに入る| コマンド | 説明 | 例 |
|---|---|---|
/lyria <theme> | プロンプト設計 + Lyria 3 API 呼び出し（N セグメント生成 + 結合） | /lyria rain-against-glass |
$ARGUMENTS
$ARGUMENTS → コレクションのテーマ指定
実行前に config/skills/lyria.yaml から base 設定を読み取り、テーマに最適化されたプロンプトを設計する。
| skill-config キー | 用途 |
|---|---|
_disabled | true なら /suno を案内して終了 |
model | 本生成モデル (lyria-3-pro-preview) |
prompt_prefix | プロンプト先頭の共通ジャンル句 |
style_hints | 補足スタイル句（optional） |
ng_words | プロンプトに使用禁止の語（Claude がプロンプト設計時にチェック） |
duration_padding_min | audio.target_duration_min に上乗せする余裕分（分）。yt-generate-lyria-master が ceil((target + padding) * 60 / 184) でセグメント数を算出する |
default_bpm | チャンネル共通 BPM（generate_music() の bpm 引数に流用、個別上書き可） |
default_intensity | チャンネル共通 intensity（generate_music() の intensity に流用、個別上書き可） |
default_mode | チャンネル共通 mode（generate_music() の mode に流用、個別上書き可） |
default_reference_image | チャンネル共通参照画像パス（generate_music() の reference_image に流用、個別上書き可） |
読み込み確認:
uv run python -c "from youtube_automation.utils.skill_config import load_skill_config; import json; print(json.dumps(load_skill_config('lyria'), indent=2, ensure_ascii=False))"
config/channel/audio.json からは audio.target_duration_min（コレクション全体の基準長）のみ参照する。1 リクエストあたり ~184 秒の制約があるため、yt-generate-lyria-master がこの値と duration_padding_min から必要セグメント数 N を自動算出する。
lyria_client.generate_music() は以下の構造化パラメータを受け取れる（1 リクエスト 1 セグメント返り）。
| キー | 型 | 説明 |
|---|---|---|
prompt | string | プロンプト本文。skill-config の prompt_prefix ＋ style_hints ＋ テーマに合わせた主役楽器・演奏指示で組み立てる |
model | string | lyria-3-pro-preview（本生成）/ lyria-3-clip-preview（30 秒固定、通常は使わない） |
reference_image | Path | 参照画像パス。textless 動画背景 / ビジュアル参照画像 10-assets/main.png を指せば音源の雰囲気が画像に寄る。対応形式: .png/.jpg/.jpeg/.webp |
bpm | int | BPM。プロンプトに ", {bpm} BPM" として自動合成される。目安 60-180 |
intensity | "low" / "medium" / "high" | それぞれ "mellow, low-energy" / "balanced, moderate energy" / "driving, high-energy" に展開される |
mode | "instrumental" / "vocal" | instrumental は末尾に ". Instrumental." を付加、vocal は lyrics 未指定時のみ ". With vocals." を付加 |
lyrics | string | 歌詞。末尾に ". Lyrics: ..." として合成される。[Verse] [Chorus] の section tag 使用可 |
API 仕様上の注意: Lyria 3 interactions で真の構造化入力は reference_image のみ。bpm/intensity/mode/lyrics は独立フィールドではなく、プロンプトテキストへの自然言語埋め込みとして送信される。
duration の制約: Lyria 3 Pro は 1 リクエスト ~184 秒が上限。長さはプロンプトのヒント扱いでぴったり一致せず、レスポンス全体をそのままクロスフェード結合する運用になる。N セグメント生成 → 結合は yt-generate-lyria-master が自動化する（後述 Step 4）。
あなたは Lyria 3 音源生成のオーケストレーターです。
config/skills/lyria.yaml の値からプロンプトと API 入力パラメータを組み立て、yt-generate-lyria-master CLI に委譲して N セグメント生成 + クロスフェード結合を実行します。
_disabled: true の場合、以下を出力して終了:
Lyria はこのチャンネルで無効化されています (
config/skills/lyria.yamlの_disabled: true)。音楽生成は/suno <theme>を使用してください。
$ARGUMENTS
collections/planning/ の workflow-state.json を検索thumbnail-approved フェーズのコレクションを対象config/skills/lyria.yaml の prompt_prefix をそのまま使用。楽器名・ムード語を追加しないconfig/skills/lyria.yaml の ng_words と /suno 側 references/suno-examples.md の禁止形容詞リストに準拠詳しい推奨値・NG パターンは references/lyria-tuning-guide.md を参照。
最終的に generate_music(prompt=..., ...) に渡す文字列は以下のような構造で組み立てる:
{prompt_prefix}, {style_hints}, {主役楽器の演奏指示}, {テーマに沿った最小限の情景描写}
例（テーマ: rain-against-glass、skill-config の prompt_prefix = "celtic folk only, clean dry recording, no pads"）:
celtic folk only, clean dry recording, no pads, gentle melodic phrases rising and falling, solo fingerpicked acoustic guitar
skill-config のチャンネル共通値（default_bpm / default_intensity / default_mode / default_reference_image）を初期値とし、テーマに応じて個別調整してから yt-generate-lyria-master のフラグに渡す。
reference_image: コレクションの 10-assets/main.png（存在すれば）bpm: テーマに沿った値（default_bpm を出発点）intensity: テーマに沿った値（default_intensity を出発点）mode: 通常 instrumental設計したプロンプトと API 入力パラメータを 20-documentation/lyria-prompt.md に書き出す:
reference_image / bpm / intensity / mode）ユーザーにプロンプト・パラメータの確認を求める
修正があれば lyria-prompt.md を編集して再確認
ユーザー承認後、yt-generate-lyria-master CLI を呼ぶ。CLI が以下を一気通貫で実行する:
audio.target_duration_min + skill-config duration_padding_min から必要セグメント数 N を自動算出（ceil((target + padding) * 60 / 184)）lyria_client.generate_music() を N 回呼び、レスポンスを 02-Individual-music/{NN}_{name}.wav に PCM s16le 48 kHz stereo で保存（既存ファイルは skip = resume 可能）--max-retries 回までリトライgenerate_master.generate_master() 経由でクロスフェード結合し 01-master/master.mp3 を出力（masterup.audio.crossfade_duration を参照）uv run yt-generate-lyria-master \
--prompt "celtic folk only, clean dry recording, no pads, gentle melodic phrases rising and falling, solo fingerpicked acoustic guitar" \
--name rain-against-glass \
--bpm 72 \
--intensity low \
--mode instrumental \
--reference-image 10-assets/main.png
主要フラグ:
| フラグ | 用途 |
|---|---|
--prompt (必須) | Step 2 で設計したプロンプト本文 |
--name (必須) | セグメントファイル名スラグ。02-Individual-music/01_<name>.wav 〜 NN_<name>.wav |
--bpm / --intensity / --mode / --lyrics | generate_music() にそのまま転送 |
--reference-image | コレクション相対 or 絶対パス。例: 10-assets/main.png |
--target-duration MIN | 目標尺を CLI で上書き（省略時は config/channel/audio.json の audio.target_duration_min） |
--padding-min MIN | 余裕分を CLI で上書き（省略時は skill-config duration_padding_min） |
--model | Lyria モデル名（省略時は skill-config model） |
--max-retries N | 1 セグメントあたりの失敗時リトライ回数（default: 3） |
--collection PATH | コレクションディレクトリ（省略時は CWD） |
.envは自動ロード:lyria_client内でdotenvにより自動読み込みされる。
注意点:
N × 約 30〜90 秒 程度を要する生成完了後、コレクションディレクトリから worktree_sync.sh を実行する。
ワークツリー検出・パス算出・コピーをすべて自動で行う（メインリポジトリで実行時は自動スキップ）。
bash "$(git rev-parse --show-toplevel)/.claude/skills/lyria/references/worktree_sync.sh"
コピー対象:
01-master/master.mp3 → メインの 01-master/10-assets/main.png → メインの 10-assets/事前確認には --dry-run を付ける。
workflow-state.json の planning.music セクションを populate（下記参照）assets.music_prompts = true に更新assets.raw_master に生成されたマスター音源ファイル名（例: master.mp3）を記録最終マスター確定（assets.master_audio）と phase: "mastered" への遷移は、ユーザーがミキシング+マスタリングした最終ファイルを 01-master/ に配置した後に /wf-next が検出して更新する（本スキルの責務外）。
/alignment-check がコレクション横断で音楽 mood × サムネ × タイトルの整合を機械的に判定できるよう、workflow-state.json の planning.music セクションを populate する。新規制作分は必須。
{
"planning": {
"music": {
"engine": "lyria",
"mood": ["meditative", "warm"],
"atmosphere": "slow fingerpicked guitar in a quiet hall",
"tempo": "slow",
"instruments": ["fingerpicked guitar", "soft piano"],
"exclude": ["orchestral", "synthesizer"]
}
}
}
書き方ガイド:
| フィールド | ソース | 補足 |
|---|---|---|
engine | 固定値 "lyria" | — |
mood | intensity + style_hints + プロンプトから蒸留 | 感情語 1-3 個（例: ["meditative", "warm"]） |
atmosphere | プロンプトの世界観 1 文（prompt_prefix の意図 + 主役楽器の集約） | 個別 prompt をそのまま貼らず、コレクション全体を 1 文で言い切る |
tempo | bpm から自然言語化 | <60 → very slow / 60-79 → slow / 80-99 → gentle / 100-119 → moderate / ≥120 → lively。bpm 未指定なら intensity から（low → slow / medium → moderate / high → lively） |
instruments | プロンプトの楽器名を集約（重複排除） | "solo fingerpicked guitar" → fingerpicked guitar のように楽器名のみ抽出。主役 3-5 個に絞る |
exclude (optional) | config/skills/lyria.yaml の ng_words から楽器系のみ | orchestral / synthesizer / ambient pads 等。環境音系は対象外 |
冪等性: 既存値があっても planning.music 全体を上書きする（merge しない）。スキル再実行 = プロンプト設計やり直しと見なす。
プロンプトと API 入力パラメータの品質チェック:
prompt_prefix が config/skills/lyria.yaml の prompt_prefix に基づいていることng_words に含まれる語がプロンプトに使われていないことrain beginning to tap 等）が使用されていないことreference_image を使う場合、コレクションの 10-assets/main.png を指していることbpm を指定する場合は 60-180 の整数で、チャンネル audio config と整合していることintensity は "low" / "medium" / "high" のいずれかであることmode は "instrumental" / "vocal" のいずれかであることyt-generate-lyria-master は Lyria 3 API を N セグメント分逐次呼び出し、最後にクロスフェード結合まで行うため N × 30〜90 秒 かかる（典型的にコレクション全体で 5〜20 分）。必ず Bash ツールを run_in_background=true で起動する。これによりユーザーは処理中も同じセッションで質問できる（Claude Code は完了時に自動でメッセージ通知するため、sleep ループや until での自前ポーリングは禁止）。
spawn 例:
uv run yt-generate-lyria-master \
--prompt "<Step 2 のプロンプト>" \
--name <theme-slug> \
--bpm <bpm> --intensity <intensity> --mode instrumental \
--reference-image 10-assets/main.png \
> /tmp/lyria-$(date +%s).log 2>&1
これを Bash run_in_background=true で投げ、spawn 直後に次のメッセージを返す:
⏳ Lyria 3 で N セグメント生成中（推定 N × 30〜90 秒）。完了まで他の質問にもお答えできます。 ログ: /tmp/lyria-*.log
cmux 環境下（$CMUX_WORKSPACE_ID あり）であれば補助で cmux set-status "lyria" "running" --icon "hourglass" --color "#f59e0b"、完了で cmux clear-status "lyria" + cmux notify --title "lyria 完了" を呼ぶ（非 cmux 環境では skip）。
完了通知が届いたらログ末尾から結果サマリー（生成セグメント数、01-master/master.mp3 のパス）をユーザーへ返す。429 / クォータエラーが出た場合はそのエラー行を抜き出して報告し、--max-retries の調整やリトライタイミングを提案する。
/lyria は音源（WAV）を作る工程で、映像オーバーレイ（ビジュアライザー・波形・購読ボタンポップアップ等）は扱わない。
ユーザーから「ビジュアライザー付きで」「波形を出して」等の指示があっても、/lyria 段階では何も合成できない。
ビジュアライザー周りの現行仕様は videoup SKILL.md の「オーディオビジュアライザー / オーバーレイについて」節を参照。必要な場合は /videoup 実行前に config/channel/youtube.json::overlays.enabled: true と overlay 詳細設定を用意する。
誤指示の事故防止のため、lyria 着手前に動画にオーバーレイが必要かをユーザーへ確認すること（#646 feedback）。
→ /videoup で動画生成を実行（WAV → MP4 変換は既存の generate_videos.sh を使用）