name: alignment-check description: "Use when 各コレクションの音楽ムード × サムネイル雰囲気 × タイトル訴求の整合性を監査したいとき。「整合性チェック」「一致してるか確認」「タイトル見直し」「サムネと音楽の一致」「タイトル改善」「CTR改善」など。CTR に最も影響するチェックポイント。方向性見直し時に必ず使用すること"
Overview
公開済み全コレクションの音楽プロンプト・サムネイル・タイトルを横断的に監査し、 不一致箇所を特定。タイトルフォーマットの改定案も提示する。
前提
config/channel/ が存在すること(load_config() でロード可能)。
存在しない場合、ユーザーに確認:
- 新規チャンネル →
/channel-newを案内 - 既存チャンネル(YouTube で既に運営中)→
/channel-importを案内
実行フロー
Phase 1: 全コレクション棚卸し(サブエージェント並列)
2つのサブエージェントを並列起動(Agent ツール):
Agent 1: コレクション × サムネ × 音楽プロンプト収集
collections/live/の全コレクションを列挙- 各コレクションから以下を読み込み:
workflow-state.json— タイトル、テーマ、活動タグ。planning.music(mood / atmosphere / tempo / instruments)があれば優先採用20-documentation/suno-prompts.mdorlyria-prompt.md— 音楽ムード・楽器・テンポの補助資料
- コレクションごとの [タイトル / 音楽ムード / テーマ] を一覧表にまとめる
Agent 2: ベンチマークタイトル構造分析
data/benchmark_YYYYMMDD.json(最新)を読み込み- 全ベンチマーク動画のタイトル構造をパターン分類
- 各パターンの平均再生数を算出
- 現行テンプレート(
config/channel/content.jsonのtitle.template)との比較
Phase 2: サムネイル視覚確認
Agent 1 の結果から、全コレクションのサムネイルを Read ツールで順に表示:
collections/live/*/10-assets/thumbnail.jpg- 各サムネイルについて以下を評価:
- 明るさ(◎/○/△/✗)
- キャラサイズ(大/中/小)
- キャラの活動(具体的か)
- 楽器の有無
- 音楽ムードとの整合性
Phase 3: 整合性マトリクス作成
Phase 1-2 の結果を統合し、各コレクションの整合性を判定:
| 動画 | 音楽ムード | サムネ雰囲気 | タイトル訴求 | 整合性 |
不一致箇所には ⚠️ を付け、具体的な改善提案を付記。
Phase 4: タイトルフォーマット改定
現行 vs ベンチマーク比較に基づき、新タイトルフォーマット案を提示。 既存動画のタイトル変更候補も提案(YouTube Studio で手動変更可能)。
タイトルの語彙チェック:
- 一般視聴者に分かる語彙か(Scriptorium, Bower, Vigil 等の難語を検出)
- YouTube 検索バーに打ち込む言葉か
Phase 5: 意思決定 + レポート保存
AskUserQuestion で新タイトルフォーマットを確認。
docs/plans/alignment-audit.md を生成。
必要に応じて config/channel/content.json のタイトルテンプレートを更新。
障害時ガイダンス
整合性監査はローカルの成果物を読むだけで、外部サービスを呼ばない。
| 状況 | 兆候 | 対処 |
|---|---|---|
| 入力データ/設定の不在 | 参照先のローカルファイルが見つからない | 該当ファイルを用意するか前段スキルを先に実行(外部サービスに依存しないため API 障害・quota の影響は受けない) |
関連ファイル
config/channel/content.json—title.template,title.theme_activitiesdocs/benchmarks/common-patterns.md— 5つの成功法則collections/live/*/10-assets/thumbnail.jpg— サムネイルcollections/live/*/20-documentation/— 音楽プロンプトcollections/live/*/workflow-state.json— タイトル・テーマdata/video_analysis/<slug>/<video_id>.json—/video-analyzeのthumbnail_alignment出力(サムネ vs 本編の整合性監査の根拠)
Next Step
docs/plans/alignment-audit.md 保存後、不整合カテゴリに応じて以下のスキルを再実行する:
| 不整合カテゴリ | 症状 | 再実行スキル |
|---|---|---|
| サムネ不一致 | 音楽ムードとサムネ雰囲気がズレ(例: lofi なのに派手な色調) | /thumbnail <collection> — 対象コレクションのサムネイル再生成 |
| 音楽ミスマッチ | テーマ・タイトルと音楽プロンプトがズレ(例: 「rain」テーマなのに upbeat) | /collection-ideate で企画段階から見直し、その後 /suno または /lyria で再生成 |
| タイトル改善のみ | サムネ・音楽は OK だがタイトルの訴求/語彙が弱い | YouTube Studio で手動変更 + config/channel/content.json の title.template を更新 |
| 横断的な方向性ズレ | 複数コレクションで同じ不整合パターン | /channel-direction でチャンネル全体の方向性を再検討 |
再実行後は /alignment-check を再度走らせて解消を確認する(フィードバックループ)。