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 分）

每出现一项即扣分：

• 全大写单词
• 多个感叹号（!!!）
• 短语：“免费”“立即行动”“限时”“保证”“赢家”“点击此处”“立即购买”“立即下单”
• 过多标点符号（$$$、???）

强力词汇（每项加 5 分，最多加 15 分）

策略性使用以下词汇可获加分：

• “新”“独家”“已验证”“秘密”“探索”
• “终极”“必备”“完整”“突破”
• 行业专属强力词汇

个性化（加 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 分）

• 1 个主要 CTA = 25 分（转化效果最佳）
• 2 个 CTA = 15 分（可接受）
• 3 个或更多 CTA = 5 分（焦点分散）
• 0 个 CTA = 0 分（没有行动路径）

CTA 清晰度（0-15 分）

根据以下标准评分：

• 15 分：行动动词 + 优势（“获取我的免费指南”“开始试用”）
• 10 分：通用行动（“了解更多”“下载”）
• 5 分：含糊不清（“提交”“点击此处”）
• 0 分：没有 CTA 或不清晰

框架结构（0-15 分）

检查邮件是否遵循经过验证的框架：

• PAS（问题-激化-解决方案）：15 分
• AIDA（注意-兴趣-欲望-行动）：15 分
• BAB（之前-之后-桥梁）：15 分
• FAB（特点-优势-利益）：15 分
• 4Ps（描绘-承诺-证明-推动）：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 + 嵌入式图片（如果使用 data 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
• 暗色模式颜色覆盖规则

图片替代文本（每处缺失扣 5 分）

• 所有 <img> 标签都必须带有 alt 属性
• 替代文本应描述图片内容，而不应只是文件名

基于表格的布局（不符合则扣 5 分）

• 邮件布局应使用 <table>（HTML 邮件最佳实践）
• 使用 CSS Grid/Flexbox 时扣分（邮件客户端支持较差）

字体安全性（不符合则扣 5 分）

• 必须使用带后备字体的 Web 安全字体
• 示例：font-family: Arial, Helvetica, sans-serif;
• 避免使用没有后备字体的自定义 Web 字体

CTA 按钮尺寸（不符合则扣 5 分）

• 至少为 44x44 像素（适合移动设备触控）
• 检查所有设置了按钮样式的 <a>

纯文本版本（不符合则扣 10 分）

• 必须包含纯文本 MIME 部分，或
• 在 HTML 中提供纯文本回退内容

预标题文本（缺失则扣 5 分）

• 30-80 个字符的预览文本
• 紧接在 <body> 标签之后
• 在 HTML 视图中通常使用 CSS 隐藏

---

4. 投递能力信号（权重 15%）

基础分：100 分，出现危险信号时扣分

垃圾邮件词语密度（每个词扣 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. 发现的问题：按严重程度分组（严重/高/中/低），并提供具体的修复方法
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

• 根据 ID 从 Gmail 获取草稿邮件
• 提取主题和 HTML 正文

gmail_send_message

• 发送审核后的邮件（需用户批准）

---

示例

高分邮件（92/100）：主题“新指南：2026 年 5 个经验证的 SEO 策略”——8 个词，包含有力词语，不含垃圾邮件触发词，280 个词，1 个 CTA，响应式 HTML，包含所有合规要素。状态：可发送。

低分邮件（23/100）：主题“免费赚钱！！！立即行动，保证中奖！！！”——全大写，4 个垃圾邮件触发词，50 个词，5 个 CTA，缺少退订信息和地址。状态：禁止发送（违反 CAN-SPAM）。

---

注意事项

• 手动评分前，始终先运行可用脚本
• 遇到边缘情况时，参考知识文件
• 提供具体、可执行的建议
• 切勿批准存在合规违规问题的邮件
• 考虑用户所在行业背景（B2B、B2C 或事务性邮件）
• 根据不断发展的最佳实践更新评分标准