email-quality-auditor

Email 质量审计器

使用 SEND 审计一个电子邮件项目/配置文件及其观察窗口。打开率是受 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.

技能约定

读取： 一个项目/配置文件、标准化窗口、服务商证据、实时同意/抑制状态、渲染后的消息，以及结果真值。写入： 仅写入经过授权的 v3 工件。完成条件： 明确列出所有预期的 SEND 状态，并报告评分器结果；不发送电子邮件，也不更改服务商设置。

使用 deliverability-qa 修复身份验证问题，使用 consent-registry 获取合法依据/抑制事实，使用 email-sequence-designer 设计用户旅程，使用 send-experiment-designer 设计预注册测试。

数据来源

需求	首选证据
身份验证	DNS、邮件头、DMARC 汇总证据
同意/抑制	仅追加的同意事件及当前实时投影
邮件投递位置/声誉	服务商/种子面板，以及带日期的 ESP/服务商报告
互动	按队列/服务商/MPP 细分的 ESP 导出数据
生命周期	触发器/流程配置及事件导出数据
结果	电商、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. 对全部 20 项 S1..D5 标准评分。每个已观察状态都必须注明来源/日期/类型/置信度。
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 工作示例

• 完整的 newsletter 档案，原始分数为 81，无否决项/失败项：DONE/SHIP，最终分数为 81。
• 完整的推广档案，原始分数为 76，有一项已验证的 S1 失败：DONE_WITH_CONCERNS/FIX，最终分数为 59。
• 完整档案，有已验证的 S2 和 N1 失败：DONE/BLOCK，无最终分数。
• 缺少同意来源信息：S2 为 Unknown，NEEDS_INPUT/UNDECIDED，无分数。

§3 SEND 防护措施

• 如果 DMARC 为 p=none，且 SPF/DKIM 对齐并处于主动监控状态，则不自动视为 S1 失败。
• 必须分别说明服务提供商的一键退订政策和法定义务。
• 打开率和 CTOR 必须注明 MPP 分段/代理的限制；仅凭这些指标无法证明有人类注意力。
• Newsletter 不一定需要购物车/购买后流程；只对适用于其声明项目的用户旅程评分。
• 发送频率过高属于严重的 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；使用 validate-audit-artifact.py 针对预期的 --relative-path 验证完整的 v3 草稿，仅通过一次完整内容的 Write 进行持久化，并根据审计员运行手册重新验证目标文件。不支持通过 Edit/shell/MCP 修改预留存储目标。不得自主修改同意记录、声明、服务提供商设置或热缓存。

参考资料

• SEND 基准
• 测量协议
• 审计员运行手册
• 评分语义

下一项最佳技能

• 身份验证/邮件送达位置： deliverability-qa
• 同意/抑制： consent-registry
• 生命周期： email-sequence-designer
• 实验： send-experiment-designer