mcpField
E
email-quality-auditor

email-quality-auditor

github.com/aaron-he-zhuマーケティング・グロース3.0k1.0k 回インストール今日更新
リポジトリ

email-quality-auditor について

email-quality-auditorは、SENDを用いてメールプログラムやプロファイルを評価するスキルです。安全性、エンゲージメント、成果の証拠を採点し、拒否条件や不足情報を報告します。メール送信やプロバイダー設定の変更は行いません。

主な機能

  1. 0120項目にわたるSEND評価
  2. 02認証・同意・配信抑制の確認
  3. 03開封率データの限界を明記
  4. 04成果の真実集合との照合
  5. 05型付きスコア・判定・証拠レポート

活用シーン

  1. 01重要な配信前のキャンペーン確認
  2. 02SENDベースラインの作成や再評価
  3. 03同意・抑制・訴求内容のリスク調査
  4. 04プログラムデータ不足時の証拠ギャップ報告

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aaron-he-zhu/aaron-marketing-skills --skill email-quality-auditor

インストール後、Claude Code で/email-quality-auditorを入力して読み込まれたか確認します。

同梱ファイルreferences/auditor-runtime.md

詳細

メール品質監査

SEND を使って、1 つのメールプログラム/プロファイルと観測期間を監査します。開封率は MPP の影響を受ける代理指標であり、成果の評価には直接的なアクションと、プログラムが宣言する成果の真値セットを用います。

必ず実行するタイミング

  • チャネルの安全性が不確かな場合に、重要な一斉配信/シーケンスをリリースする前。
  • 認証、同意、抑制、苦情、頻度、クレーム、またはアトリビューションにゲート判定が必要な場合。
  • ユーザーが EQS/SEND のベースラインまたは再実行を求めた場合。

クイックスタート

Audit this newsletter using the last 90 days, provider split, MPP share, and subscription truth set.
Check this promotional send against DMARC, consent events, live suppressions, claims, and order IDs.

スキルの契約

読み取り対象: 1 つのプログラム/プロファイル、正規化された期間、プロバイダーのエビデンス、最新の同意/抑制状態、レンダリング済みメッセージ、および成果の真値。書き込み対象: 権限が付与された v3 アーティファクトのみ。完了条件: 想定されるすべての SEND 状態が明示され、メールを送信したりプロバイダー設定を変更したりせずにスコアラーの結果が報告されていること。

認証の修正には deliverability-qa、適法な根拠/抑制に関する事実の確認には consent-registry、ジャーニーの設計には email-sequence-designer、事前登録済みテストの設計には send-experiment-designer を使用してください。

データソース

必要な情報推奨されるエビデンス
認証DNS、メッセージヘッダー、DMARC の集計エビデンス
同意/抑制追記専用の同意イベントと最新のライブプロジェクション
配信先/レピュテーションプロバイダー/シードパネルおよび日付付き ESP/プロバイダーレポート
エンゲージメントコホート/プロバイダー/MPP セグメント別の ESP エクスポート
ライフサイクルトリガー/フロー設定とイベントエクスポート
成果E コマース、CRM、サブスクリプション、スポンサーシップ、または明示された同等の真値セット
コンテンツレンダリング済みメッセージ/遷移先、および承認済みのクレーム/開示状態

手順

ランタイムでの読み取り
  • ../../../references/auditor-runbook.md
  • ../../../references/scoring-semantics.md
  • ../../../references/send-benchmark.md
  • ../../../references/runtime-invocation.md
  • references/auditor-runtime.md
ランタイムとセットアップ

../../../references/auditor-runbook.md、scoring-semantics.md、send-benchmark.md、および SEND カタログエントリーを読みます。スタンドアロンインストールでは、同梱されている不変の references/auditor-runtime.md を使用してください。変更される可能性のある main は取得しないでください。決定論的な呼び出しを行う前に、runtime-invocation.md に従い、AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}" を解決し、スコアラー、バリデーター、および型付きカタログがあることを確認してください。利用できない場合は、ゲート判定や永続アーティファクトを出力せずに、score_state: NOT_SCORED / score_confidence: not_scored を返してください。

プロファイル(promotional|retention|cold-outbound|newsletter)、対象/プログラム、プロバイダー、市場、正規化された期間、リストの経過期間、MPP の割合、および観測日を宣言してください。

