promo-reviewer

Promo Reviewer Skill

アルバムの promo/ ファイルにあるソーシャルメディア投稿文を、対話形式でレビューし、磨き上げます。各投稿を確認し、承認または修正して、仕上げた内容をファイルに書き戻します。

目的

プロモーション用テンプレートにプラットフォーム固有の投稿文を入力した後、このスキルを使ってリリース前に体系的なレビューを行います。各投稿について、文字数、ハッシュタグ数、プラットフォームの制限への準拠状況を表示します。ユーザーが操作（承認、修正、短縮、表現を強めるなど）を選択すると、仕上げた投稿文を書き戻します。

使用するタイミング

• /bitwize-music:promo-writer が初稿を生成した後
• promo/ テンプレートに入力した後（手動、またはリリース準備中）
• リリース前 — ソーシャルメディア投稿文の最終仕上げ
• ユーザーが「promo copy をレビューして」または「[album] の twitter 投稿を磨き上げて」と言った場合
• プロモーション用投稿文はあるものの、まだレビューされていない場合

ワークフロー内での位置付け

Promo Videos (optional) → [Promo Writer] (or manual) → **[Promo Review]** → Release

プロモーション用テンプレートへの入力後、release-director の前に実行します。

関連ファイル

• platform-rules.md — プラットフォームごとの文字数制限、ハッシュタグのルール、トーンのガイドライン

---

ワークフロー

1. アルバムの特定

引数からアルバムを特定します。

$ARGUMENTS で指定されたアルバム名を使って、MCP の find_album を使用します。アルバムが指定されていない場合は、get_session で直近のアルバムのコンテキストを確認します。

プロモーション用ディレクトリを特定します。

{content_root}/artists/{artist}/albums/{genre}/{album}/promo/

存在するプロモーション用ファイルと、内容が入力済みのファイルを確認します。

