/short
Use when collection 型（BGM テイスター）または release 型（楽曲リリース）のチャンネルでショートを生成するとき。「ショート作って」「shorts」「BGM 切り抜き」「リリースショート」「サビ抽出」「ショートサムネ」で発動。content_model.type から手順を自動判定し、--thumbnail で 9:16 素材を生成する
何ができるか
チャンネル設定から content model を自動判定し、縦型ショートを生成するスキルです。collection 型では公開済み長尺動画のテイスターを作ってローカライズ・投稿まで進め、release 型では楽曲のサビを切り出した日本語・英語クリップを作ります。利用者が型を選ぶ必要はなく、同じ /short から適切な手順へ分岐します。
| mode | すること | 主な成果物 |
|---|---|---|
| フラグなし | collection / release の型に合うショートを生成 | short-*.mp4 または short-{jp,en}.mp4 |
--thumbnail |
collection 型の 9:16 素材を生成 | 10-assets/short.png / short-loop.mp4 |
長尺動画から BGM テイスターを作りたいとき
/shortcollection 型では公開済み動画と確定素材から既定 3 本前後の縦型クリップを生成します。区間とクロップをプレビューで承認してから、対応言語の metadata を付けて YouTube へ投稿し、collection state に結果を記録します。API を使う前に投稿計画を確認したい場合は、内部の yt-upload-shorts --plan 手順で内容を確認できます。
楽曲リリースのサビを切り出したいとき
/shortrelease 型では JP / EN の 9:16 動画をローカルで生成します。サビの開始秒と尺は release 設定の値が初期値として提示され、生成前に区間を確認して都度指定できます。設定を書き換えなくてもその場で切り出し位置を変えられ、恒常的な既定値を変えたいときだけ release 設定を直します。プレビュー確認までがこの mode の責務で、現時点では YouTube への投稿は行いません。
ショート専用の縦素材を作りたいとき
/short --thumbnail--thumbnail は collection 型だけで使える一段実行です。9:16 の short.png を生成・承認し、必要なら縦型の short-loop.mp4 に動画化します。ループ生成は Veo が既定で、yt-generate-shorts-loop --engine fal による fal.ai も選択できます。content model を切り替えるフラグではないため、release 型で指定すると対象外として停止します。
つまずいたら
- 開始直後に設定エラーになる —
config/channel/shorts.jsonで shorts が有効か、content_model.typeがcollectionまたはreleaseかを確認してください - collection 型で素材が見つからない — 本編の公開とマスター動画・背景素材の確定が前提です。先に
/publish --uploadまたは不足している制作工程を完了してください --thumbnailが対象外になる — この mode は collection 型専用です。release 型のショートは本編映像から直接生成します- 生成に時間がかかる — ffmpeg 処理は通常 1〜3 分かかります。process の終了と成果物の存在を確認するまで再実行しないでください
リファレンス
発動フレーズ
- ショート作って
- shorts
- BGM 切り抜き
- リリースショート
- サビ抽出
- ショートサムネ
前後工程
前工程: /setup後工程:なし委譲先:なし
成果物
書き込む: collection 型はcollections/<id>/01-master/shorts/short-*.mp4とworkflow-state.json、release 型はreleases/<id>/video/short-{jp,en}.mp4、--thumbnailは10-assets/short.pngとshort-loop.mp4読み込む:config/channel/youtube.json,config/channel/shorts.jsonと対象 collection / release の映像・音声素材
想定 API call 数
| API | call 数 / 実行 | 変動要因 |
|---|---|---|
| videos.insert（1,600 units / 本） | collection 型の投稿本数 | shorts.collection.default_count。release 型は 0 |
| thumbnails.set（50 units / 本） | collection 型の投稿本数 | release 型は 0 |
| videos.update（50 units） | yt-shorts-bulk-update-loc の対象 Shorts 数 |
--dry-run は 0 |
| Vertex AI Gemini | --thumbnail の short.png 生成で 1 call |
再生成回数 |
| Vertex AI Veo 3.1 / fal.ai | --thumbnail のループ動画化で選択 engine に 1 call |
ループ不要なら 0 |
- 上限 / 承認: collection 型は
--planと--short-numで小出しに確認できる。--thumbnailの画像・動画生成は各 1 call ごとに承認する。release 型はローカル ffmpeg 生成だけで、投稿 API は呼ばない。
前提
config/channel/がロード可能config.shorts.enabled == true- 型別 reference に記載した対象素材が存在する
いずれか欠ける場合は早期に止めて該当 skill / config 更新を案内する（/setup --import / /setup / /publish --upload）。