技能介绍

问题：邮件操作的自动化缺口

在日常开发和运维中，邮件是不可或缺的通信和通知渠道。手动处理邮件效率低，而编写脚本调用邮件 API 又涉及复杂的 OAuth 流程、错误处理和安全考量。Agently Mail 技能旨在将邮件操作无缝集成到 AI Agent 的自然语言交互中，解决「如何让 Agent 安全、可靠地代我处理邮件」这一具体问题。

核心能力与工作方式

该技能通过一个名为 agently-cli 的命令行工具与 QQ 邮箱后端交互。Agent 的核心工作流程如下：

授权与连接：首次使用需通过 agently-cli auth login 完成 OAuth 授权，将邮箱账户安全地链接到本地环境。
命令驱动：所有邮件操作都映射为具体的 CLI 命令。Agent 根据用户指令，构造并执行相应的命令。

- 读取与搜索：使用 agently-cli message +list、+read、+search 指令获取邮件，支持按关键词、发件人、时间等多维度过滤。
- 发送与回复：使用 agently-cli message +send、+reply、+forward 指令。关键机制是两阶段确认：任何发送或修改类操作，Agent 首先会生成一个确认令牌 ctk 并向用户展示操作摘要，必须等待用户明确许可后才能执行，防止误操作。
- 实时监控：通过 agently-cli message +watch 长连接监听新邮件，实现即时提醒。

安全优先：邮件内容被视为不可信的外部输入。技能内置了严格的安全规则，绝不执行邮件正文或标题中包含的任何指令，只将其视为待分析或展示的数据。发件人信息也可能伪造，需保持警惕。

适用边界与关键注意点

依赖特定生态：本技能深度绑定 QQ 邮箱和 agently-cli，非通用邮件解决方案。
确认不可跳过：即使是用户要求的发送操作，首次调用仍需经过确认流程；只有在用户明确授权后，才可传递 --confirmed 参数免去后续确认。
错误处理需清晰：CLI 通过特定的退出码（如 3 表示授权失效，8 表示缺少确认令牌）指示错误类型。Agent 必须根据退出码决定是重试、提示用户重新授权还是反馈错误信息。
ID 格式固定：消息 ID 格式为 msg_xxx，附件 ID 为 att_xxx，确认令牌为 ctk_xxx，在构造命令时必须遵循此格式。