SuperAPI AI 工具集

email-generation

办公与效率

查看项目

更新于 10-15 21:40

技能介绍

用途:将设定好的邮件序列模板(sequence.md,来自 email-prompt-building)与已填好输入字段的联络人 CSV 结合,渲染出冷启动外联邮件序列。该技能是渲染器,不做推理也不做执行,所有策略在模板设计阶段完成,逐行信息由上游的归一化与信息补全填入。

主要能力:按路由键(如 customer_segment)选择触点变体;替换 {{fields}} 占位符;按目标格式渲染。三种渲染目标:review(保留 \n\n 段落与 \n 软换行,CSV 写入须给多行单元格加引号)、html(\n 转 <br />,并对 & < > 做 HTML 转义)、plain(保持原样)。

使用要点:操作顺序不可更改——先路由变体,再替换字段,最后对完整字符串做转义与换行转换。模板中 \n\n 表示段落分隔,\n 表示段落内软换行,渲染器必须保留此区别。仅首触点带主题行,后续触点主题留空以延续同一线程。输出两个文件:emails CSV(每行对应 联络人×触点,含 email、first_name、company_name、touch、variant、subject、body、body_html、gaps 列)和人工可读的审阅文件,写入 GTM 项目的 campaign-assets 位置。

必要命令:参考资料见 references/render_emails.py。

失败防护:防止忘记 \n→<br /> 导致整段文字堆叠;防止在替换前转义(如 Johnson & Johnson 会破坏 HTML);防止双重转义;防止多行 CSV 单元格未加引号;写入前必须断言输出中不存在残留的 {{ 占位符。

质量检查:确认无未替换占位符、变体路由正确、换行在 HTML 目标中正确转换、含 & < 的字段值被正确转义一次、行数等于联系人×触点数、回退字段记入 gaps、后续触点主题为空。

抑制名单:写入前丢弃邮箱位于项目抑制名单(退订、退信、停用地址)中的联系人;名单存放位置由项目决定,此技能仅执行。

限制:无 LLM 调用;若邮件有误,问题在模板或输入数据,应改源头后重新渲染,切勿手工编辑单封邮件;若尚无 sequence.md,需先用 email-prompt-building 设计,本技能不杜撰文案。