アルバムのディレクトリ内で promo/*.md を検索します。各ファイルについて、入力済みの内容があるか（テンプレートのプレースホルダーだけではないか）確認します。テンプレートのマーカー以外にテキストが含まれている場合、そのファイルは「入力済み」です。コードブロック内に [placeholder text] 以外の内容があるか確認します。

状況を報告します。

## Promo Copy Status

| Platform | File | Status |
|----------|------|--------|
| Campaign | campaign.md | Populated |
| Twitter/X | twitter.md | Populated |
| Instagram | instagram.md | Template only |
| TikTok | tiktok.md | Not found |
| Facebook | facebook.md | Populated |
| YouTube | youtube.md | Template only |

3 of 6 platforms have copy ready for review.

入力済みのプロモーション用ファイルがない場合：

No promo copy found to review.

Options:
1. Generate promo copy: /bitwize-music:promo-writer <album-name>
2. Populate promo templates manually (fill in promo/ files)
3. Skip promo review and proceed to release

2. プラットフォームの選択

引数にプラットフォームが指定されている場合は、そのプラットフォームだけをレビューします。

それ以外の場合は、次のように尋ねます。

Which platforms to review?

[A] All populated platforms (campaign, twitter, facebook)
[1] Campaign strategy
[2] Twitter/X posts
[3] Facebook posts

入力済みのプラットフォームだけを番号付きの選択肢として一覧表示します。

3. セクションの解析

選択された各プラットフォームのファイルについて：

1. Read ツールを使ってファイル全体を読み込みます
2. 見出しの境界で分割します — ## と ### の見出しでセクションを区切ります
3. コードブロックを抽出します — ``` フェンス内の内容が実際の投稿文です
4. レビュー対象のセクションを特定します — プレースホルダー以外のテキストを含むコードブロックがあるセクションを対象にします
5. 各投稿の指標を数えます：
   • 文字数（すべてのプラットフォームで、ハッシュタグも文字数に含めます）
   • ハッシュタグ数
   • 行数
   • プラットフォームの制限への準拠状況（platform-rules.md を参照）
6. スレッドを検出します — コードブロックに番号付きツイート（1/、2/、3/）が含まれている場合、個々のツイートに分割し、ツイートごとの文字数を表示してそれぞれをレビューします

4. 投稿ごとのレビューの流れ

レビュー対象の各セクションについて、投稿文とコンテキストを表示します。

## Twitter/X — Track 01: Track Title
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Track one tells the story of [concept].

Listen now: [link]

#NewMusic #HipHop

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Chars: 87/280 | Hashtags: 2 | Status: Within limits
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Actions:
  [A] Approve — keep as-is
  [R] Revise — give feedback for rewrite
  [S] Shorten — make more concise
  [P] Punch up — make more engaging/attention-grabbing
  [H] Add hashtags — suggest relevant hashtags
  [T] Rewrite tone — specify tone (casual, professional, hype, etc.)
  [K] Skip — move to next without changes

修正アクション（R、S、P、H、T）の後は、次の手順を実行します。

1. 修正版を生成します
2. 更新後の指標とともに表示します
3. 次の操作を提示します。

Revised version:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[revised copy here]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Chars: 142/280 | Hashtags: 3 | Status: Within limits
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [A] Approve this version
  [R] Revise again — more feedback
  [D] Discard — revert to original

5. Campaign.md の特別な扱い

Campaign ファイルにはコードブロック形式の投稿文ではなく、戦略の表やメッセージが含まれています。レビュー方法を次のように調整します。

• 各セクション（Overview、Key Messages、Schedule など）をレビュー単位として提示します
• 「表現を強める」を「[M] メッセージを強化する」に置き換えます — 戦略的な表現を簡潔にします
• 文字数制限は確認しません — キャンペーンドキュメントにはプラットフォームごとの制限がありません
• 重点項目：明瞭さ、アルバムのテーマとの一貫性、実行可能なスケジュール項目、メタデータ欄の入力漏れがないこと

6. 書き戻し

プラットフォームのすべてのセクションをレビューした後：

1. 承認済みまたは修正済みの内容を反映してファイルを再構成します
2. Edit ツールを使ってプロモーション用ファイルに変更を適用します
3. 書き込みを確認します。

Updated twitter.md — 4 posts revised, 2 approved as-is, 1 skipped

少なくとも1つのセクションを修正した場合のみ、内容を書き戻します。すべてのセクションがそのまま承認された場合、またはスキップされた場合は、書き込み手順を省略します。

7. 進捗の追跡

プラットフォーム間で、進捗の概要を随時表示します。

## Review Progress

| Platform | Approved | Revised | Skipped | Limit Issues |
|----------|----------|---------|---------|--------------|
| Twitter  | 4        | 2       | 1       | 0            |
| Facebook | —        | —       | —       | —            |

Next: Facebook (5 sections to review)
Continue? [Y/n]

8. セッションの概要

すべてのプラットフォームをレビューした後：

## Promo Review Complete

| Platform | Approved | Revised | Skipped |
|----------|----------|---------|---------|
| Campaign | 3        | 1       | 0       |
| Twitter  | 4        | 2       | 1       |
| Facebook | 3        | 2       | 0       |
| **Total** | **10** | **5** | **1** |

Char limit compliance: All posts within platform limits

Files updated:
  - promo/campaign.md (1 revision)
  - promo/twitter.md (2 revisions)
  - promo/facebook.md (2 revisions)

Next steps:
  1. Review any skipped posts if needed
  2. Add streaming links when available (replace [Streaming Link] placeholders)
  3. Ready for release: /bitwize-music:release-director <album>

---

修正のガイドライン

投稿文を修正する際は、次の原則に従います。

短縮（S）

• つなぎ言葉（「really」「very」「just」）を削ります
• 可能な場合は文をまとめます
• フックを優先し、最も魅力的な要素から始めます
• プラットフォームの制限を守ります（platform-rules.md を参照）

インパクトを強める（P）

• より力強い動詞と、生き生きとした表現を使います
• 緊急性や好奇心を高めます
• 説明ではなく、フックから始めます
• 核となるメッセージは維持し、より強く印象に残る表現にします

ハッシュタグを追加（H）

• ジャンル、アルバムのテーマ、プラットフォームの慣習に基づいて、関連性の高いハッシュタグを3～5個提案します
• 選択肢として提示し、どれを含めるかはユーザーに選んでもらいます
• プラットフォームごとのハッシュタグの慣習に従います（platform-rules.md を参照）
• プラットフォームの上限を超えないようにします

トーンを書き換える（T）

• 書き換える前に、希望するトーンをユーザーに尋ねます
• よく使われるトーン：カジュアル、プロフェッショナル、盛り上げる、ミステリアス、ストーリーテリング、緊急感のあるトーン
• 事実の内容を保ち、声や文体だけを変えます
• プラットフォームにふさわしいトーンにします

メッセージを強化する（M）— キャンペーンのみ

• 戦略的な表現を引き締めます
• 重要なメッセージを、より印象的で引用しやすいものにします
• スケジュールの項目を、具体的で実行可能なものにします
• メッセージとアルバムのテーマに一貫性があることを確認します

---

プラットフォーム別の確認ポイント

Twitter/X

• すべての投稿を280文字未満にします（厳守）
• スレッド内の各ツイートは、つながりを保ちつつ単独でも成立するようにします
• ハッシュタグは最大1～2個にします（多すぎるとスパムのように見えます）
• リリース告知の投稿にはストリーミングリンクを含めます

Instagram

• キャプションは長くても構いません（2,200文字）が、最初の125文字が「続きを読む」の前に表示されます
• 最初の行にフックを入れます。ユーザーの目に触れるのはそこだけです
• ハッシュタグは末尾に独立したブロックとして配置します
• 15～20個が最適です（上限は30個）

TikTok

• 画面をタップせずに読める150文字未満が理想です
• 上限は4,000文字ですが、短いほうが効果的です
• 3～5個のハッシュタグを使い、該当する場合はトレンドのものを選びます
• カジュアルで自然なトーンにします

Facebook

• 長めのストーリーテリングが効果的です
• 最初の2～3行が「続きを読む」の前に表示されます
• ハッシュタグは3～5個にします（ハッシュタグへの依存度が低いプラットフォームです）
• 行動を促す呼びかけを含めます

YouTube

• 説明欄ではタイムスタンプ、クレジット、リンクを使用できます
• 折りたたまれた表示では、最初の2～3行が表示されます
• ストリーミングリンク、ソーシャルリンク、クレジットを含めます
• ハッシュタグは3～5個にします（タイトルの上に表示されます）

---

確認事項

1. 実行開始時に platform-rules.md を読みます — 最新の制限を確認します
2. 投稿は一度に1つずつ提示します — まとめて確認しません
3. 投稿ごとに指標を表示します — 文字数、ハッシュタグ数、制限への準拠状況
4. 自動承認はしません — すべての投稿についてユーザーの確認を得ます
5. 変更したファイルだけを書き戻します — 修正のないファイルには手を加えません
6. 進捗を記録します — プラットフォーム間で累計数を示します
7. キャンペーンは別扱いです — ソーシャル投稿ではなく、戦略文書です
8. ユーザーの声を保ちます — 修正ではユーザーのスタイルを置き換えず、より引き立てます
9. 制限超過を明示します — プラットフォームの文字数制限を超える投稿を強調します
10. プレースホルダーを検出します — 実際の内容に置き換える必要がある [placeholder] が残っていないか確認します