1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | cloudflare-email-service-cloudflare-skills | — |
| 作者/维护者 | Cloudflare, Inc. 官方仓库 cloudflare/skills；该子技能由 PR #41 引入，合并于 2026-04-15，时间早于官方 “Email Sending” 公测发布一天 |
GitHub API（repo + PR） |
| 来源链接 | https://github.com/cloudflare/skills/tree/main/skills/cloudflare-email-service | — |
| 许可证 | Apache-2.0（仓库根 LICENSE 声明） | GitHub API |
| GitHub Stars / Forks | 所属仓库 2,521★ / 239 forks（该数字属整个合集仓库，不代表本子技能个体热度；子技能自身证据见第 6 章） | GitHub API |
| 最新版本 | 无独立版本号系统；该子目录最近一次专属改动提交于 2026-04-15 | GitHub API（commits） |
| 安装方式 | Claude Code 插件市场一条命令 / npx skills / 克隆后手动复制子目录 |
仓库 README |
2. 功能介绍与亮点
cloudflare-email-service 是 Cloudflare 官方为其 Email Service（发信 Email Sending + 收信 Email Routing）产品编写的 Agent 使用指南，教会编码 Agent 在 Cloudflare 平台内完成邮件收发集成。核心覆盖：
- 多入口发信路径：Workers 原生绑定（
env.EMAIL.send()，无需 API key）、面向非 Workers 应用的 REST API（Bearer token）、以及 Agents SDK 中onEmail()/replyToEmail()的邮件收发钩子，三条路径按使用场景分流指引。 - 收信路由：Worker
email()处理函数的转发、回复、拒收与解析（依赖postal-mime）。 - 前置条件自检清单：动笔写代码前先核对域名是否已通过
wrangler email sending enable上线、wrangler.jsonc是否配置了send_email绑定。 - “常见错误”对照表：11 条实测踩坑总结，例如“
message.raw流只能读一次““REST API 用address字段而 Workers 绑定用email字段”等 Workers 绑定与 REST API 之间的细节差异。 - 检索优先设计：文档反复提示该产品上线时间不长且快速迭代，引导 Agent 优先查阅 Cloudflare 官方文档、REST API 规范与 Agents SDK 仓库，而非依赖模型自身记忆。
亮点：这是 Cloudflare Email Service 于 2026 年 “Agents Week” 公测发布后配套推出的官方 Agent 技能，专门解决“AI Agent 需要在生成的应用里加一个发信功能”这一高频需求。
3. 适用场景
固定分类：集成与工作流自动化。
面向需要给自己构建的应用（无论是否运行在 Cloudflare Workers 上）接入邮件收发能力的开发者：欢迎邮件、验证码、通知提醒等事务性邮件发送，或搭建能主动通过邮件与用户交互的 AI Agent。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——仓库 README 提供插件市场一条命令安装（
/plugin marketplace add cloudflare/skills），技能随整个cloudflare插件一并装入。 - Codex：✅ 官方 README 明确写明“这些技能适用于任何支持 Agent Skills 标准的 Agent，包括 Claude Code、OpenCode、OpenAI Codex 和 Pi”，并列出 Codex 专属技能目录
~/.codex/skills/。 - OpenClaw：❓ 未验证——README 未点名。
- Hermes Agent：❓ 未验证——同上。
5. 推荐理由
这是 Cloudflare 官方针对“给应用加邮件功能”这个几乎每个 Web 项目迟早会遇到的需求给出的权威操作手册：三条发信路径按场景分流、收信处理与“常见错误”对照表覆盖了从环境自检到日常排错的完整链路，适合正在用 Cloudflare Workers 或任意技术栈构建应用、需要快速接入事务性邮件的开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属合集仓库 2,521★ 不代表本子技能个体热度，改看子目录自身证据：GitHub issue #80 记录了外部工程师在生产环境使用本技能后反馈的具体技术细节（DKIM selector 应为 cf-bounce 而非常见猜测值）；对应的 Cloudflare Email Service 产品于 2026 年 “Agents Week” 由官方博客专文发布，此后仍有官方 changelog 持续更新；该技能同时被至少 5 个第三方 Agent Skill 目录站收录 |
| 可用性 | 8 | SKILL.md 结构清晰，含前置条件自检、快速开始代码示例、5 份分主题参考文档与 11 条常见错误对照表；Claude Code 插件市场一条命令即可装入；发信到已验证地址免费，发送给任意收件人需要 Workers 付费方案；该子技能所属仓库 README 的技能列表尚未更新收录它，但插件市场安装机制会扫描整个 skills/ 目录，实际安装不受影响 |
| 安全性 | 9 | 检查清单详见下表 |
安全检查清单：
- ① 是否执行 shell 命令及权限范围：技能本身不直接执行任何命令，仅在前置自检环节引导运行
wrangler email sending list等标准 Cloudflare CLI 只读/配置命令 - ② 运行时是否联网外发数据：唯一网络行为是通过 Cloudflare 自身的 Workers 绑定或官方 REST API 发送邮件，数据流向由开发者自己的 Cloudflare 账号掌控，不涉及向未声明的第三方外发
- ③ 是否要求 API key/凭据及其存储方式：Workers 绑定路径无需 API key；REST API 路径需要 Bearer token，文档明确提示“使用环境变量或 Cloudflare secrets，不要把 token 硬编码进源码”
- ④ SKILL.md 与附带脚本中有无可疑指令：全文纯 Markdown + 代码示例，无附带可执行脚本，逐节审阅（含全部 5 份参考文档）未见混淆代码或 prompt injection 迹象
- ⑤ 作者/组织信誉：Cloudflare, Inc. 官方组织仓库，引入该技能的 PR 合并时间与官方公测发布仅相差一天
- ⑥ License 是否明确：明确，Apache-2.0
- ⑦ 最近维护时间：仓库整体活跃（近一周内仍有提交），该子技能内容自 2026-04-15 上线后未见后续改动提交
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
Resend（resend-skills 官方技能） |
独立事务性邮件 API 服务，功能更全面：批量发送、模板、联系人、广播、Webhook 事件追踪，前端声明了对 OpenClaw 环境变量的原生支持 | 无论应用是否运行在 Cloudflare 上都需要单独注册 Resend 账号并管理 API key；本技能则是 Cloudflare 平台原生能力，Workers 应用可用绑定方式免 API key 直接发信，但功能面（模板、广播等营销向能力）不如 Resend 丰富 |
| AWS SES / SendGrid 一类传统事务邮件服务 | 成熟度更高、生态更广，但通常没有面向 AI 编码 Agent 专门编写的 SKILL.md 使用指南 | 本技能针对“Agent 预训练知识可能过时”这一问题做了检索优先设计，并把 Workers 绑定与 REST API 两种路径的字段命名差异等易错细节前置说明，降低 Agent 生成代码时踩坑概率 |
8. 用户评价
该技能目前在第三方平台尚无独立的具名评价文章，但官方仓库 issue 区留有一条可查证的生产环境使用反馈：工程师 sorcerai 报告某域名 DKIM 记录曾被误判为“未配置”，原因是排查时只探测了常见猜测的 selector 名称，实际使用的 selector 是 cf-bounce，该反馈已记录在案。
9. 其他补充
同仓库内另有 cloudflare、agents-sdk、durable-objects、wrangler、sandbox-sdk、web-perf、turnstile-spin 等十余个子技能覆盖 Cloudflare 开发的不同侧面，与本技能形成互补的工具箱；仓库不设版本号升级机制，改动直接体现在提交历史中。
10. 安装使用方式
方式一：Claude Code 插件市场（推荐）
/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare该命令会连带安装同仓库全部 Cloudflare 技能，包括 cloudflare-email-service。
方式二：npx skills 通用安装器
npx skills add cloudflare/skills --skill cloudflare-email-service方式三：手动复制
克隆仓库后，将 skills/cloudflare-email-service 文件夹复制到对应 Agent 的技能目录（如 Claude Code 的 ~/.claude/skills/、OpenAI Codex 的 ~/.codex/skills/）。
安装后无需重启；技能基于 SKILL.md 的 description 字段自动匹配触发，当对话涉及发送邮件、Email Routing、SPF/DKIM/DMARC 配置等话题时会被自动加载，无需手动调用。
11. 注意事项
该技能仅覆盖 Cloudflare Email Service 本身用法，不含账号注册、域名 DNS 接入等前置环境搭建；发信到任意收件人（而非仅限已验证地址）需要 Workers 付费方案；仓库 README 技能汇总表尚未同步收录本条目，但不影响插件市场安装与实际触发；排查 DKIM 时注意实际 selector 名为 cf-bounce，勿仅凭猜测值判断“未配置”；OpenClaw、Hermes Agent 暂无官方兼容性声明。