| name | audit |
| purpose | 振り返る |
| description | Use when 整合性・動画本体・公開後メタデータ・価値ループの監査を一括実行または一段だけ実行するとき。フラグなしは4監査を状態判定付きで進め、音楽ムード × サムネ × タイトルは --alignment、動画解析は --video、ローカルと YouTube のメタデータ整合は --metadata、価値ループは --value-loop を使う。「監査一括実行」「整合性チェック」「価値ループ監査」「動画解析」「メタデータ監査」で発動 |
前後工程
前工程: /channel-strategy --constraints, /thumbnail, /music, /publish --upload, /publish後工程: /wf-new, /music --prompt, /audit --alignment, /analytics --flop, /video --describe委譲先: なし
成果物
書き込む: docs/plans/alignment-audit.{json,html}, data/video_analysis/<channel>/<video-id>.json, reports/video_analysis/<channel>.{json,html}読み込む: collections/<id>/10-assets/thumbnail.jpg, 検証済み collections/<id>/20-documentation/suno-prompts.json または lyria-prompt.json, 検証済み collections/<id>/20-documentation/descriptions.json + 同 basename HTML, collections/<id>/20-documentation/upload_tracking.json, collections/<id>/workflow-state.json, data/benchmark_*.json, 検証済み docs/channel/personas/persona-definition.json, docs/plans/viewing-scene-matrix.json, docs/channel/creative-constraints.json, reports/analysis_*.json, data/insights.jsonl, config/channel/*.json, config/skills/audit.yaml
想定 API call 数
| API | call 数 / 実行 | 変動要因 |
|---|
Vertex AI Gemini（--video の yt-video-analyze） | 未解析の対象動画数 × 1 call | --source / --top / 対象動画数 / --force / analysis_window_sec |
YouTube Data API v3 videos.list（--metadata） | remote 監査で 1 call = 1 unit | --local 指定時は 0。--alignment と --value-loop は外部 API を呼ばない |
- 上限 / 承認: 確認プロンプトは挟まない。
--video の --source と --top で対象数を絞り、既存の有効な解析結果は再利用する。
設定読み込みゲート
video / metadata mode は次を deep-merge し、チャンネル上書きを優先する。
.claude/skills/audit/config.default.yaml の mode 名の節config/skills/audit.yaml の同名節（存在する場合）
実行経路は load_skill_config("audit.video") / load_skill_config("audit.metadata") を使う。移行前の config/skills/video-analyze.yaml / config/skills/metadata-audit.yaml は互換入口 load_skill_config("video-analyze") / load_skill_config("metadata-audit") として同じ設定に読み込むが、存在しない override を勝手に作成しない。
モード判定
$ARGUMENTS から、下表に登録された mode flag の個数を最初に数える。同じ flag の重複も別々に数える。
- 2 個以上なら排他違反として停止し、1 つだけ指定するよう促す
- 1 個なら対応する reference を読み、その一段だけを実行する。残りの引数はその mode の引数として扱う
- 0 個なら chain manifest に従い alignment → video → metadata → value-loop を状態判定付きで進める
- 現段で実装済みの mode は
--alignment / --value-loop / --video / --metadata
- mode は最大 5 件とし、判定規則を複製しない
| mode | 読む reference |
|---|
--alignment | references/alignment.md |
--value-loop | references/value-loop.md |
--video | references/video.md |
--metadata | references/metadata.md |
一括実行
references/audit-chain-manifest.json と references/audit-chain-state.py が存在し、manifest の chainId、step 順、step mode、approval gate、状態判定 script が妥当であることを確認する。欠損、未知・重複 step、複数 mode、approvalGate.skip != true があれば停止する。全 mode は読み取り専用監査またはローカル監査レポート生成だけを行うため、chain の承認ゲートを省略する。
チャンネルルートで manifest 順に次を実行する。
uv run python .claude/skills/audit/references/audit-chain-state.py \
--channel-dir . --step <alignment|video|metadata|value-loop>
| exit | decision | 処理 |
|---|
| 0 | skip | 完了済みとして次段へ進む |
| 10 | run | step の mode reference を読み、その一段を実行する |
| 20 | blocked | reason と不足成果物を提示して停止する |
| その他 | error | manifest / script / 入力 JSON のエラーとして停止する |
実行後は同じ状態判定を再実行する。alignment / video が exit 0 にならなければ停止する。metadata / value-loop は診断結果を永続化しないため、実行後も exit 10 が正常である。metadata の表示結果は同じ会話内で value-loop の横断診断へ渡す。途中失敗時はその段で止め、再発動時は先頭から状態判定して完了済み段を skip する。
完了条件
- フラグなし: alignment と video が
skip または実行後 skip、metadata と value-loop が run となり、4 mode の監査結果を表示している
--alignment: references/alignment.md の完了条件を満たしている--value-loop: references/value-loop.md の完了条件を満たしている--video: references/video.md の完了条件を満たしている--metadata: references/metadata.md の完了条件を満たし、自身では修正していない- 未知の mode または排他違反では、reference を読まず停止している
実行 mode、監査対象、判定結果、保存したレポート（ある場合）を短く報告する。
