用途:Agent Mail 为多个明确协调的写作者提供协调通道,携带消息、确认、身份标识与临时文件预留。它本身不是任务追踪器、队列、证明账本或生命周期控制器,邮件不拥有追踪器状态。
主要能力:登记身份;按调用方给定的绝对项目路径预留或释放路径;发送、读取、确认指定线程;在 MCP 工具或 am CLI 两种界面间选择其一。预留为建议性质,只有所有协作写作者都对照同一绝对项目路径检查时才有效;不检查的写作者不受约束。
使用方式:仅在多个明确协调的写作者共享仓库时使用。固定一个存储根与一种访问模式(MCP/服务器或直接 CLI),切勿对同一活动数据库混用两者。登记调用方提供的身份,按给定绝对路径和有限 TTL 预留路径,冲突原样上报,发送一次消息并记录 id,仅读取或确认所请求线程。在调用方推进声明的转换前,核实该转换中所有需确认消息均已获得预期接收者确认。仅释放调用方明确要求释放的预留。
限制:单写作者场景应跳过。邮件沉默不能证明工作状态;消息或确认仅证明沟通发生,不证明变更正确或完整。预留不创建工作归属,也不影响计划、候选或裁决语义。不得自主选择工作、改动追踪器状态、提交代码、验证、集成、关闭、发布或交付。管理/灾难恢复模式(安装 git pre-commit 防护、doctor 修复、备份/恢复、清除并重置全部)仅限调用方明确授权;清除并重置会删除数据库与全部存储且不可撤销,未获显式授权不得运行。适配器不可用、预留冲突、邮箱所有权冲突、待确认缺失、超时或降级等情况应显式上报并停止,不得静默回退或绕过。CLI 语法须以 am mail --help、am file_reservations --help 等实际帮助为准,命令细节暂未提供。