Agent Messaging Skill

概述

Agent Messaging Skill 是 AI Maestro（23blocks 开源、MIT 许可的多 Agent 编排面板）所用的 agent-messaging Skill。它实现了 Agent Messaging Protocol（AMP），让 Agent 之间像发邮件一样通信：发送、查收件箱、阅读、回复、下载附件，消息带 Ed25519 签名。Skill 源码仓库是 agentmessaging/claude-plugin（Apache-2.0），任何能执行 shell 命令的 AI Agent 都能使用。它用于 Agent 与 Agent 之间的通信，而不是给人发消息。

核心功能

• 每个 Agent 独立身份：amp-init.sh --auto 创建带独立密钥和消息存储的身份；上下文重置后应先运行 amp-identity.sh，让 Agent 重新确认「我是谁」。
• 本地与外部地址：alice 会展开为 alice@<your-org>.aimaestro.local；通过 amp-register.sh 注册外部提供商后，可使用 alice@acme.crabmail.ai 这类地址。
• 丰富的消息：优先级（如 urgent）、消息类型（如 request）、JSON 上下文和文件附件。
• 多 Agent 场景：命令支持 --id <uuid>，也可从 AMP_DIR、CLAUDE_AGENT_ID、CLAUDE_AGENT_NAME 或 tmux 会话自动解析。

快速上手

# Claude Code 插件
git clone https://github.com/agentmessaging/claude-plugin.git ~/.claude/plugins/agent-messaging
# 或通过 skills.sh 安装到任意 Agent
npx skills add agentmessaging/claude-plugin

amp-init.sh --auto
amp-send.sh alice "Hello" "How are you?"
amp-send.sh backend "Build log" "See attached" --attach build.log --priority urgent
amp-inbox.sh
amp-read.sh <message-id>
amp-reply.sh <message-id> "Done, deployed to staging"

需要 curl、jq、openssl、base64，支持 macOS 和 Linux。

无人值守时的配置要点

Claude Code 在执行未加入白名单的 Bash 命令前会请求批准，因此在后台处理收件箱的 Agent 会卡在没人看到的确认框上。Skill 文档给出了需要加入 permissions.allow 的条目（amp-inbox.sh、amp-read.sh、amp-reply.sh、amp-send.sh 等），并刻意让修改身份的命令和 amp-delete.sh 仍需确认。

适用场景

• 前端 Agent 向后端 Agent 询问 API 变更。
• 在不同机器上的 Agent 之间移交任务，并附带上下文和文件。
• 在 AI Maestro 中把 Slack、Discord、邮件、WhatsApp 网关的消息转入 Agent 收件箱。

局限

• 只有运行多个 Agent 时才有意义；跨服务联邦需要提供商账号。
• 无人值守使用需要在每台机器上配置命令白名单。

常见问题

只能配合 Claude 使用吗？

不是。它是一组 POSIX bash 脚本，任何能执行 shell 命令的 Agent 都能用。

替代方案

• A2A Protocol：开放的 Agent 间通信协议。
• CrewAI：在同一个框架内协调多个 Agent，而不是跨独立会话。

相关 Skill

其他 AI Maestro Skill：Memory Search、Docs Search、Graph Query。更多内容见 Skills 分类 与 AI Agent 标签。