集成或排查 Cloudflare Email…

需要在 Cloudflare 平台发送事务性邮件、路由入站邮件，或排查其投递配置时使用。

适用场景

解决思路

1. 对任何 Cloudflare Email Service 任务，优先通过检索获取最新信息，不要仅依赖预训练知识；该产品 2025 年推出且快速演进。
2. 当本技能与来源不一致时，始终信任原始来源：Cloudflare docs、REST API spec、@cloudflare/workers-types 和 Agents SDK repo 是事实来源；有疑问时从这些来源检索并按其内容执行。
3. 用 Cloudflare MCP 的 docs 工具或访问 URL https://developers.cloudflare.com/email-service/ 检索 Cloudflare docs，用于 API reference、limits、pricing、latest features。
4. 访问 https://developers.cloudflare.com/api/resources/email_sending 检索 REST API spec，用于 Email Sending REST API 的 OpenAPI spec。
5. 访问 https://www.npmjs.com/package/@cloudflare/workers-types 检索 Workers types，用于类型签名和 binding shapes。
6. 访问 https://developers.cloudflare.com/agents/examples/email-agent/ 检索 Agents SDK docs（Email agent walkthrough），用于 Agents SDK 中的邮件处理。
7. 写任何邮件代码前，运行 npx wrangler email sending list 查看哪些域名已启用 email sending。
8. 如果域名未出现在上一步列表中，运行 npx wrangler email sending enable userdomain.com，或查看 references/cli-and-mcp.md 获取完整设置说明。
9. 在 wrangler.jsonc 中查找 send_email，确认 Workers 的 binding 已配置。
10. 运行 npm ls postal-mime，确认 postal-mime 已安装；仅在接收/解析邮件时需要。
11. 若要从 Cloudflare Worker 发送邮件，使用 Workers binding（无需 API keys），并阅读 references/sending.md。
12. 若要从使用 Cloudflare Agents SDK 构建的 AI agent 发送邮件，在 Agent class 中使用 onEmail() + replyToEmail()，并阅读 references/sending.md。
13. 若要从外部 app 或 agent（Node.js、Go、Python 等）发送邮件，使用 REST API with Bearer token，并阅读 references/rest-api.md。
14. 若要从编码代理（Claude Code、Cursor、Copilot 等）发送邮件，使用 MCP tools、wrangler CLI 或 REST API，并阅读 references/cli-and-mcp.md。
15. 若要接收并处理入站邮件（Email Routing），使用 Workers email() handler，并阅读 references/routing.md。
16. 若要设置 Email Sending 或 Email Routing，运行 wrangler email sending enable / wrangler email routing enable，或在 Dashboard 中设置，并阅读 references/cli-and-mcp.md。
17. 若要提高 deliverability、避免进入垃圾邮件文件夹，配置 authentication、content、compliance，并阅读 references/deliverability.md。
18. 在 Workers 中发送时优先用 binding；外部 apps 或明确要求时用 REST。
19. 写代码前，根据所选任务阅读 references/sending.md 或 references/rest-api.md 以检索文档。
20. 使用这些指南覆盖 setup、recipients、attachments、headers、limits、response handling 和 errors；Workers guide 还覆盖 Agents SDK integration 以及与项目配置匹配的类型。
21. 如果忘记在 wrangler config 中配置 send_email binding，添加 "send_email": [{ "name": "EMAIL" }] 到 wrangler.jsonc。
22. 如果从 unverified domain 发送，先运行 wrangler email sending enable yourdomain.com，或在 Dashboard 中 onboard domain。
23. 如果在 email handler 中需要读取 message.raw 两次，先缓冲：const raw = await new Response(message.raw).arrayBuffer()；因为 raw stream 是 single-use。
24. 如果只写 HTML 而缺少 text 字段，始终同时包含 html 和 text 两个版本。
25. 不要用 Email Service 做 marketing/bulk sends；它仅用于 transactional email；newsletters 和 campaigns 使用专门的 marketing email platform。
26. 如果使用 message.forward()，只能转发到 verified addresses；运行 wrangler email routing addresses create user@gmail.com 或在 Dashboard 中添加。
27. 开发测试时不要使用 fake addresses；使用你控制的 real addresses，避免因退信损害 sender reputation。
28. 不要硬编码 API tokens 到源代码；使用 environment variables 或 Cloudflare secrets。
29. 不要忽略 from domain requirement；from address 必须使用已 onboard 到 Email Service 的域名；先验证域名，再从 anything@that-domain.com 发送。
30. 在 REST API 的 from 对象中不要用 email key；REST API 使用 address。具体：REST 用 { "address": "...", "name": "..." }，Workers 用 { "email": "...", "name": "..." }。
31. 在 REST API 中不要用 replyTo；REST API 使用 snake_case field names。具体：REST API 用 reply_to，Workers binding 用 replyTo。
32. 阅读与当前情况匹配的 reference，不需要全部：references/sending.md 是 Workers binding、attachments 和 Agents SDK email 的文档地图。
33. references/rest-api.md 是 HTTP sending、request schemas、responses 和 errors 的文档地图。
34. references/routing.md 是 inbound email() handler、forwarding、replying、parsing 的文档地图；用于接收邮件。
35. references/cli-and-mcp.md 是 domain setup、wrangler commands、MCP tools 的文档地图；用于首次设置。
36. references/deliverability.md 是 SPF/DKIM/DMARC、bounces、suppressions、best practices 的文档地图。

适用边界 · 注意事项

• 不适用于营销/群发邮件（newsletters、campaigns）；Email Service 仅用于 transactional email。
• 不适用于非 Cloudflare 邮件平台或无法访问 Cloudflare 账号、wrangler/MCP/官方文档的场景；这是 Cloudflare 特定集成。
• 当无法访问/使用 Cloudflare 官方来源进行检索时，不适用；应优先官方来源并以其为准。