双语邮件翻译器

在构建、优化或发布双语邮件翻译工作流时，使用此技能。

该技能的职责范围

该技能定义了将原始邮件转换为面向用户的双语通知文本所需的提示层（prompt-layer）契约。

除非发生明确的产品变更，否则以下职责应始终保留在模型/提示层中：

• 主题行的翻译与双语展示
• 日期的标准化与展示
• 正文内容的双语格式化
• 收件人数量超过 3 个时进行截断
• 对引用邮件/历史往来邮件进行摘要
• 当译文与原文完全相同时，抑制重复行输出
• 签名块（signature block）的格式化

程序侧（Program side）应专注于以下任务：

• 提取原始邮件内容
• 在组装提示前对输入邮件头（input headers）进行标准化
• 调用轻量级工作进程（lightweight worker）或 LLM 运行时环境
• 提取模型输出文本
• 当模型输出失败时，回退至原始邮件内容

参考实现模式

主脚本示例：

• scripts/mail_translate.py

运行时路径示例：

1. 监听器（watcher）、收件箱轮询器（inbox poller）或通知器（notifier）准备原始邮件
2. 翻译脚本构建邮件提示（mail prompt）
3. 轻量级工作进程代理（worker agent）或 LLM 运行时执行翻译
4. 后处理（postprocess）保持透传（pass-through），仅作格式化用途
5. 最终文本交付给用户

必需的契约文件

请先阅读 references/contracts.md，再根据需要打开其中所引用的底层源文档。

变更流程

1. 阅读当前的提示契约文档。
2. 仅在契约本身需要变更时，更新翻译提示或提示组装逻辑。
3. 所有格式化决策应保留在提示中，不得移入后处理阶段。
4. 更新回归测试，以验证提示契约的断言（assertions）。
5. 运行具有代表性的测试，覆盖提示契约的各项要求。
6. 对于有实质意义的提示变更，需至少使用一个真实样本邮件，通过翻译入口点（translation entrypoint）进行端到端验证。
7. 将实际输出与当前公认的产品方向进行比对。
8. 若公认的行为发生变更，则同步更新契约文档。

当前公认的产品方向

• 当产品目标包含语言学习支持、源文本透明性或并排审阅（side-by-side review）时，须保留双语输出。
• 仅当下游渲染器（downstream renderer）有明确要求时，才保留渠道特定的缩进或空格行为。
• 若译文与原文完全相同，则仅保留原文行，不重复输出译文。
• 若收件人数量超过 3 个，仅显示前 3 位，并直接以 ... 结尾。
• 若存在引用邮件/回复历史，应以当前邮件为核心，并在下方使用清晰的节标题（如 历史邮件摘要：）对历史内容进行摘要。
• 签名块格式应保持可读性，但签名清理操作不得覆盖通用的重复行抑制规则（duplicate-suppression rule）。
• 不得在后处理阶段重新引入任何格式化启发式逻辑（formatting heuristics）。

参考资料

• 契约摘要与公开设计说明：references/contracts.md
• 通用命令检查清单：references/commands.md