让两个 Codex 会话协作而不重复执行

彼此独立的 Agent 会话并不知道其他会话领取了什么、完成了什么。缺少共享记录时,两个 Agent 可能同时开始同一个 Task,也可能看不到上游结果,甚至在会话关闭后把工作丢在半路。Kairos 用一个共享队列和明确的 Task 负责人解决这些问题。

从发现工作到提交结果

shared WorkItem → find work → claim Task → heartbeat → submit result

Agent 先找到可执行的工作,领取一个 Task,在执行期间定期续租,最后提交结果。Claim 会阻止其他 Agent 重复领取同一个 Task;结果会保留在工作记录中,不会随着聊天会话结束而消失。

Codex、Claude Code 和其他能够调用 Kairos 工具的 MCP 客户端都使用同一套过程。Kairos 不运行模型,也不提供沙箱;它只负责让这些执行环境围绕同一份工作保持同步。

试用并行示例

在安装 Go 1.26.11 或更高版本、Node.js 22.22.2+(22.x)、24.15.0+(24.x)或 26+、npm 和 curl 的代码检出目录中运行:

make quickstart

打开 http://127.0.0.1:8080,你会看到两个可以立即开始的 Review Task。只有两份 Review 都有结果后,最后的汇总 Task 才会出现。

为每个 Agent 会话设置不同的身份:

KAIROS_ACTOR_ID=quickstart-agent-1 \
KAIROS_ACTOR_KIND=agent \
KAIROS_ACTOR_ROLE=contributor \
codex

在每个会话中,让 Agent 使用仓库 Skill:

Use $kairos-agent to find and complete one available Task.

两个会话会看到同一个 WorkItem。它们可以分别领取不同的 Task,但不能抢走对方已经领取的工作。两个并行 Task 完成后,汇总 Task 会自动开放,并直接带上两份上游结果。

哪些信息会保持同步

接入细节请参阅 API 参考;完整的 Agent 执行过程请参阅 Agent 交互模型。

Trusted HTTP/MCP 的 Actor ID 去除首尾空白后不得为空,也不能等于 . 或 ..。传输层在工具派发前拒绝非法身份头;修正 ID 后再重试。Authenticated MCP 从凭据解析 Actor ID,不接受工具参数覆盖。