用 WorkBuddy 打造“介绍信跨页同步 + 自动邮件”技能：一次踩坑与排障复盘

昨天，我用 WorkBuddy 创建了一个技能：为介绍信添加跨页内容同步，并实现自动处理与邮件发送。目标很明确——第一页存根内容填写好后，自动把“兹介绍”以后的内容同步到第二页，介绍信编号同步到分隔线上的“介绍信编号”，再根据起止日期计算天数更新到“介绍信有效期”。如果录入了发件人邮箱和收件人邮箱，就自动把处理后的介绍信文档以附件形式发给收件人，邮件标题固定为：

自动处理添加跨页内容同步的介绍信

中间邮件发送环节出了问题，后来通过 WorkBuddy 在线专家团队协助定位并解决，最终验证正常。这里把整个过程和心得记录下来，供团队参考。

一、背景：介绍信处理为什么需要自动化

介绍信通常有固定模板：第一页是存根，第二页是正文。实际使用中，重复劳动很多：

1. 第一页填完存根后，第二页还要再填一遍正文；
2. 介绍信编号要在第二页分隔线位置再写一次；
3. 有效期要根据起止日期手动算天数；
4. 处理完还要保存文档、写邮件、加附件、发送给收件人。

这些动作单次不复杂，但频次一高就容易出错：编号不一致、正文漏同步、天数算错、邮件忘发或附件发错。于是我想用 WorkBuddy 生成一个技能，把这条链路自动化。

二、需求拆解：把“一句话需求”变成可执行技能

我把需求拆成五个核心能力：

1. 跨页内容同步 第一页存根填写完成后，自动识别“兹介绍”作为正文起点，把“兹介绍”以后的内容同步到第二页对应区域。
2. 介绍信编号同步 第一页的介绍信编号，自动写入第二页分隔线上的“介绍信编号”位置。
3. 有效期自动计算 根据介绍信起止日期计算天数，并更新到“介绍信有效期”。这里和业务确认后，采用含起止日的自然日算法： 有效期天数 = 结束日期 - 开始日期 + 1
4. 自动邮件发送 如果发件人邮箱、收件人邮箱都已录入，则自动将处理后的介绍信文档作为附件发送。 邮件标题固定为：自动处理添加跨页内容同步的介绍信。
5. 异常与验证 文档生成成功但邮件失败时，不能影响文档保存；邮件失败要能重试、能看日志；发送前要校验邮箱格式、附件路径和文档保存状态。

在 WorkBuddy 里创建技能时，我把这些输入、输出、触发条件和异常处理都写进了技能描述。经验是：技能描述越像一份小型需求文档，生成结果越稳定。

三、实现路径：锚点、映射、计算、发送

整体链路可以概括为：

读取模板 → 定位锚点 → 提取存根字段 → 同步第二页正文 → 同步编号 → 计算有效期 → 保存文档 → 发送邮件 → 记录日志

1. 用“锚点”而不是“坐标”做跨页同步

跨页同步最怕硬编码第几段、第几行。模板一调整，逻辑就失效。因此我用“兹介绍”作为正文起始锚点，截取到正文结束标记或落款前，再写入第二页的正文区域。

编号同步也类似：不按绝对位置找，而是找“介绍信编号”这个标签，把第一页编号写入第二页分隔线对应位置。

2. 日期计算与字段更新

有效期计算逻辑写成可配置规则：

text

days = (end_date - start_date).days + 1

如果后续业务改成不含起始日，只需要调整规则，不用重写整个技能。

3. 邮件发送独立成模块

邮件发送不直接塞在文档处理主流程里，而是作为独立步骤。伪代码大致是：

text

if 发件人邮箱 and 收件人邮箱:
    保存并关闭文档
    附件 = 文档绝对路径
    send_mail(
        subject="自动处理添加跨页内容同步的介绍信",
        to=收件人邮箱,
        from=发件人邮箱,
        attachment=附件
    )

这样即使邮件失败，文档也已经生成并保存，不会出现“邮件没发出去，文档也没了”的情况。

四、踩坑：邮件发送环节出问题

