用途：面向 macOS 的 Apple Mail 邮件自动化技能，采用 JXA 为主、AppleScript 字典发现为辅的方式。适用于需要脚本读写邮件、撰写草稿、批量处理邮箱等场景。权限、shell 与 UI 脚本相关指导可参考 automating-mac-apps 技能；PyXA 安装同样见该技能。
主要能力：读取收件箱邮件属性、撰写外发邮件草稿、批量读取、按规则过滤与移动邮件，并可借助 UI 脚本处理签名等仅 UI 可做的操作。对象以 specifier 形式存在，通过方法调用读取（如 message.subject()），通过赋值修改（如 message.readStatus = true）；也可使用 ObjC bridge 做进阶文件系统操作。
使用方式：先确认 Mail 已配置并开启自动化权限（系统设置 > 隐私 > 自动化），在 Script Editor 中查阅 Mail 字典，先用最小 AppleScript 命令原型验证，再移植到带防御性检查的 JXA，必要时使用批量读取提升性能。示例读取收件箱可用 const Mail = Application('Mail'); const message = Mail.inbox.messages[0]; console.log(message.subject()); 撰写邮件可用 Mail.OutgoingMessage({subject: "Status Update", content: "All systems go."}) 并通过 Mail.outgoingMessages.push 与 msg.visible = true 展示草稿。也可用 PyXA：import PyXA; mail = PyXA.Mail(); inbox = mail.inboxes()[0]; message = inbox.messages()[0]; print(f"Subject: {message.subject()}")。
适用场景与限制：适合 macOS 上的 Mail 自动化及 UI 辅助操作。不适用于跨平台邮件自动化（应使用 IMAP/SMTP 库）、大批量邮件发送（应使用 SendGrid 等事务性邮件服务）、处理不可信邮件内容（存在安全风险）以及非 macOS 平台。
校验要点：确认自动化权限已授予，Mail.inbox.messages.length 可访问，消息属性读取返回预期值，撰写可生成可见草稿，批量操作无错误。
可加载参考内容：mail-basics.md、mail-recipes.md、mail-advanced.md、mail-dictionary.md、mail-rules.md、html-signature-workflow.md、attachment-extraction.md、mailbox-archiver.md、html-data-merge.md 及 PyXA API 参考。