email-write

邮件撰写子技能

目的

使用经过验证的文案框架，生成专业且高转化率的邮件文案。提供带评分的主题行变体、支持深色模式的响应式 HTML 模板、纯文本备用版本，以及预览文本建议。

激活

当用户需要撰写新邮件时，主 /email 技能会调用此子技能。

工作流

1. 收集背景信息

首先，检查项目目录中是否存在 email-profile.md。如果存在，从配置文件中加载业务类型、语气偏好和目标受众。

如果不存在配置文件，或者用户提供了新的背景信息，请询问：

• 邮件目的：冷启动拓展、新闻简报、产品发布、促销、重新互动、欢迎邮件、功能公告等
• 收件人：姓名、角色、关系（新潜在客户、现有客户、订阅者、团队成员）
• 语气：专业、友好、轻松、权威、共情、热情
• 业务类型：（从配置文件获取或询问）SaaS、电商、服务型企业、代理机构、创作者、B2B、B2C
• 核心信息：希望收件人采取什么行动？
• 补充背景：产品详情、促销详情、截止日期、个性化数据

2. 选择文案框架

根据邮件目的，从 references/copy-frameworks.md 中选择合适的框架：

邮件目的	推荐框架	原因
冷启动拓展	PAS	以共情为导向，直击痛点
产品发布	AIDA	营造期待，推动行动
新闻简报	BAB 或 AIDA	通过愿景或引人入胜的故事传达内容
功能公告	FAB	清晰呈现功能的价值主张
促销／打折	AIDA	激发需求和紧迫感
重新互动	PAS	指出失去互动的问题
欢迎邮件	BAB	展示转变历程
案例研究	4Ps	以证据为主，依靠客户证言
评价请求	PAS	以共情的方式征求反馈
预约提醒	直接表达	无需框架

如果不确定，营销邮件默认使用 AIDA，关系维护类邮件默认使用 PAS。

3. 生成主题行

使用以下策略创建 3 个主题行变体：

1. 好奇心驱动：制造悬念、留下未解之谜、提出问题或预告内容
2. 利益驱动：清晰呈现价值主张、成果或结果
3. 紧迫感驱动：强调时效性、稀缺性或 FOMO（但不要像垃圾邮件）

主题行规则：

• 最佳长度：6～10 个词／30～50 个字符
• 切勿使用全大写
• 每个主题行最多使用 1 个感叹号
• 避免触发垃圾邮件过滤的词语：“FREE!!!”、“Act Now”、“Limited Time Only”、“Guaranteed”、“Cash”、“No obligation”
• 尽可能加入个性化内容（除名字外，还可使用行为、地点、购买历史）
• 使用有感染力的词语：exclusive、secret、insider、proven、breakthrough、transform、discover

评分方法（0～100）：

标准	权重	评分方式
长度	20	30～50 个字符得 100 分；超出或不足时，每多或少 5 个字符扣 10 分
有感染力的词语	20	每个加 20 分（最多计算 2 个）
个性化	25	个性化内容超出名字时加 25 分
垃圾邮件触发词	-50	含有垃圾邮件词语时扣 50 分
清晰度	20	利益或主题清晰时得 100 分
好奇心	15	留下未解之谜时加 15 分

最低合格分数：70

4. 撰写预览文本

生成预览文本建议（30～80 个字符）：

• 必须补充主题行，而不是重复主题行
• 包含次要价值主张或行动号召预览
• 避免使用“在浏览器中查看此邮件”等泛泛文字

示例：

• 主题行：“您的个性化 SEO 规划已就绪”
• 预览文本：“本周提升排名的 3 个快速方法”

5. 撰写邮件正文

套用选定的框架结构。撰写前，请从 references/copy-frameworks.md 加载完整的框架详情。

邮件撰写通用规则：

• 开场：第一句话就吸引读者；如果知道收件人的姓名，请称呼对方
• 正文：使用简短段落（每段最多 2-3 句话），并用项目符号提升可读性
• 语气：与资料或用户输入中要求的语气保持一致
• 个性化：使用 {{firstName}}、{{company}}、{{productName}} 等合并标签
• 行动号召（CTA）：设置一个主要 CTA，表达清晰且以行动为导向（“获取免费审核”“抢占席位”“开始试用”）
• 社会认同：如有，请加入（客户评价、数据、案例研究成果）
• 签名：使用专业的结束语，并注明姓名、职位和公司

各框架的专属结构：

从 references/copy-frameworks.md 加载完整结构并套用。每种框架都包含：

• 章节拆分（例如，PAS：问题 → 加剧 → 解决）
• 过渡语
• 示例模板

6. 生成 HTML 版本

按照以下规范创建响应式、兼容深色模式的 HTML 邮件：