文档生成和跨页同步很快跑通了，但邮件发送一开始不稳定。表现包括：

• 有时提示认证失败；
• 有时收件人收不到附件；
• 中文附件名偶尔乱码；
• 文档刚生成就被占用，附件为空或损坏；
• 邮件标题虽然正确，但正文和附件状态不一致。

一开始我以为是代码问题，后来发现邮件发送涉及 SMTP、认证、加密方式、附件编码、文档占用、收件人格式等多个故障域。于是请 WorkBuddy 在线专家团队介入。

专家团队主要做了几件事：

1. 看日志定位阶段 区分是连接失败、认证失败、发送失败，还是收件方拒收。
2. 调整 SMTP 配置 确认端口和加密方式匹配，例如 465 SSL 或 587 STARTTLS，避免混用。
3. 改用应用专用密码/授权码 不硬编码明文密码，使用邮箱授权码，并放入安全配置。
4. 修复附件处理 发送前确保文档已保存并关闭；使用绝对路径；按 MIME 规范添加附件；对中文文件名做编码处理。
5. 增加校验与重试 发送前校验发件人、收件人邮箱格式；失败进入重试队列；用业务编号做幂等，避免重复发送。
6. 验证闭环 用不同邮箱、不同网络、中文附件名、多收件人场景反复测试，确认收件正常、附件可打开、标题正确、内容同步无误。

最终验证结果：文档跨页同步正常，编号同步正常，有效期天数正确，邮件标题为“自动处理添加跨页内容同步的介绍信”，附件发送正常。

五、测试用例：不只测“成功路径”

这次我补了几类测试：

• 第一页存根完整填写，第二页为空：正文和编号正确同步；
• 起止日期跨月、跨年：有效期天数计算正确；
• 未填写邮箱：只生成文档，不发送邮件；
• 只填发件人或只填收件人：给出提示，不误发；
• 中文附件名：收件方可正常下载；
• 多收件人：分隔符和格式正确；
• 邮件服务临时失败：文档已保存，邮件可重试；
• 模板微调：锚点仍能定位，不因段落移动而失效。

这些用例跑完后，技能才算真正可交付。

六、心得：WorkBuddy 技能生成，也要工程化思维

这次最大的体会是：用 WorkBuddy 生成技能很快，但要让技能稳定可用，仍然需要工程化拆解。

几点具体心得：

1. 需求要拆到“输入、处理、输出、异常” 只说“自动处理介绍信”不够，必须写清楚触发条件、字段来源、目标位置、失败怎么办。
2. 跨页同步优先用锚点 锚点比坐标稳，模板小改不容易坏。
3. 邮件是独立故障域 不要和文档生成强耦合。文档生成成功先保存，邮件失败可重试、可追溯。
4. 日期规则要可配置 含不含起止日，不同单位可能不同。写成规则，比写死更稳。
5. 安全不能省 邮箱授权码不硬编码，日志脱敏，发送前校验，必要时加人工确认。
6. 专家团队的价值在“定位和验证” 在线专家团队不仅解决了邮件问题，更帮助建立了排查路径和验证闭环。这比单纯改一行配置更有价值。

七、后续优化方向

目前技能已经能完成核心链路。后续还可以继续优化：

• 模板版本管理，适配不同单位介绍信格式；
• 批量生成与批量发送；
• 发送回执与失败队列可视化；
• 与审批流集成，审批通过后自动发送；
• 增加发送前预览和人工确认开关；
• 对邮件发送结果生成审计日志。

总的来说，这次用 WorkBuddy 创建“介绍信跨页内容同步”技能，是一次从自然语言需求到可执行自动化的小型实践。中间邮件发送踩坑，但在线专家团队协助后定位并验证正常。最终效果是：第一页存根填好，第二页自动同步；编号自动带过去；有效期自动算；邮箱齐全时自动以附件发送，邮件标题固定为“自动处理添加跨页内容同步的介绍信”。

自动化真正省下的不只是几分钟，而是减少了重复填写带来的不一致和遗漏。对类似文档处理场景，这套“锚点同步 + 规则计算 + 独立邮件 + 异常重试”的思路，也可以继续复用。