Cloudflare 邮件服务技能
帮助智能体在 Cloudflare 上配置并实现事务性邮件收发与邮件路由。
文档披露了 API token、域名验证、敏感邮件内容、收件人验证、抑制列表、受限发送者绑定及人工审核模式，并提醒不要硬编码凭据；但发送、转发、抑制列表变更等外部副作用缺少明确的用户确认、权限最小化矩阵和回滚方案，且示例涉及完整收件人、主题和邮件事件数据，扣除安全与恢复不足部分，得14/25。
路径划分清晰，区分 Workers binding、REST API、路由和错误码，并说明若干失败处理；但没有针对关键路径的提交测试或可复现实验，部分行为与字段主要依赖外部文档，且“forwarding fails silently”等表述缺乏内部验证，异常输入覆盖有限。按静态上限得8/20。
描述了发送、接收、Agent、CLI/MCP、投递能力等明确场景，也声明事务性邮件与营销邮件的边界；但触发范围较宽，输入、输出和不适用情形仍不够系统，没有中文使用指导，也未说明中国大陆网络可达性，且核心检索依赖海外 Cloudflare、npm、GitHub 服务，扣除环境适配部分，得10/15。
采用主文档加按场景拆分的 references，包含安装、配置、示例、限制和常见错误；仓库提供 Apache-2.0 许可证，且文档明确内容可能滞后并要求检索来源。但缺少技能自身版本、变更日志、维护责任人和明确更新路径，依赖版本治理与 FAQ 仍不完整，得9/15。
示例覆盖 Workers、REST、路由、附件、投递监控和 Agent 邮件处理，若内容准确可直接作为实现起点；但静态审查无法确认 API 字段、命令和示例可运行，也没有验证输出或与手工实现的比较证据，因此按静态校准取上限7/15。
文档列出 Cloudflare 文档、REST API 规范、Workers 类型和 Agents SDK 等可审计来源，并多次要求以原始来源为准；但没有提交测试、CI 结果或独立复现记录，证据主要是作者编写的说明和示例，得4/10。
- 发送和转发邮件会产生真实外部副作用；文档应在执行前要求确认，并明确收件人、发件人、凭据权限和可恢复措施。
- 不要把示例中的远程开发配置直接用于生产或真实收件人；文档说明 remote=true 会实际发送邮件。
- API 字段、Wrangler 命令、错误码和 GraphQL 架构可能随 Cloudflare 产品变化，应在实施时核对原始规范。
- 处理入站邮件、主题、正文、附件和分析事件时应进行最小化存储、访问控制和脱敏。
这个 Skill 能做什么，适合哪些场景？
该技能面向 Cloudflare Email Service，涵盖 Email Sending 和 Email Routing。它指导开发者通过 Workers 绑定或 REST API 发送事务性邮件，也可处理入站邮件和路由。内容覆盖 Agents SDK 邮件处理、Wrangler 配置、MCP 工具以及 SPF、DKIM、DMARC 等投递相关事项。技能强调在正式编码前检索最新 Cloudflare 文档，因为该服务自 2025 年推出且仍在快速演进。
它读取并核对域名是否已启用 Email Sending，检查 wrangler.jsonc 中是否存在 send_email 绑定，并在接收邮件时提示检查 postal-mime。它提供 Workers 绑定、REST API、Email Routing、Agents SDK、Wrangler CLI 和 MCP 的配置路径与示例。它还说明如何发送 HTML 和纯文本邮件、处理附件与自定义标头、转发或回复邮件，并列出常见配置错误及修复方式。
- 使用 Cloudflare Workers 构建注册、通知或欢迎邮件功能的开发者。
- 需要让 Cloudflare Agents SDK 智能体接收邮件并通过 onEmail() 或 replyToEmail() 处理邮件的开发者。
- 从 Node.js、Python 或 Go 外部应用调用 Cloudflare Email Sending REST API 的开发者。
- 需要为 Workers 配置 Email Sending 或 Email Routing，并通过 Wrangler 或 Dashboard 完成域名设置的团队。
- 需要排查 SPF、DKIM、DMARC、退信、抑制名单或垃圾邮件投递问题的开发者。
这个 Skill 有哪些优点和局限？
- 同时覆盖 Workers 绑定、REST API、Email Routing 和 Agents SDK 邮件场景。
- 提供可直接参考的 wrangler.jsonc、TypeScript 和 REST API 示例。
- 明确区分 Workers API 与 REST API 的字段差异和常见配置错误。
- 包含域名启用、邮件投递和 SPF、DKIM、DMARC 等实践提示。
- 内容明确要求优先检索官方资料，不能视为始终最新的独立产品文档。
- 仅适用于事务性邮件，不适合营销邮件、新闻简报或批量营销活动。
- 源材料没有提供测试套件、版本锁定信息或完整的单个技能安装流程。
- 部分功能依赖 Cloudflare 域名配置、Wrangler、网络访问或 MCP 工具。
如何安装这个 Skill？
该技能属于 cloudflare/skills 集合。支持 Agent Skills 标准的客户端可通过 npx skills add https://github.com/cloudflare/skills 安装整个集合；也可以克隆仓库后，将 skills/cloudflare-email-service 文件夹复制到对应客户端的技能目录。README 明确列出了 Claude Code、Cursor、OpenCode、OpenAI Codex 和 Pi 的目录，但没有提供该单个技能的独立安装命令。
如何使用这个 Skill？
在支持该技能的编码代理中提出具体任务，例如“给我的 Cloudflare Worker 添加邮件发送功能”或“配置 Cloudflare Email Routing 并处理入站邮件”。使用前先确认域名、send_email 绑定和接收邮件所需依赖；发送前运行 npx wrangler email sending list 检查域名，必要时运行 npx wrangler email sending enable yourdomain.com。
这个 Skill 与同类方案有什么区别？
该技能将 Cloudflare Email Service 与专用营销邮件平台作出范围区分：Cloudflare Email Service 用于事务性邮件，而新闻简报和营销活动应使用专用营销邮件平台。