Agent Skills
返回列表
🤖

Agent 邮件 CLI

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/zaddy6-agent-email-skill。

技能介绍

要解决什么问题

自动化 Agent 常常需要收验证码、读通知或核对邮件正文,但把真实邮箱密码写进对话或日志里风险极高。agent-email 这类临时邮箱 CLI 能解决「程序化收件」,却容易在 Shell 输出里泄露 token、在 create 时把密钥复述给用户。本技能约束的是:在安全前提下,让 Agent 按固定流程调用 CLI,并把结果整理成可机读的摘要。

技能如何工作

核心是按 SKILL 里的六步工作流操作,而不是自己拼命令:

  • 环境与账号:先确认 agent-email 是否在 PATH(常见是 ~/.bun/bin 或 npm 全局路径);没有则安装。用 create 建邮箱后,只记录 JSON 里的 data.email、data.accountId、data.activeEmail,绝不记录或复述密码、token。
  • 读信与轮询:收件箱等待用列表类接口;需要完整载荷时用对应读信命令。摘要里优先带上 email、messageId、subject、createdAt、from.address。
  • 深挖单封邮件:需要验证码链接、激活码或全文抽取时,用 show 拉取 body/source 级细节。
  • 配置与清理:切换/管理邮箱配置时避免在命令行参数里塞密钥;用户要求时再删除已处理或无关邮件。

出错时直接透出 JSON 的 code 与 hint;AUTH_REQUIRED/401 可重试一次并提示用户重新鉴权;RATE_LIMITED/429 短延迟后重试。更细的命令与字段对照见 references/commands.md。

适用边界与注意点

  • 适合 Agent 编排场景(轮询临时邮箱、抽取验证内容),不替代企业邮件网关或合规审计方案。
  • 默认优先使用用户未指定地址时的 默认 alias,减少多账号误操作。
  • 除非用户明确要求,不要强制人类可读的表格输出;保持 JSON 原生 更利于下游步骤。
  • 常见问题:command not found 查 PATH;NO_ACTIVE_ACCOUNT 用 create 或 use;ACCOUNT_NOT_FOUND 先 accounts list 再选有效地址。

使用场景

  • 自动化注册流程中 Agent 需轮询临时收件箱,直到收到含验证码的邮件并解析主题与发件人
  • 集成测试在 CI 里创建 disposable 邮箱后,用 `show` 抽取邮件正文中的激活链接再做断言
  • 多步骤 Agent 在完成 OAuth 或第三方验证前,需读取最新邮件列表并对 `messageId` 做去重处理
  • 用户要求清理邮箱时,Agent 在确认邮件已处理后再执行删除,避免误删仍在等待中的验证信

适合人员

  • 负责搭建注册/登录自动化链路的平台工程师,需要 Agent 稳定读信且不在日志里泄露密钥
  • 编写端到端测试的 QA,希望在流水线里用 CLI 建邮箱并抓取验证邮件正文
  • 维护 Coding Agent 工作流的开发者,要把收件箱轮询纳入工具调用并统一 JSON 错误处理
  • 为内部 Agent 编写运维 Runbook 的 SRE,需对照 SKILL 处理 `NO_ACTIVE_ACCOUNT` 等常见故障