Agent Mail 是一个用于多智能体协作的项目本地消息系统，采用 Maildir 实现，为协同工作的 AI 智能体提供类似电子邮件的语义。它主要用于多个 AI 智能体以串联模式（tandem mode）一起工作的场景，例如 Claude 与 Gemini 配合，或多个 Claude 实例并行。
主要用途与适用场景：官方资料列出应在以下情况调用该技能：与其他 AI 智能体以串联模式协作时；会话开始时需要检查伙伴发来的消息；认领任务并需要通知其他智能体；完成工作并需要汇报交接；遇阻并需要紧急通知伙伴；需要跨终端协调或同步工作。
前置条件：需检查 agent-mail 是否已初始化，即项目根目录是否存在 .agent-mail/ 目录。若未初始化，则执行初始化命令：npx tsx ~/Projects/leegonzales/agent-mail/src/mail.ts init
核心流程（资料中标为强制 MANDATORY）：
- 会话开始：在任何工作之前，先加入并检查收件箱，命令为 agent-mail join claude 与 agent-mail check claude；若有未读消息，执行 agent-mail read claude，在处理完所有消息后再继续。
- 认领工作前：在开始任何任务前通知伙伴，例如 agent-mail broadcast claude "Claiming Task" "Claiming IE-XX. Starting now."。
- 完成工作后：立即汇报完成，例如 agent-mail broadcast claude "Task Complete" "IE-XX complete. Output at: path/to/result"。
- 遇阻时：以高优先级通知，例如 agent-mail send claude gemini "BLOCKED" "IE-XX blocked: reason" --priority high。
- 周期性检查：对于超过 5 分钟的长任务，例如 agent-mail broadcast claude "Status Update" "Still on IE-XX. 60% complete."。
消息类型：资料给出主题与用途对应关系，包括 Claiming Task（宣布正在认领任务）、Task Complete（工作完成，可交接）、BLOCKED（无法继续，需要帮助）、Status Update（长任务进度）、Question（需要澄清）、Answer（回应提问）、Handoff（明确移交工作）、Sync Request（询问伙伴状态）。
快速参考命令： 项目相关：agent-mail init（在当前项目初始化）、agent-mail join claude（注册为智能体）、agent-mail who（查看活跃智能体）、agent-mail info（项目信息）。 消息相关：agent-mail check claude（查看收件箱，不标记）、agent-mail read claude（阅读并标记为已读）、agent-mail send claude gemini "Subject" "Body"、agent-mail broadcast claude "Subject" "Body"、agent-mail reply claude <id> "Body"、agent-mail status（所有收件箱）、agent-mail history claude 10（消息历史）。
与 beads 集成：当使用 beads 进行任务跟踪时，先在 beads 中认领再通知：bd update IE-XX --status in_progress --assignee Claude，随后 agent-mail broadcast claude "Claiming Task" "Claimed IE-XX in beads"；关闭时先在 beads 中关闭再通知：bd close IE-XX "Completed"，随后 agent-mail broadcast claude "Task Complete" "IE-XX closed"。
资源：完整对话示例见 references/examples.md。关于收费、平台支持范围等细节，资料暂未提供。