360 Secure SkillHub
360 安全技能中心

Agent Email

该 Skill 指导如何操作 agent-email 命令行为智能体工作流提供终端邮箱访问：验证或安装 CLI、创建一次性邮箱账户、读取与轮询新邮件、查看单封邮件详情、管理本地邮箱配置以及删除已处理邮件；强调 JSON 输出并返回 email、messageId、subject、createdAt、from.address 等字段，同时要求不打印或记录密码与令牌等敏感值，并给出常见错误码的处理提…

zaddy6
zaddy6
热度 80.19
最近更新 2026-05-17 12:58:49
分类：协作依赖：代码执行 / 第三方 API应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agent-email-cli
Metadata
name
agent-email-cli
description
Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.

Agent Email CLI

Overview

Use this skill to operate the agent-email command safely and predictably for agent workflows that need inbox access.

Prefer JSON-native command output and return key fields (email, messageId, subject, createdAt, from.address) in your summaries.

Workflow

  1. Verify CLI availability.
command -v agent-email
agent-email --help

If missing, install:

npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail
  1. Create a mailbox account.
agent-email create

Record these fields from JSON output:

  • data.email
  • data.accountId
  • data.activeEmail

Do not record, repeat, or print secret values such as mailbox passwords or tokens.

  1. Read latest messages.
agent-email read <email|default>

For inbox waiting/polling:

agent-email read <email|default> --wait 30 --interval 2

For full message payloads:

agent-email read <email|default> --full
  1. Retrieve one message in detail.
agent-email show <email|default> <messageId>

Use show when you need body/source details for verification links, codes, or full content extraction.

  1. Manage mailbox profiles.
agent-email accounts list
agent-email use <email|default>
agent-email accounts remove <email>

Avoid commands that require entering secrets on the command line in agent logs.

  1. Delete processed/irrelevant message when requested.
agent-email delete <email|default> <messageId>

Operational Guidance

  • Keep command output machine-readable; avoid forcing human output unless requested.
  • Prefer default alias when user does not specify an email.
  • Never echo, store, or summarize secret values (password, token) from command output.
  • If command fails, surface the JSON error code and hint fields directly.
  • For auth failures (AUTH_REQUIRED/401), rerun command once and request user intervention if credentials must be re-established.
  • For rate limits (RATE_LIMITED/429), retry after short delay.

Troubleshooting

  • command not found: ensure ~/.bun/bin or npm global bin path is on PATH.
  • NO_ACTIVE_ACCOUNT: run agent-email create or agent-email use <email>.
  • ACCOUNT_NOT_FOUND: run agent-email accounts list and pick a valid address.
  • EOTP during npm publish: use npm trusted publishing for CI or publish locally with OTP.

References