关于 resend-cli
resend-cli 是使用官方维护的 Resend CLI 执行邮件操作的技能，面向邮件运维与自动化。它涵盖命令发现、结果验证，以及对变更和重试的谨慎处理。
主要功能
- 01发现命令并查看帮助
- 02发送单封及批量邮件
- 03管理模板和营销活动
- 04检查域名、收件与自动化
- 05验证结果并安全处理重试
适用场景
- 01发送事务邮件并跟踪其 ID
- 02提交批量邮件并核对返回 ID
- 03配置营销活动受众并查看状态
- 04排查投递结果或域名设置状态
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/resend-cli确认已加载。
附带文件evals/scenarios.jsonreferences/OPERATIONS.md
详细介绍
Resend CLI 操作
直接使用维护中的 CLI。其 commands 输出取代旧版重复的命令目录、任务路由器和 Python 封装。保留针对具体任务的意图和验证要求，不要复制每个过时的标志。
发现并确定范围
resend --version
resend --json commands
resend emails send --help
resend --json -q doctor
doctor 可以检查账户；它并非纯离线的版本检查。如果已有获授权的连接器可用，请改用该连接器作为执行入口。不要仅为进行只读检查而安装、登录、更改配置文件或扩大凭据权限。检查生效的账户、配置文件和令牌权限范围，但不要打印密钥。优先使用密钥存储中的环境变量值或已保存的配置文件，而不是在参数中使用 --api-key。记录所用的 CLI 版本和帮助信息。
对于有界自动化，请传入所有必需参数、--json -q，并分别捕获 stdout、stderr 和退出状态。当前机器输出中，成功时 JSON 写入 stdout，错误写入 stderr；也可能出现警告。必须同时满足退出状态为零且结果有效、符合预期。流式监听器并非有界 JSON 命令。不要拼接输出通道，并将结果当作单个 JSON 文档。若标志或输出格式不同时，请检查已安装版本的帮助信息。
选择操作
| 意图 | 入口 | 验证 |
|---|---|---|
| 发送一封事务性邮件 | emails send | 保存 ID；稍后检查投递结果 |
| 发送多封不同的事务性邮件 | emails batch | 固定负载、映射返回的 ID、核对失败项 |
| 托管内容 | templates 和 emails send --template | 已发布版本、变量、发件人默认值 |
| 营销活动 | broadcasts、segments、topics | 精确的受众和同意状态、预览、发送状态 |
| 发件人／收件设置 | domains | 返回的 DNS 记录和已验证的能力 |
| 已接收邮件 | emails receiving | 验证事件后获取完整内容／附件 |
| 事件驱动的邮件序列 | automations、events | 已禁用的草稿、经批准的启用操作、运行结果 |
| 凭据／事件投递设置 | api-keys、webhooks | 最小权限、密钥存储、测试投递 |
具体标志以 resend commands 和子命令帮助信息为准，而非此路由表。不要仅因为缓存的目录中缺少某项操作，就断定该操作不受支持。只有确认 CLI 存在相关缺口后，才使用 API／SDK。
发送托管模板
当前的 emails send 支持 --template 和 --var。仅为发送托管模板而改用 REST 并无必要。
resend --json -q emails send \
--template "$TEMPLATE_ID" --to [email protected] \
--var CUSTOMER_NAME=Taylor --idempotency-key "$SEND_KEY" --dry-run
先确认实际已发布的模板及其变量定义。如果模板中未定义发件人／主题，请提供这些内容；并验证覆盖值。当前 CLI 的 --var 值为字符串：需要数值类型的变量时，请使用适当的类型化 SDK／API 负载。不要将模板与原始正文标志一起使用；经检查的 CLI 也会拒绝模板与附件同时使用。CLI 的限制不一定意味着每种 API 入口都有相同限制。
试运行只会验证本地输入，不会验证模板是否存在、是否已发布、权限、收件人授权或投递。请检查其负载；只有在发送已获授权时才移除 --dry-run，并保留相同的内容和操作标识。
变更与重试规范
发送前，请确认实际收件人、账户、内容、附件、发送计划／时区和范围。起草或预览不代表获准发送。发送广播或触发自定义事件可能会将消息分发给许多收件人。
在提交邮件／批次之前，先保存唯一的幂等键和确切请求。仅在提供方记录的有效期限内（目前为 24 小时），使用该键重试同一操作。新内容属于新操作。超过有效期限后，应进行核对，而不是重放；不要将邮件的幂等性保证扩展到其他端点。超时可能意味着请求已被接受但尚未确认，并不代表未发送。
特定命令支持原生 --dry-run（目前包括发送邮件和创建广播），但并非所有变更操作都支持。请检查帮助信息；切勿通过发起实时调用来模拟预览。对于不支持预览的操作，请在本地呈现预期载荷和收件人，不要调用变更操作。
请阅读操作检查，了解批处理、域名、订阅、接收、流和 Automations。报告 ID、已确认状态、未知结果以及下一步所需证据。已接受不等于已送达，记录为已送达也不能证明邮件进入收件箱或已被人阅读。
来源与评估
于 2026-09-13 对照官方 CLI、发送源码和 API 文档进行审核。评估用例：evals/scenarios.json。这些用例需要审查 Agent 执行轨迹；其存在并不意味着可以访问实时账户或发送消息。