HTML 模板结构：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta name="color-scheme" content="light dark">
  <meta name="supported-color-schemes" content="light dark">
  <title>{{emailSubject}}</title>
  <style>
    /* Inline critical CSS */
    body { margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; }
    table { border-collapse: collapse; }
    .email-container { max-width: 600px; margin: 0 auto; }
    .body-text { font-size: 16px; line-height: 1.6; color: #333333; }
    .cta-button {
      display: inline-block;
      padding: 14px 28px;
      background-color: #0066cc;
      color: #ffffff;
      text-decoration: none;
      border-radius: 4px;
      font-weight: bold;
      min-height: 44px;
      min-width: 44px;
    }

    /* Dark mode styles */
    @media (prefers-color-scheme: dark) {
      body { background-color: #1a1a1a !important; }
      .body-text { color: #e0e0e0 !important; }
      .email-container { background-color: #2a2a2a !important; }
    }

    /* Mobile responsive */
    @media only screen and (max-width: 600px) {
      .body-text { font-size: 14px !important; }
      .headline { font-size: 22px !important; }
      .cta-button { display: block !important; width: 100% !important; }
    }
  </style>
</head>
<body>
  
</body>
</html>

HTML 规则：

• 使用基于表格的布局（为兼容邮件客户端，不使用 CSS Grid/Flexbox）
• 最大宽度：600px
• 将关键 CSS 写为内联样式（部分客户端会移除 <style> 标签）
• 使用带回退字体的 Web 安全字体：Arial、Helvetica、Georgia、Times New Roman
• 正文最小字号为 14px，移动设备上的标题字号为 22px
• CTA 按钮：触控区域至少为 44x44px，对比度至少为 4.5:1
• 添加 color-scheme: light dark 元标签
• 使用 @media (prefers-color-scheme: dark) 编写深色模式 CSS
• 为所有图片添加替代文本（描述图片内容，不要写“图片”或“照片”）
• 为确保无障碍访问，始终包含纯文本 MIME 部分

CTA 按钮最佳实践：

• 每封邮件设置一个主要 CTA（次要 CTA 可以使用文本链接）
• 使用带有 role="button" 的 <a> 标签以确保无障碍访问
• 内边距：垂直方向至少 14px，水平方向至少 28px
• 背景颜色与文本的对比度至少为 4.5:1
• 为深色模式提供备用样式（更浅的背景色或反转颜色）

7. 生成纯文本版本

创建纯文本备用版本，并满足以下要求：

• 不包含 HTML 标签
• 通过换行提升可读性（每行最多 70 个字符）
• CTA 使用独占一行的完整 URL
• 签名块包含联系信息

8. 输出格式

按以下结构呈现最终邮件：

## Email Composition

**Framework**: [chosen framework name]
**Purpose**: [email purpose]
**Tone**: [tone]
**Recipient Type**: [recipient type]

---

### Subject Line Options

| # | Subject | Score | Type | Notes |
|---|---------|-------|------|-------|
| 1 | [subject line 1] | 87 | Curiosity | [why this works] |
| 2 | [subject line 2] | 82 | Benefit | [why this works] |
| 3 | [subject line 3] | 79 | Urgency | [why this works] |

**Recommended**: #1 (highest score)

**Preheader Text**: [30-80 char preheader recommendation]

---

### Email Body (Plain Text)

[Full email body using framework structure]

[Include merge tags like {{firstName}}, {{company}}]

[CTA]

[Signature]

---

### HTML Version

```html
[Complete HTML email code with inline CSS, dark mode support, responsive design]

---

纯文本版本

[Plain text fallback with line breaks, CTA as full URL]

---

邮件元数据

• 字数：［正文词数］
• 阅读时间：［预估阅读时间］
• 字符数（含空格）：［数量］
• CTA 数量：［数量］

---

后续步骤

• 审阅并编辑文案
• 选择主题行版本
• 在邮件客户端预览工具中测试 HTML 渲染效果
• 通过 MCP 以草稿形式发送（如果可用），或复制到邮件平台
• 如果要发送给大型邮件列表，请对主题行进行 A/B 测试

## Quality Gates

Before delivering the email, verify:

1. **Subject line scores**: At least one variant scores 70+
2. **Preheader length**: 30-80 characters
3. **Framework alignment**: Body follows chosen framework structure
4. **CTA clarity**: Primary CTA is clear and action-oriented
5. **Mobile readability**: Paragraphs are 2-3 sentences max
6. **HTML validity**: Table-based layout, inline CSS, dark mode support
7. **Accessibility**: Alt text on images, plain-text fallback included
8. **Spam check**: No spam trigger words in subject or body
9. **Personalization**: Merge tags used where appropriate
10. **Tone match**: Email tone matches requested tone from profile

If any gate fails, revise before output.

## Error Handling

- If `references/copy-frameworks.md` is missing, warn user and use basic AIDA structure
- If `email-profile.md` is missing, prompt user for context (don't fail)
- If subject line scores are all below 70, generate new variants
- If HTML template fails validation, fall back to plain-text only and warn user

## Resources

- `references/copy-frameworks.md` - Full framework structures and examples
- `email-profile.md` - User's business context and preferences (optional)

## Example Invocation

User: "Write a cold outreach email to a SaaS founder about my SEO audit service"

Agent:
1. Loads email-profile.md (if exists)
2. Selects PAS framework (cold outreach)
3. Generates 3 subject line variants with scores
4. Writes email body following PAS structure
5. Creates HTML template with dark mode
6. Creates plain-text fallback
7. Outputs full email composition with metadata and next steps

## Notes

- This sub-skill focuses on composition only (no sending/scheduling)
- For sending emails, use `email-send` sub-skill or MCP email tools
- For A/B testing, generate multiple variants using different frameworks
- Always adapt tone and complexity to recipient type (B2B vs B2C, technical vs non-technical)