developer-email-sequences

开发者邮件序列

这项技能可帮助你编写开发者真正愿意阅读的邮件序列。不发垃圾邮件，不说空话——只在合适的频率发送实用内容。

---

开始之前

1. 加载开发者受众背景信息：

   • 检查 .agents/developer-audience-context.md 是否存在
   • 如果不存在，请先运行 developer-audience-context 技能
   • 了解开发者使用的技术栈、痛点和沟通偏好，是有效发送邮件的关键

2. 审查现有邮件：

   • 你目前发送了哪些邮件？
   • 打开率、点击率和退订率如何？
   • 开发者对你的邮件有何反馈？

---

开发者邮件的现实情况

开发者对邮件毫不留情：

行为	影响
扫视预览窗格	主题行和第一行至关重要
迅速退订	一封无关的邮件就会导致退订
偏好纯文本	许多人更喜欢纯文本，而不是 HTML
喜爱代码片段	实用的代码示例能带来点击
信任事务性邮件	他们会打开收据，而不是“新闻简报”

黄金法则：每封邮件都必须立即提供价值或解决问题。

---

邮件序列类型

1. 新用户引导序列

目标：让开发者迎来他们的第一个“Hello World”时刻。

时间安排：

• 邮件 1：注册后立即发送
• 邮件 2：24 小时后（如果尚未激活）
• 邮件 3：3 天后（如果尚未激活）
• 邮件 4：7 天后（如果尚未激活）
• 激活后立即停止发送

结构：

邮件	目的	内容
欢迎邮件	确认注册，提供一个明确的 CTA	快速入门链接，仅此而已
首次提醒	解决常见障碍	“大多数开发者都会卡在这里……”
价值提醒	展示可实现的功能	客户示例或代码片段
最后提醒	直接询问	“需要帮助吗？请回复这封邮件”

模板：欢迎邮件

Subject: Your API key is ready

Hey [NAME],

Your API key: [KEY]

Quickstart (2 minutes):
[LINK TO QUICKSTART]

That's it. Hit reply if you get stuck.

— [SENDER NAME]

模板：首次提醒

Subject: Quick question about your setup

Hey [NAME],

Noticed you haven't made your first API call yet.

Where'd you get stuck?

[ ] Didn't have time yet
[ ] Confused about authentication
[ ] Can't find the right SDK
[ ] Something else

Just reply — I read every response.

— [SENDER NAME]

2. 激活序列

目标：将首次使用的用户转变为常规用户。

触发条件：首次成功调用 API 或完成集成后。

时间安排：

• 邮件 1：首次成功后立即发送
• 邮件 2：3 天后
• 邮件 3：7 天后
• 邮件 4：14 天后

结构：

邮件	目的	内容
庆祝	肯定进展	“你的首次调用成功了！”
下一步	展示自然的后续步骤	“大多数开发者接下来会做 X……”
深入功能	介绍高级功能	教程或代码示例
集成	建议用于生产环境	案例研究或部署指南

3. 更新日志 / 产品更新邮件

目标：让开发者及时了解情况，同时避免信息过载。

频率：每周摘要或每次发布时发送（每周绝不超过 2 次）。

结构：

Subject: [Product] v2.3 — Faster webhooks, TypeScript 5 support

What's new:

## Breaking changes (read first)
- Webhook signature algorithm changed (migration guide)

## New
- TypeScript 5.0 support
- Batch API for bulk operations

## Improved
- Webhook delivery 3x faster
- Better error messages for auth failures

## Fixed
- Memory leak in long-running connections

Full changelog: [LINK]

---

Need help upgrading? Reply or join #support in Discord.

规则：

• 重大变更始终放在最前面
• 为新功能提供代码示例
• 链接到完整更新日志，不要把所有内容都塞进邮件
• 不说空洞的营销辞令——只讲事实

4. 重新互动序列

目标：挽回那些已停止活跃的开发者。

