用途
setup-lumail 是一个用于连接用户 Lumail 账户的技能,目的是让智能体能够添加订阅者、发送登录验证码以及构建邮件工作流。它支持 macOS、Linux 和 Windows,通过浏览器完成账户连接。
主要能力
- 为智能体安装 Lumail 连接,包括 Lumail 登录、MCP 与相关技能。
- 通过浏览器完成账户认证,无需用户手动粘贴 API 密钥。
- 验证连接是否成功,并列出可用命令。
- 不在此阶段创建发送域名;当应用需要发送邮件时,由 create-* 技能通过 lumail domain 添加。
使用方式
- 确认 Node 可用(node --version,需 v20 或更高);若不可用,先运行 setup-node 技能。Lumail 通过 npx 运行,无需安装其他内容。
- 如果 npx -y lumail@latest auth test 已经成功,直接跳到第 5 步。
- 如果用户没有 Lumail 账户,引导其前往 https://lumail.io 并等待用户回复“done”。
- 在后台运行 npx -y lumail@latest setup --authenticate,并将输出写入文件。该命令会为智能体安装 Lumail 连接并打开浏览器:告知用户登录、批准,并回复“done”。如果没有打开浏览器,从输出文件中读取链接并提供给用户。持续检查 npx -y lumail@latest auth test 直到成功。
- 验证:npx -y lumail@latest auth test 成功,且 npx -y lumail@latest --help 列出命令。
- 最后以简短检查清单结束,每行用对勾或叉号标注:Node 可用、已登录 Lumail、已为智能体安装连接。然后用一句话告知用户,智能体现在可以从其应用中添加订阅者和发送邮件。
如果该技能是通过链接而非本地文件夹获取的,不要从仓库安装其他内容:仅在某个步骤需要时,使用 curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/setup-lumail/<path> -o <scratch>/<file> 获取文件,并且仅当到达该步骤时,才从 https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md 读取其提到的其他技能。
适用场景
适用于需要让智能体接入 Lumail 账户以管理订阅者、发送登录验证码或构建邮件工作流的场景,支持 macOS、Linux 和 Windows。
限制
- 需要 Node v20 或更高版本。
- 需要用户拥有 Lumail 账户;若无账户,需先前往 https://lumail.io 创建。
- 认证过程需要用户在浏览器中登录并批准。
- 不在此技能中创建发送域名。
- 与用户交流时应使用其语言、简短消息、避免术语(不要对用户说“CLI”“MCP”或“OAuth”),且绝不要求用户在聊天中粘贴 API 密钥。