short-release

name: short-release description: "Use when release 型チャンネル（話す系・楽曲リリース）でショート動画を生成・投稿したいとき。${motif}-{jp,en}.mp4 から JP+EN 各 1 本ずつ 9:16 縦型クリップを生成・投稿。「リリースショート」「楽曲ショート」「JP/EN クリップショート」「サビ抽出」「short-release」など、release 型チャンネルのショート制作に関わる場面で必ず使用すること。BGM テイスター（collection 型）チャンネルは /short を使う"

Overview

config.youtube.content_model.type == "release" のチャンネル向けに、本編リリース動画 （${motif}-{jp,en}.mp4）から JP・EN の 2 言語ぶん 9:16 縦型ショートを生成・投稿する。 楽曲のサビ部分を抜き出して縦型クロップ + スケール変換し、#Shorts タグ付きで投稿する。

前提

• config/channel/ がロード可能（load_config()）
• config.shorts.enabled == true（config/channel/shorts.json）
• config.youtube.content_model.type == "release"
• 本編動画が YouTube にアップ済みで upload_tracking.json に JP / EN それぞれの video_url が記録されている
• リリースディレクトリに video/${motif}-jp.mp4 と video/${motif}-en.mp4 が存在する（motif は release ディレクトリ名から先頭の <番号>- を除去したもの）

Quick Reference

Instructions

Step 1: 前提チェック

from youtube_automation.utils.config import load_config
cfg = load_config()
assert cfg.shorts.enabled, "config/channel/shorts.json で shorts.enabled=true にしてください"
assert cfg.youtube.content_model.type == "release", "collection 型は /short を使ってください"

失敗時は対応 skill を案内して終了。

Step 2: 素材確認

ls <release-path>/video/    # ${motif}-{jp,en}.mp4 が必要

JP / EN の片方しか無い場合は cfg.shorts.release.languages で投稿対象を絞れる。両方無ければ録音・編集前提のため早期終了。

Step 3: サビ位置決定（AskUserQuestion）

config.shorts.release.start_sec / duration_sec を初期値として提示し、AskUserQuestion でサビ位置を確認:

• そのまま使う / 別の秒数を指定する
• 「楽曲ファイルを再生して指示する」場合は ffplay <release-path>/video/${motif}-jp.mp4 -ss 30 で先頭 30s から再生

Step 4: 縦型変換

bash .claude/skills/short-release/references/generate-shorts.sh <release-path> -s 30 -t 40

出力: <release-path>/video/short-{jp,en}.mp4。中央クロップ（crop=ih*9/16:ih）→ 1080x1920 へスケール → fps=30。

Step 5: プレビュー → アップロード

open <release-path>/video/short-{jp,en}.mp4
uv run yt-upload-shorts <release-path> --dry-run    # メタデータ確認
uv run yt-upload-shorts <release-path>              # 実投稿

ShortUploader が自動で行うこと:

• 本編 JP / EN それぞれの publish_at 基準で cfg.shorts.publish_time 翌日公開時刻を計算
• 各言語のメタデータ生成（タイトル / 説明欄 / #Shorts タグ）
• workflow-state.json::post_upload.short.{jp,en} に記録

Step 6: workflow-state.json 更新

"post_upload": {
  "short": {
    "jp": { "generated": true, "uploaded": true, "video_id": "xxx", "publish_at": "..." },
    "en": { "generated": true, "uploaded": true, "video_id": "yyy", "publish_at": "..." }
  }
}

設定

ショート動画仕様

Gotchas

• motif 名の取り出し: motif=$(basename <release-path> | sed 's/^[0-9]*-//')。番号プレフィックスを必ず除去すること
• JP/EN 片方欠落: ${motif}-jp.mp4 か ${motif}-en.mp4 の片方しか無い場合は skip。両方欠落で early-exit
• fps=30 必須: 元動画が低 fps の場合は fps=30 フィルタなしで生成すると YouTube がショート認識しない（generate-shorts.sh が常時付与）
• サビ位置のテスト: 実機で open <release-path>/video/short-jp.mp4 確認前にアップロードしないこと。冒頭が無音だと最後まで再生されない

長時間処理の取り扱い

generate-shorts.sh は JP / EN 各 1 本の縦型変換を ffmpeg で走らせるため 1〜2 分 程度かかる。必ず Bash ツールを run_in_background=true で起動する。これによりユーザーは処理中も同じセッションで質問できる（Claude Code は完了時に自動でメッセージ通知するため、sleep ループや until での自前ポーリングは禁止）。

spawn 例:

bash .claude/skills/short-release/references/generate-shorts.sh <release-path> -s 30 -t 40 \
  > /tmp/short-release-$(date +%s).log 2>&1

これを Bash run_in_background=true で投げ、spawn 直後に次のメッセージを返す:

⏳ JP/EN 縦型クリップを background 生成中（推定 1〜2 分）。完了まで他の質問にもお答えできます。 ログ: /tmp/short-release-*.log

cmux 環境下（$CMUX_WORKSPACE_ID あり）であれば補助で cmux set-status "short-release" "running" --icon "hourglass" --color "#f59e0b"、完了で cmux clear-status "short-release" + cmux notify --title "short-release 完了" を呼ぶ（非 cmux 環境では skip）。

完了通知が届いたらログ末尾から結果サマリー（short-jp.mp4 / short-en.mp4 のパス）をユーザーへ返す。失敗時は ffmpeg のエラー行を抜き出して報告する。

Next Step

• collection 型ショートも作る別チャンネルでは /short を使う
• 全本数完了後の進捗確認: /wf-status