email-review

メールレビューサブスキル

目的

送信前にメールの内容をレビューし、重み付けされた5つの評価項目で総合的な品質スコア（0～100）を提示します。重大な問題を特定し、改善案を提案します。また、スコアの低いメールについては書き直したバージョンを提示します。

有効化するタイミング

• ユーザーが「このメールをレビューして」と依頼した場合
• ユーザーがフィードバックを求めてメールの内容（件名＋本文）を提示した場合
• ユーザーがメールの品質チェックやスコアを求めた場合
• ユーザーが送信前にメールを確認したい場合
• ユーザーがレビュー用に Gmail の下書き ID を提示した場合
• ユーザーがメールの到達率やスパムのリスクについて尋ねた場合

入力形式

以下のいずれかの形式でメールの内容を受け付けます。

1. 貼り付けたテキスト - 会話内の件名と本文
2. ファイルパス - HTML メールファイルへのパス
3. Gmail の下書き ID - gmail_get_draft MCP ツールで取得
4. 生の HTML - HTML メールのソースコード

評価フレームワーク

総合スコアの計算方法

総合スコア ＝ 5つのカテゴリの加重合計：

カテゴリ	重み	評価の観点
件名	25%	長さ、効果的な語句、スパムを招く要素、パーソナライズ
コピーの品質	25%	語数、CTA の明確さ、フレームワークの構成、読みやすさ
技術面／HTML	20%	サイズ、レスポンシブ対応、ダークモード、代替テキスト、プリヘッダー
到達率	15%	スパムの兆候、リンク数、送信者の評判に関わる要素
コンプライアンス	15%	CAN-SPAM、配信停止、住所、RFC 8058

---

1. 件名の評価（重み：25%）

基本スコア：0～100。その後、重み25%で加重します

長さの確認（0～25点）

• 最適：6～10語、または30～50文字 ＝ 25点
• 許容範囲：5語または11語 ＝ 20点
• やや不適切：4語または12語 ＝ 10点
• 不適切：4語未満または12語超 ＝ 0点

スパムを招く要素の検出（該当するごとに-5点）

以下が含まれる場合、減点します。

• すべて大文字の単語
• 感嘆符の多用（!!!）
• 次のフレーズ："FREE"、"Act Now"、"Limited Time"、"Guaranteed"、"Winner"、"Click Here"、"Buy Now"、"Order Now"
• 過剰な句読点（$$$、???）

効果的な語句（1語につき+5点、最大+15点）

以下を戦略的に使用している場合、加点します。

• "New"、"Exclusive"、"Proven"、"Secret"、"Discover"
• "Ultimate"、"Essential"、"Complete"、"Breakthrough"
• 業界に特化した効果的な語句

パーソナライズ（+10点）

• {{first_name}} や {{company}} などの差し込みタグを含む
• 行動に基づくパーソナライズの兆候がある

絵文字の使用（+5点または-5点）

• 絵文字1つ ＝ +5点（開封率が上がります）
• 絵文字2つ以上 ＝ -5点（プロフェッショナルな印象が損なわれます）
• 絵文字なし ＝ 0点（中立）

---

2. コピーの品質評価（重み：25%）

基本スコア：0～100。その後、重み25%で加重します

語数（0～20点）

• 150～300語 ＝ 20点（最適）
• 100～149語、または301～400語 ＝ 15点
• 50～99語、または401～500語 ＝ 10点
• 50語未満または500語超 ＝ 0点

CTA の数（0～25点）

• 主要な CTA が1つ ＝ 25点（最もコンバージョンにつながりやすい）
• CTA が2つ ＝ 15点（許容範囲）
• CTA が3つ以上 ＝ 5点（焦点がぼやけます）
• CTA が0個 ＝ 0点（次の行動につながりません）

CTA の明確さ（0～15点）

以下に基づいて評価します。

• 15点：行動を表す動詞＋メリット（"Get My Free Guide"、"Start Your Trial"）
• 10点：一般的な行動（"Learn More"、"Download"）
• 5点：曖昧な表現（"Submit"、"Click Here"）
• 0点：CTA がない、または不明確

