核心用法
本技能 ravi-email-writing 是一套完整的电子邮件撰写规范体系，专为提升邮件专业度和送达率而设计。核心使用场景包括：
1. 撰写新邮件 — 配合 ravi-email-send 的 compose 命令使用
2. 回复邮件 — 在 reply/reply-all 前参考格式规范
3. 转发邮件 — 优化转发内容的呈现方式
关键输出包括：
- 主题行规范：40-60字符、具体描述、避免全大写和垃圾邮件触发词
- HTML 结构模板：强制使用语义化标签（
<p>,<ul>,<li>,<h2>），禁止纯文本或<br>链 - 可直接复用的 Bash 模板：一键生成标准邮件格式的命令
- 反垃圾邮件规则：高文本/HTML 比例、禁用短链、控制链接数量、单一主题聚焦
显著优点
- 实战性强：提供可直接粘贴使用的命令模板，降低执行门槛
- 覆盖完整：从主题行到签名、从技术格式到语气风格、从撰写到发送全链路覆盖
- 反垃圾邮件专业：基于邮件过滤器的实际工作机制设计规则（如链接数量限制、文本比例优化）
- 人机协作友好：明确标注
--body参数仅用于 compose，reply/forward 自动继承原主题，避免常见误用
潜在缺点与局限性
- 工具链依赖：必须与
ravi-email-send配合使用，单独使用价值有限 - HTML 门槛：要求用户理解基础 HTML 标签，对非技术用户存在学习成本
- 语境适配不足：未涉及跨文化邮件礼仪、时区敏感性、法律合规（如 GDPR 邮件条款）等进阶场景
- 动态内容缺失：无变量替换、条件逻辑等模板化功能，复杂批量邮件需手动处理
适合人群
- 频繁使用 CLI 发送邮件的技术从业者（开发者、DevOps、系统管理员）
- 需要自动化邮件工作流但缺乏邮件营销背景的团队
- 希望提升个人/企业邮件送达率，避免被误判为垃圾邮件的用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 格式错误导致退信 | HTML 结构违规（如包裹 `<html>` 标签）可能引发解析错误 | 严格遵循 "Do this / Don't do this" 示例 |
| 身份泄露 | 签名需使用 `IDENTITY_NAME`，若配置不当可能暴露真实身份信息 | 先执行 `ravi auth status` 确认身份配置 |
| 反垃圾规则误判 | 即使遵循指南，新域名/IP 仍可能被临时标记 | 建议预热发信域名，监控退信率 |
| 过度标准化痕迹 | 严格遵循模板可能导致邮件风格趋同，缺乏个性 | 在结构框架内灵活调整具体内容 |
版本与维护
- 当前为初始版本，未标注更新日期
- 关联技能：ravi-email-send、ravi-inbox、ravi-identity、ravi-feedback