Agent Mailbox Light

为本地AI工作区提供轻量级、跨会话的临时协调邮箱。

开发流程 协调多智能体同步项目上下文优化Token消耗 claudetraecursor通用 ★ 782 更新于 2026-08-02

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Agent Mailbox Light。
它的用途是:为本地AI工作区提供轻量级、跨会话的临时协调邮箱。
完整的 Skill 内容见:https://321skill.com/skills/agent-mailbox-light/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“检查一下我们项目工作区的邮箱,看看有没有来自‘监控’工作区的新警告。”,它会定位到当前工作区的`.agent-mailbox/inbox/`目录,读取最新的邮件文件,将关键内容(例如“服务器CPU使用率持续过高”)摘要后反馈给你,并将该邮件移入`keep`或`archive`文件夹。或者,你可以让AI发送邮件:“给所有匹配‘workspace-backup-*’模式的工作区发送一条优先级为‘warn’的邮件,标题是‘备份任务延迟’,内容是‘今日凌晨的数据库备份任务未按时完成,请检查日志。’”。

介绍

这个Skill解决了多个AI工作区之间需要临时、低噪音协调,但又不想将信息写入长期记忆的问题。在实际开发中,开发者经常需要在不同的智能体或工作区之间传递提示、警告或临时上下文,例如一个工作区发现系统异常需要通知另一个工作区,但又希望这些信息在任务结束后自动归档,避免污染核心记忆。

使用方式很简单,你只需要在发送方工作区运行脚本,它会根据配置的路径模式扫描其他工作区,并将邮件文件写入目标工作区的.agent-mailbox/inbox/目录。接收方工作区在启动或任务入口时,会自动检查其inbox目录,读取最新的几封邮件,将有用的邮件移至keep文件夹,将处理完的邮件归档至archive文件夹。整个过程基于本地文件系统,无需网络或中央服务。

它非常适合需要协调多个独立AI工作区(如不同项目或不同智能体)的开发者或团队。尤其是那些已经使用OpenClaw等框架,需要在工作区之间传递临时性、提示性信息,但又希望严格控制Token消耗、避免将所有交互都固化为长期记忆的场景。

建议在构建多智能体协作基线或需要在不同工作会话间保留临时上下文时统一使用此工具。需要注意的是,它主要提供尽力而为(best-effort)的投递,不保证送达、没有推送通知,也不适合用作任务执行总线或命令系统,邮件内容应被视为供本地智能体判断的参考建议。

常见问题

邮件投递失败怎么办?

该邮箱采用尽力而为(best-effort)模型,如果目标工作区路径不存在或写入失败,发送方会直接跳过,不会重试或报错。请确保MAILBOX_GLOB模式配置正确且目标路径可写。

邮件会占用大量Token吗?

不会。设计上鼓励接收方只读取最新的1-3封邮件,并将内容压缩成简短摘要。邮件文件本身存储在本地,只有被读取的部分会进入AI的上下文,从而有效控制Token消耗。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/agent-mailbox-light/raw/index.md 读取 Agent Mailbox Light 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。