| name | video |
| purpose | 作る |
| description | Use when 音源と画像からマスター動画と YouTube 概要欄を作るとき。フラグなしは generate→describe を状態判定付きで進め、一段だけは排他的な --generate / --describe を使う。YouTube へのアップロードは公開系 skill の責務 |
前後工程
前工程: /wf-new, /music --master, /music --generate, /thumbnail --loop後工程: /publish --upload, /audit --metadata委譲先: なし
成果物
書き込む: collections/<id>/01-master/*.mp4, collections/<id>/20-documentation/descriptions.json, collections/<id>/20-documentation/descriptions.html, collections/<id>/workflow-state.json読み込む: collections/<id>/01-master/<master-audio>, collections/<id>/10-assets/main.png, collections/<id>/10-assets/main.jpg, collections/<id>/10-assets/loop.mp4, 検証済み collections/<id>/20-documentation/suno-prompts.json, data/benchmark_*.json, 検証済み docs/benchmarks/benchmark-report.json, config/channel/*.json, config/skills/video.yaml
モード判定
$ARGUMENTS から --generate と --describe の指定個数を最初に数える。
- 2 個以上なら排他違反として停止し、1 つだけ指定するよう促す
- 1 個なら対応する reference を読み、その一段だけを実行する。残りの引数はその mode の引数として扱う
- 0 個なら chain manifest に従い状態判定付きで進める
| mode | 読む reference |
|---|
--generate | references/generate.md |
--describe | references/describe.md |
設定読み込みゲート
skill-config は次を deep-merge する。
.claude/skills/video/config.default.yamlconfig/skills/video.yaml（存在する場合）
合成規則は load_skill_config("video") と同じで、チャンネル上書きを優先する。生成 mode は generate:、概要欄 mode は describe: 節を使う。存在しない override は未設定として扱い、勝手に作成しない。互換 loader key load_skill_config("videoup") / load_skill_config("video-description") はそれぞれ同じ default の generate: / describe: 節を返す。旧 config/skills/videoup.yaml または config/skills/video-description.yaml が残っている場合は、yt-skills migrate-config --channel-dir <channel-dir> で video.yaml の対応節へ移行してから実行する。
一括実行
references/video-chain-manifest.json と references/video-chain-state.py の存在と、manifest の chainId、step、mode、approval gate、状態判定 script を検証する。欠損、未知・重複 step、複数 mode、approvalGate.skip != true があれば停止する。
manifest 順に各 step を対象 collection で実行する。
uv run python .claude/skills/video/references/video-chain-state.py \
--collection-dir <collection-path> --step <generate|describe>
| exit | decision | 処理 |
|---|
| 0 | skip | 完了済みとして終了する |
| 10 | run | step に対応する references/generate.md / references/describe.md を読み、成果物を生成する |
| 20 | blocked | reason と不正な state を提示して停止する |
| その他 | error | state / manifest / script のエラーとして停止する |
実行後は同じ状態判定を再実行し、exit 0 にならなければ停止する。次 step は直前 step が exit 0 の場合だけ開始する。途中失敗時は成果物を完了扱いせず、再発動時に同じ判定から再開する。
完了条件
- フラグなし: generate → describe の両方が
skip または実行後 skip になっている
--generate: references/generate.md の完了条件を満たし、他 mode を実行していない--describe: references/describe.md の完了条件を満たし、他 mode を実行していない
実行段、skip 段、生成した master video / descriptions.json + descriptions.html pair のパスを短く報告する。