フレームワークの構成（0～15点）

メールが実証済みのフレームワークに沿っているかを確認します。

• PAS（Problem-Agitate-Solution）：15点
• AIDA（Attention-Interest-Desire-Action）：15点
• BAB（Before-After-Bridge）：15点
• FAB（Features-Advantages-Benefits）：15点
• 4Ps（Picture-Promise-Proof-Push）：15点
• 明確な構成がない：0点

読みやすさ（0～15点）

• 短い段落（最大2～3行）：+5点
• 箇条書きまたは番号付きリスト：+5点
• 小見出しがあり、ざっと目を通しやすい：+5点
• 文字が詰まった長い段落がない：+5点
• 読みやすさに問題があるごとに-5点

名前以外のパーソナライズ（0～10点）

• 行動に基づくトリガー（過去の購入、閲覧履歴）：+5点
• 場所／タイムゾーンへの配慮：+3点
• 業界／役割に合わせた内容：+2点

---

3. 技術／HTML スコア（重み 20%）

基本スコア：100 点。違反があれば減点します

合計サイズ（違反した場合は -20 点）

• 102 KB 未満であること（Gmail ではこれを超えるメールが途中で切り詰められます）
• HTML と埋め込み画像（データ URI の場合）を確認します

テキストと画像の比率（違反した場合は -15 点）

• テキスト 60% 以上、画像 40% 以下
• 画像が多いメールは迷惑メールフィルターに引っかかります

レスポンシブデザイン（違反した場合は -10 点）

次の項目を確認します。

• ビューポートの meta タグ：<meta name="viewport" content="width=device-width">
• モバイル向けブレークポイントのメディアクエリー
• 可変幅のテーブルまたはコンテナー幅

ダークモード対応（違反した場合は -5 点）

次の項目を確認します。

• <meta name="color-scheme" content="light dark">
• @media (prefers-color-scheme: dark) を含む CSS
• ダークモード用の色の上書き

画像の代替テキスト（欠落 1 件につき -5 点）

• すべての <img> タグに alt 属性が必要です
• 代替テキストはファイル名だけでなく、内容を説明するものにします

テーブルベースのレイアウト（違反した場合は -5 点）

• メールのレイアウトには <table> を使用する必要があります（HTML メールのベストプラクティス）
• CSS Grid／Flexbox を使用している場合は減点します（メールクライアントの対応が不十分です）

フォントの安全性（違反した場合は -5 点）

• フォールバックを含むウェブセーフフォントを使用する必要があります
• 例：font-family: Arial, Helvetica, sans-serif;
• フォールバックなしでカスタム Web フォントを使用するのは避けてください

CTA ボタンのサイズ（違反した場合は -5 点）

• 最小 44x44 ピクセル（モバイルでのタップ対象サイズ）
• ボタンとしてスタイル設定されたすべての <a> を確認します

プレーンテキスト版（違反した場合は -10 点）

• プレーンテキストの MIME パート、または
• HTML 内のテキストのみのフォールバックが必要です

プリヘッダーテキスト（欠落している場合は -5 点）

• 30～80 文字のプレビューテキスト
• <body> タグの直後に配置します
• HTML 表示時に CSS で非表示にすることがよくあります

---

4. 配信可能性のシグナル（重み 15%）

基本スコア：100 点。危険な兆候があれば減点します

迷惑メール判定語の密度（1 語につき -5 点）

本文中の迷惑メール判定語の出現回数を数えます。

• 「Free」、「Winner」、「Guarantee」、「Risk-free」、「Act now」
• 「Cash」、「Bonus」、「Extra income」、「Work from home」
• 「Unsecured credit」、「Viagra」、「Pharmacy」

リンク数（5 件以上で警告）

• 0～3 件＝減点なし
• 4～5 件＝-5 点（警告のしきい値）
• 6 件以上＝-15 点（迷惑メールのシグナル）

画像のみのメール（違反した場合は -20 点）