エビデンスとスコアリング
  1. レートを比較する前に、エビデンスを固定し、プロバイダーのコホート/期間を照合してください。
  2. S1..D5 の 20 項目すべてをスコアリングしてください。観測されたすべての状態には、ソース/日付/種類/信頼度が必要です。
  3. オープン率/CTOR を使用しない場合は、理由を添えて E2 を N/A にします。N3/N5 はプログラムの設計に応じて条件付きです。記録やエクスポートが欠落している場合は Unknown とし、N/A にはしません。
  4. 拒否条件を確認してください。
    • SEND-S1:必須の認証が明らかに破損している、または整合していない。
    • SEND-S2:購入済み/スクレイピング済み/違法なリストであることが確認されている。来歴が不明な場合は Unknown とします。
    • SEND-N1:オプトアウトが機能していない/存在しない、または記録済みの抑制が守られていない。
    • SEND-D1:重要なクレーム/開示/オファー条件が承認済みエビデンスに適合していない。
  5. 型付きスコアラーを実行してください。利用可能な場合は、クリック/返信/下流のアクションをエンゲージメントの主要なエビデンスとして使用してください。オープン率/CTOR は、注記付きの代理エビデンスとして扱います。

プログラムのエビデンスが不十分な送信のみのレビューでは、確認済みのレッドラインチェックと具体的な不足情報を報告しますが、NOT_SCORED/UNDECIDED を返してください。「提供されたエビデンスではブロッカーが確認されなかった」ことは、完全な SEND SHIP 判定ではありません。

§2 SEND の実例

  • ニュースレターのプロファイルが完全で、未調整スコアが 81、拒否事項・不合格事項がない場合:DONE/SHIP、最終スコア 81。
  • 販促メールのプロファイルが完全で、未調整スコアが 76、S1 の不合格が 1 件確認された場合:DONE_WITH_CONCERNS/FIX、最終スコア 59。
  • プロファイルが完全で、S2 と N1 の不合格が確認された場合:DONE/BLOCK、最終スコアなし。
  • 同意の出所を確認できない場合:S2 は Unknown、NEEDS_INPUT/UNDECIDED、スコアなし。

§3 SEND のガードレール

  • SPF/DKIM が整合し、監視が有効な DMARC p=none は、自動的に S1 の不合格にはなりません。
  • プロバイダーのワンクリック配信停止ポリシーと法定義務は、分けて記載する必要があります。
  • 開封数と CTOR には、MPP のセグメンテーション/プロキシに関する注意書きが必要です。これらの指標だけでは、人間が注意を払ったことを確認できません。
  • ニュースレターにカート放棄後/購入後のフローが必要とは限りません。申告されたプログラムに該当するジャーニーのみを採点します。
  • 配信頻度の過剰は、重大な E4/E5 の指摘事項ですが、自動的な拒否事項ではありません。

§5 SEND の説明

チャネルと受信者に関するリスクを平易な言葉で説明してください。トレースを求められた場合は、SEND-S1/S2/N1/D1 の判定条件を明確にし、根拠となる DNS/イベント/レンダリングの証拠を提示してください。

レポートと判定

監査担当者向けランブックに記載された、型付き会話ヘッダーを正確に記載して開始してください。status、verdict、score_state を説明文に置き換えてはいけません。明示的に欠落している判定対象項目は、それぞれ検出事項の前に ``ID: `unknown``` の形式で列挙してください。

判定、プロファイル/コンテキスト、スコアまたはカバレッジ/範囲、確信度、S/E/N/D の詳細、結果の真理値集合、確認済みの重要な管理策、Unknown の入力、修正担当者を示してください。DNS のみを根拠にメールの到達性/受信トレイへの配置を断定してはいけません。また、送信を実行してはいけません。

検証チェックポイント

  • プログラム/プロファイル/プロバイダー/期間/リストの経過期間/市場/MPP の割合が申告されています。
  • ライブの抑制状態は、古いプロジェクションや保留中の提案ではなく、リプレイによって検証されています。
  • 20 件すべての状態が有効で、条件付き N/A には理由があります。
  • プロバイダーの指標と、照合済みの結果の真理値が区別されています。
  • 個別の明示的な承認なしに、メール/プロバイダーの変更は行われていません。

永続化

明示的な許可を得た場合に限り、memory/audits/email/YYYY-MM-DD-<topic>.md に永続化してください。採点者が付与した直交する status と verdict を維持してください。完全な v3 のドラフトを、意図した --relative-path を指定して validate-audit-artifact.py で検証し、内容全体を 1 回の Write でのみ永続化したうえで、監査担当者向けランブックに従って保存先を再検証してください。予約済みの保存先に対する Edit/シェル/MCP の変更はサポートされていません。同意、クレーム、プロバイダー設定、ホットキャッシュを自律的に変更してはいけません。

参考資料

次に役立つスキル

コメント