触发条件：30／60／90 天没有活动。

时间安排：

• 邮件 1：停止活动第 30 天
• 邮件 2：第 45 天
• 邮件 3：第 60 天
• 邮件 4：第 90 天（停用警告）

结构：

邮件	目的	内容
问候	温和接触	“一切都还好吗？”
最新动态	展示进展	他们错过的近期功能
直接询问	了解原因	调查问卷或回复请求
停用	账户警告	“我们将暂停你的账户……”

模板：问候

Subject: Did something break?

Hey [NAME],

Haven't seen you in a while.

Quick check:

- Did you run into a problem? (Reply and I'll help)
- Building something else? (Totally fine)
- Found a better solution? (Genuinely curious what)

No hard feelings either way — just want to make sure
you're not stuck on something we can fix.

— [SENDER NAME]

模板：停用警告

Subject: Pausing your account in 14 days

Hey [NAME],

Your [PRODUCT] account has been inactive for 90 days.

To keep things tidy, we'll pause your account on [DATE].

What this means:
- Your API keys will stop working
- Your data stays safe (we don't delete anything)
- You can reactivate anytime by logging in

If you're still using [PRODUCT], just log in once to keep
your account active: [LOGIN LINK]

No action needed if you've moved on.

— [SENDER NAME]

---

频率指南

邮件类型	最高频率	备注
交易邮件	按需发送	收据、密码重置、用量提醒
新手引导	7 天内发送 4 封邮件	激活后停止发送
更新日志	最多每周 1 次	优先发送摘要，而非每次发布都发送
重新互动	60 天内发送 4 封邮件	之后停止发送
营销／新闻简报	每月最多 2 次	必须提供真正有价值的内容

退订测试：如果开发者会因为退订这类邮件而感到轻松，那你发送得太频繁了。

---

邮件中的技术内容

代码片段

应该：

• 代码片段控制在 10 行以内
• 使用语法高亮（如果是 HTML 邮件）
• 测试代码是否确实可运行
• 注明语言／框架版本

不应该：

• 假设特定的运行环境
• 包含机密或看起来真实的 API 密钥
• 使用过时的语法

代码片段示例：良好

# Python 3.8+
import yourapi

client = yourapi.Client("your-api-key")
result = client.analyze("Hello, world!")
print(result.sentiment)  # "positive"

API 更新

发布 API 变更公告时：

## New endpoint: POST /v2/batch

Process up to 100 items in a single request.

```python
client.batch([
    {"text": "First item"},
    {"text": "Second item"},
    # ... up to 100 items
])

速率限制：每分钟 10 次批量请求 文档：[LINK]

---

## Transactional vs Marketing Emails

| Transactional | Marketing |
|---------------|-----------|
| Triggered by user action | Sent on schedule |
| Expected and wanted | Needs opt-in |
| Higher deliverability | More spam filtering |
| No unsubscribe required | Must have unsubscribe |
| CAN-SPAM exempt (mostly) | Full CAN-SPAM compliance |

**Examples**:

| Transactional | Marketing |
|---------------|-----------|
| Password reset | Newsletter |
| Payment receipt | Product announcement |
| Usage alert (95% quota) | Case study promotion |
| API key rotation reminder | Webinar invitation |
| Security notification | Feature highlight |

**Gray area**: Onboarding emails can be transactional (user signed up) but should still have easy unsubscribe.

---

## Measuring Email Effectiveness

### Metrics That Matter

| Metric | Good | Warning | Action |
|--------|------|---------|--------|
| Open rate | >40% | <25% | Fix subject lines |
| Click rate | >10% | <3% | Fix content/CTA |
| Unsubscribe rate | <0.2% | >0.5% | Reduce frequency or improve targeting |
| Reply rate | >1% | N/A | Celebrate! |
| Activation (onboarding) | >30% | <15% | Rethink sequence |

### What to Track

1. **Onboarding sequence**: % who activate within 7 days
2. **Changelog emails**: Click-through to docs/release notes
3. **Re-engagement**: % who return to product
4. **All emails**: Unsubscribe rate by email type

### A/B Testing Priorities

1. Subject lines (biggest impact)
2. Send time
3. Email length
4. Plain text vs HTML
5. CTA wording

---

## Unsubscribe Handling

### Preference Center

Let developers control what they get:

[EMAIL] 的邮件偏好设置

[ ] 产品更新（新功能、更新日志） [ ] 安全提醒（始终建议接收） [ ] 社区新闻（活动、聚会） [ ] 技巧和教程

或者：退订所有营销邮件 （你仍会收到收据和安全提醒等交易邮件）

### Graceful Unsubscribe

When someone unsubscribes, confirm simply:

主题：你已退订

你已从 [EMAIL TYPE] 邮件列表中移除。

你仍会收到：

• 安全提醒
• 付款收据
• 用量通知

改变主意了？更新偏好设置：[LINK]

### Re-subscribe Flow

After unsubscribe, don't:
- Send "We miss you" emails
- Ask them to reconsider
- Add them back to other lists

Do:
- Make it easy to re-subscribe from your site
- Remember their preference if they return

---

## Email Templates Library

### Account Security

主题：需要采取措施：检测到异常登录

我们检测到来自新位置的登录：

位置：[CITY, COUNTRY] 设备：[BROWSER/OS] 时间：[TIMESTAMP]

如果这是你本人操作，无需采取措施。

如果不是你本人操作：

1. 立即更改密码：[LINK]
2. 轮换你的 API 密钥：[LINK]
3. 查看近期 API 活动：[LINK]

有疑问？请回复此邮件。

— [PRODUCT] 安全团队

### Usage Alert

主题：提醒：你的 API 配额已使用 80%

你本月的用量：[CURRENT] / [LIMIT] 次请求

按当前速度，你将在 [DATE] 左右达到限额。

可选方案：

• 升级你的套餐：[LINK]
• 优化你的用量：[DOCS LINK]
• 等待 [RESET DATE] 重置

达到 95% 时，我们会再次提醒。

— [PRODUCT]

### Payment Failed

主题：付款失败——请更新银行卡以避免服务中断

我们无法从尾号为 [LAST4] 的银行卡扣款。

更新你的付款方式：[LINK]

我们将在 3 天后重试。如果仍未成功，你的账户将在 [DATE] 降级为免费套餐。

在此之前，你的 API 将继续正常运行。

对账单有疑问？请回复此邮件。

— [PRODUCT]

---

## Common Mistakes

| Mistake | Why it fails | Fix |
|---------|--------------|-----|
| "Just checking in" | No value, wastes time | Every email needs a purpose |
| Weekly newsletter with nothing new | Trains devs to ignore you | Only send when you have content |
| HTML-heavy design | Looks like marketing spam | Plain text or minimal HTML |
| Multiple CTAs | Confuses, reduces clicks | One clear action per email |
| Fake personalization | "Hi [FNAME]" feels robotic | Use personalization meaningfully or not at all |
| Celebrating your milestones | Developers don't care about your funding | Focus on what matters to them |

---

## Tools

| Tool | Use Case |
|------|----------|
| **[Octolens](https://octolens.com)** | Monitor developer sentiment about your emails — see if people complain about frequency or praise specific updates on Twitter, Reddit, Hacker News |
| **Customer.io** | Sophisticated automation for developer-focused email |
| **Postmark** | High deliverability transactional email |
| **Buttondown** | Developer-friendly newsletter platform |
| **Resend** | Modern email API built for developers |
| **Loops** | Email for SaaS with good segmentation |

---

## Related Skills

- `developer-audience-context` — Foundation for knowing what content resonates
- `developer-churn` — Re-engagement strategies for at-risk users
- `changelog-updates` — Structuring product updates
- `developer-onboarding` — Full onboarding strategy beyond just email