• 画像のみでテキストがないメールは迷惑メールのシグナルです
• 内容のあるテキストを含める必要があります

配信停止リンク（欠落している場合は -25 点）

• マーケティングメールには必須です
• はっきり見える場所にあり、機能する必要があります
• 「unsubscribe」というキーワードを含む <a> を確認します

送信者名（一般的すぎる場合は -10 点）

• 次の形式の場合は減点します：「info@」、「noreply@」、「admin@」、「support@」
• 個人名または会社名が望ましいです

リンク短縮サービス（検出された場合は -10 点）

• 次のサービスの使用を減点対象とします：bit.ly、tinyurl、goo.gl、ow.ly
• 迷惑メールフィルターは短縮 URL を信頼しません

---

5. コンプライアンススコア（重み 15%）

基本スコア：100 点。違反があれば減点します

住所（記載がない場合は -20 点）

• CAN-SPAM では郵送先住所の記載が必須です
• フッターに番地を含む住所または私書箱があるか確認します

配信停止の手段（記載がない場合は -25 点）

• 機能する配信停止リンクが必要です
• 10 営業日以内に処理する必要があります（CAN-SPAM）

正確な件名（誤解を招く場合は -15 点）

• 件名はメールの内容を正確に反映する必要があります
• 返信ではない場合、誤解を招く「Re:」や「Fwd:」は使用しないでください

RFC 8058 ヘッダー（一括配信の場合、欠落していると -10 点）

一括配信／マーケティングメールの場合は、次を確認します。

List-Unsubscribe: <mailto:[email protected]>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

送信者の明示（記載がない場合は -10 点）

• メールの送信者を明確に示す必要があります
• 「From」の名前とフッターの会社情報を確認します

---

スコアの解釈

スコア	評価	状態	推奨事項
90-100	優秀	✅ 送信可能	必要に応じて細部を調整します
75-89	良好	⚠️ 確認を推奨	優先度が中程度の問題に対処します
60-74	普通	⚠️ 送信前に修正	優先度の高い問題を解決します
40-59	不良	❌ 要修正	大幅な変更が必要です
0-39	重大	❌ 送信禁止	コンプライアンス／配信可能性に関する重大な問題があります

---

出力形式

レビュー報告書は次の構成にしてください。

1. ヘッダー：## Email Quality Review、総合スコア、評価、ステータス
2. スコア表：5つのカテゴリーについて、素点、重み、加重スコアを記載
3. 検出された問題：重大度（Critical／High／Medium／Low）別に分類し、具体的な修正方法を記載
4. 詳細分析：カテゴリーごとの分析（件名の長さ／トリガー語／パワーワード、単語数／CTA／フレームワーク、HTML サイズ／レスポンシブ対応／ダークモード、スパムワード／リンク、住所／配信停止／RFC 8058）
5. 改善版（スコアが 75 未満の場合）：書き直した件名、コピーの修正案、HTML の修正

ステータスバッジを使用してください：✅ 送信可能（90 以上）、⚠️ レビューを推奨（75～89）、⚠️ 送信前に修正（60～74）、❌ 大幅な修正が必要（40～59）、❌ 送信禁止（0～39）。

---

ワークフロー

ステップ 1：入力の確認

入力形式を特定し、以下を抽出します。

• 件名
• 本文（テキストまたは HTML）
• HTML ソース（該当する場合）

ステップ 2：分析スクリプトの実行（利用可能な場合）

以下を確認して実行します。

# Subject line scoring
python scripts/score_subject_line.py --subject "[subject]"

# HTML email analysis
python scripts/analyze_email_html.py --file [path]

ステップ 3：手動での採点

各カテゴリーについて、以下を行います。

1. 基本スコアを設定する
2. 加点を適用する
3. 減点を適用する
4. 加重スコアを計算する

ステップ 4：参照資料の確認

例外的なケースについて、ナレッジファイルを参照します。

• references/technical-standards.md - HTML／CSS のメール規則
• references/compliance.md - CAN-SPAM、GDPR、CASL の要件
• references/deliverability-rules.md - 到達性の採点基準とスパム判定の参考情報

