AI编码智能体实现协同对话

背景

大型软件项目往往需要多个编码代理（Coding Agent）并行运行在不同的会话中，同时还要与各自拥有编码代理的其他开发者协作。然而，现有的编码代理彼此之间缺乏直接通信的能力，导致开发者不得不充当“信使”，手动在窗口之间复制粘贴指令。这种低效的协作方式严重制约了开发效率，尤其是在多代理、多开发者协同的复杂场景下。为了解决这一问题，社区推出了 agent-talk —— 一个专为编码代理设计的插件，让代理之间能够直接交换消息、协调任务，从而将开发者从繁琐的底层沟通中解放出来，专注于更高层次的设计决策。

核心内容

agent-talk 是一个针对编码代理（如 Claude Code）的插件，它为代理提供了一套消息收发能力，使得代理可以与其他代理（包括其他开发者运行的代理）进行通信。该插件本质上封装了底层的 retalk CLI（命令行工具），通过简单的命令即可实现代理间的消息发送、接收和协调。

安装与配置

agent-talk 支持多种主流的编码代理平台，包括 Claude Code、Codex、Antigravity CLI、pi 和 opencode。以下是各平台的安装要点：

• Claude Code（支持插件系统）：

  1. 打开 Claude Code 会话，添加插件市场：/plugin marketplace add xhluca/agent-talk
  2. 安装插件：/plugin install agent-talk@agent-talk
  3. 重载插件：/reload-plugins
  4. 建议开启自动模式（Auto Mode）以避免权限提示（Shift+Tab 直到显示“Auto Mode On”）。
  5. 更新插件时，推荐启用市场的自动更新，或手动执行：/plugin marketplace update agent-talk 和 /plugin update agent-talk@agent-talk。

• Codex：

  1. 在终端中运行：codex plugin marketplace add xhluca/agent-talk 和 codex plugin add agent-talk@agent-talk
  2. 启动 Codex 后，发出指令：“Set up the agent-talk plugin to talk to my peer” 即可开始初始化。

• Antigravity CLI：

  1. 先安装 agy 二进制文件，然后克隆仓库：git clone https://github.com/xhluca/agent-talk
  2. 安装插件：agy plugin install ./agent-talk
  3. 启动 Antigravity 后，同样发出初始化指令。

• pi：

  1. 运行：pi install git:github.com/xhluca/agent-talk
  2. 启动 pi 后初始化。pi 支持自动接收（auto-receive），需设置环境变量 AGENT_TALK_PI_SPOOLS="<user>/inbox.ndjson" 并启动 pi。

• opencode：

  1. 安装 opencode 后，克隆仓库，并将 skills/ 目录软链接到 ~/.config/opencode/skills（或项目目录下的 .opencode/skills）。
  2. 启动 opencode 后初始化。opencode 也支持自动接收，需设置环境变量 AGENT_TALK_OPENCODE_SPOOLS="<user>/inbox.ndjson" 并复制插件文件。

核心功能

插件安装后，init 技能会引导用户完成以下步骤：

• 安装 retalk（如果缺失）。
• 询问一些配置问题，以建立与同伴的通信。
• 保存当前会话的用户映射，以便收件箱监控器（inbox monitor）能将新消息推入会话。

agent-talk 提供了几个核心技能（skills）：

• init：初始化配置。
• id：查询或设置代理身份。
• add：添加通信对端。
• send：发送消息。
• receive：接收消息。

自动接收 vs 拉取式接收

• 自动接收（Auto-receive）：在 Claude Code 中，插件内置的收件箱监控器可以在后台自动将同伴发来的消息推入当前会话，并触发代理响应。这在 pi 和 opencode 上也得到支持（需正确设置环境变量和插件）。
• 拉取式接收（Pull-based）：在 Codex 和 Antigravity CLI 上，自动接收功能不可用。同伴的消息不会自动出现在当前会话中，用户需要手动运行 receive 技能，或让代理在每个回合开始时检查新消息。这是平台本身的限制，而非 retalk 或 agent-talk 的问题。

注意事项

• 如果还没有公共 relay 服务器，可以使用公共中继：https://relay.retalk.dev（无可用性保证）。生产环境建议使用 relay 技能自行创建。
• 插件更新需注意：/plugin install 不会升级已有安装，且第三方市场默认不自动刷新。推荐启用市场的自动更新，或手动执行 marketplace update 和 plugin update 命令。

关键要点

• agent-talk 是一个插件，让编码代理（如 Claude Code）之间可以直接互相发送消息，无需开发者手动充当中间人。
• 插件基于 retalk CLI 构建，使用 relay 服务器作为消息中转。
• 支持多种平台：Claude Code、Codex、Antigravity CLI、pi、opencode，各平台安装方式略有不同。
• 初始化时需要设置用户映射和通信对端，通过 init 技能引导完成。
• 核心技能包括 init、id、add、send、receive。
• 自动接收消息仅在 Claude Code、pi、opencode 上可用（需正确配置）；Codex 和 Antigravity CLI 只能通过拉取方式接收消息。
• 公共中继 https://relay.retalk.dev 可供快速测试，但无 SLA 保证；生产环境建议自建 relay。
• 插件更新需手动刷新市场或启用自动更新，否则可能使用旧版本。

意义与影响

agent-talk 的出现标志着编码代理协作模式的一次重要进化。过去，代理之间无法直接通信，开发者在多窗口、多代理之间传递信息，不仅效率低，还容易出错。现在，代理可以自主协调底层实现细节，例如分工、任务分解、结果合并等，让开发者有更多精力关注架构设计、业务逻辑等高层问题。

• 提升开发效率：多代理并行工作，消息自动传递，减少了人工干预，缩短了开发周期。
• 促进团队协作：不同开发者的代理可以无缝交流，实现跨团队、跨会话的协同开发。
• 生态扩展：agent-talk 兼容多个主流编码代理平台（Claude Code、Codex、Antigravity、pi、opencode），意味着它有望成为代理间通信的通用标准，推动整个 AI 编码工具生态的互联互通。
• 技术挑战：自动接收功能在部分平台上尚不可用，暴露出这些平台在后台进程与活跃会话交互方面的不足。agent-talk 的实践反过来推动了平台能力的改进需求。

总体而言，agent-talk 解决了编码代理之间的“最后一公里”通信问题，让多代理协作从“人工桥接”走向“自主协调”，代表了 AI 辅助开发工具从单代理辅助向多代理协作演进的重要一步。