核心用法
ravi-email-writing 是一套面向技术用户的邮件写作最佳实践规范，专为通过 Ravi 平台发送邮件而设计。该技能不提供可执行代码，而是作为前置参考文档，指导用户在调用 ravi-email-send 等邮件发送技能前正确撰写邮件内容。
关键使用场景：
- 撰写新邮件（compose）前的格式与内容准备
- 回复（reply/reply-all）或转发（forward）时的结构优化
- 诊断邮件进入垃圾箱的问题
HTML 结构规范：
- 必须使用语义化标签（
<p>、<ul>/<li>、<h2>），禁止纯文本 - 禁止
<br>链式换行，段落间用独立<p>标签 - 禁止包裹
<html>/<head>/<body>标签 - 链接必须使用
<a href="...">描述文本</a>，禁用裸 URL - 签名通过 API 动态获取：
curl ... https://ravi.id/api/identities/
主题行优化：
- 长度控制在 40-60 字符（移动端截断阈值）
- 具体明确，避免模糊词汇如 "Update"
- 禁用全大写、垃圾词（free/urgent/limited time 等）
反垃圾策略：
- 保持高文本/HTML 比例，避免过度格式化
- 禁用短链接服务（bit.ly、t.co 等）
- 单邮件链接不超过 2-3 个
- 全大写禁用，强调用
<strong> - 一邮件一主题，避免内容重复
显著优点
1. 技术集成友好：提供可直接复制的 Bash 模板，包含身份名称 API 调用，实现签名自动化
2. 反垃圾针对性：基于邮件服务商过滤规则设计，非泛泛而谈
3. 格式约束明确：HTML 标签白名单式规范，降低渲染异常风险
4. 语气分层指导：区分内部（casual）与外部（professional）沟通场景
5. 诊断对照表：Common Mistakes 表格可直接用于排查投递失败原因
潜在局限
- 平台专属：规范深度绑定 Ravi 邮件系统（
ravi.id/api），迁移至其他邮件服务需重写 - 无视觉辅助：纯文本 Markdown 形式，无示例渲染效果图
- 文化语境局限："Hi there" 替代 "Dear Sir/Madam" 的建议偏向北美商务习惯
- 动态身份依赖：签名获取依赖
$RAVI_MGMT_KEY环境变量配置，新手易遗漏 - 无 A/B 测试数据：反垃圾建议基于通用规则，未提供 Ravi 平台实测送达率对比
适合人群
- 需通过 Ravi API/CLI 批量发送邮件的技术用户
- 运维自动化邮件（告警、报告、通知）的 DevOps/SRE
- 邮件进入垃圾箱问题待排查的发件人
- 希望从"AI 味"文风转向自然人声的写作者
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **格式渲染失败** | 误用 `<br>` 链或裸文本导致整段丢失换行 | 使用提供的 Bash 模板作为起点 |
| **身份泄露** | 硬编码签名或 API 密钥误提交至版本控制 | 严格通过环境变量注入 `$RAVI_MGMT_KEY` |
| **过度优化** | 为避免垃圾词而写出别扭的主题行 | 优先自然可读，再检查关键词 |
| **API 依赖失效** | `ravi.id` 域名变更或身份端点调整 | 关注 ravi-identity 技能更新 |
| **移动端显示异常** | 超 60 字符主题被截断，核心信息丢失 | 主题前 30 字符放置最关键信息 |