ステップ 5：報告書の作成

上記のテンプレートに従って出力し、以下を満たすようにします。

• 問題を重大度別に明確に分類する
• 実行可能な修正案を提示する
• スコアが 75 未満の場合は改善版を提示する

ステップ 6：ユーザーへの確認

以下のどれを希望するか、ユーザーに尋ねます。

• 提案した改善を適用する
• 手動で編集した後に再レビューする
• このまま送信する（スコアが 75 以上の場合）

---

品質ゲート

必須ルール（自動失格）

以下の問題がある場合、総合スコアにかかわらずステータスは「送信禁止」になります。

1. 配信停止リンクがない（マーケティングメールの場合）
2. 物理的な住所が記載されていない（CAN-SPAM 違反）
3. メールサイズが 102 KB を超えている（Gmail で省略表示されます）
4. 画像のみのメール（テキストコンテンツがない）
5. 誤解を招く件名（FTC 違反）

---

例外的なケース

Gmail の下書き

ユーザーから下書き ID が提供された場合：

1. gmail_get_draft MCP ツールを使用して取得する
2. payload.headers から件名を抽出する
3. payload.parts から HTML 本文を抽出する（mimeType = text/html）
4. 通常のレビューに進む

プレーンテキストメール

メールに HTML が含まれていない場合：

1. 技術／HTML の採点を省略する（既定値は 80/100）
2. コピーの品質、件名、コンプライアンスを重視する
3. 重み付けを調整する：件名 30%、コピー 35%、到達性 20%、コンプライアンス 15%

英語以外のメール

1. 報告書に言語を記載する
2. スパムワードの検出を省略する（英語に特化しているため）
3. 構造上および技術上の問題に重点を置く
4. 可読性スコアに関する注意事項を記載する

トランザクションメール

メールがトランザクションメール（領収書、確認通知など）の場合：

1. コンプライアンス規則を緩和する（配信停止は不要）
2. 技術的な配信と明確さを重視する
3. 報告書に「トランザクションメール — マーケティング関連の規則を緩和」と記載する

---

ツール連携

利用可能なスクリプト

/scripts/ ディレクトリから次のスクリプトを実行します。

score_subject_line.py

• 入力：python scripts/score_subject_line.py --subject "Subject line text" --json
• 出力：長さ、スパムトリガー語、パワーワード、スコアを含む JSON
• 用途：件名の要素を自動採点する

analyze_email_html.py

• 入力：python scripts/analyze_email_html.py --file path/to/email.html --json
• 出力：サイズ、レスポンシブ対応、代替テキスト、プリヘッダー、問題を含む JSON
• 用途：技術／HTML の要素を自動採点する

MCP ツール

gmail_get_draft

• Gmail から ID で下書きメールを取得する
• 件名と HTML 本文を抽出する

gmail_send_message

• レビュー済みメールを送信する（ユーザーの承認後）

例

高スコアのメール（92/100）：件名「新しいガイド：2026年に効果が実証されたSEO戦術5選」――8語、訴求力のある単語を使用し、スパム判定につながる要素はなく、280語、CTAは1つ、レスポンシブHTMLで、コンプライアンスに必要な要素もすべて揃っています。ステータス：送信準備完了。

低スコアのメール（23/100）：件名「無料でお金が手に入る！！！今すぐ行動を！！！当選確実！！！ 」――すべて大文字で、スパム判定につながる要素が4つ、50語、CTAは5つ、配信停止リンクと住所がありません。ステータス：送信禁止（CAN-SPAM違反）。

---

注意事項

• 手動で採点する前に、利用可能なスクリプトを必ず実行してください
• 判断が難しいケースについては、ナレッジファイルを参照してください
• 具体的で実行可能な改善案を提示してください
• コンプライアンス違反のあるメールは、決して承認しないでください
• ユーザーの業界における文脈（B2B、B2C、トランザクションメール）を考慮してください
• ベストプラクティスの変化に応じて、採点基準を更新してください