企业官网建设流程全解析

CompozyOS多Agent协作实战：如何让Claude Code、Codex与Gemini CLI分工交接任务

【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy

CompozyOS 是一个 AI Agent 操作系统：把你已经在用的 Agent CLI（Claude Code、Codex、Gemini CLI、Cursor 等 ACP 兼容命令行工具）接进同一个守护进程，让它们组成一支团队——拆分工作、互相交接任务、按定时和循环自动执行，并共享同一份项目记忆，而你可以全程在浏览器里监督。本文面向新手，带你快速搭起多 Agent 协作环境，并走通"分工 → 交接 → 验收"的完整链路。

为什么单人单 Agent 不够用？

只靠一个 Agent 干活，你会遇到三个典型痛点：

• 上下文窗口有限：一个长任务做到一半，早期信息就被"挤出"了窗口；
• 能力单一：写代码强的和擅长审查的往往不是同一个模型；
• 状态易丢：关掉终端标签页，任务上下文就没了。

多 Agent 协作的思路是：按岗位分工（实现、审查、运维各用一个 Agent），用持久化状态交接（任务描述、产出物、运行历史落盘，而不是靠对话窗口传递），用统一记忆同步上下文。CompozyOS 把这三件事做成了内置能力，无需自己写胶水脚本。

快速上手：安装 CompozyOS 并启动守护进程

CompozyOS 是一个 Go 编写的单二进制 + SQLite 的本地优先系统，安装后由一个后台 daemon（守护进程）持有全部会话、任务与记忆状态——这是"工作不会随终端关闭而消失"的关键。

git clone https://gitcode.com/gh_mirrors/co/compozy cd compozy go build -o ./bin/compozy .

或者使用验证安装脚本（macOS / Linux）：

curl -fsSL https://compozy.com/install.sh | sh

启动 daemon 并创建第一个持久会话：

compozy daemon start compozy session new --agent general --name first-run

完成后打开浏览器，就能看到 Web 控制台（也就是文章开头那张截图的界面），所有 Agent 的活动都在这里实时可见。更完整的安装说明见 README.md。

给每个 Agent CLI 定义一个"岗位"

在 CompozyOS 里，Agent 是可复用的定义对象，而不是每次手敲命令。每个 Agent 定义放在~/.compozy/agents/<name>/（全局）或工作区.compozy/agents/<name>/（工作区覆盖全局）下，核心是一个AGENT.md文件，声明它的身份、使用的 provider、继承的权限和对外宣称的能力。

内置 provider 目录已包含claude、Codex、gemini等常用命令行工具（详见 providers.mdx），所以让 Claude Code 和 Codex 就位只需在定义里选择对应的 provider ID。一个典型的分工示例：

Agent 定义的完整格式（发现顺序、运行时默认值）可参考 definitions.mdx。

任务分工：用 Task 把工作拆给不同 Agent

分工的核心是Task（任务对象）。与临时对话不同，任务在 daemon 里有明确的所有者、运行历史和重试记录，这正是交接的基础。

compozy task create --scope workspace --workspace project --title "Review the release change" compozy task start <task-id> -o json compozy task run list <task-id> -o json

在任务配置中选择 worker（执行者）与 reviewer（审查者）Agent，即可让 Claude Code 负责实现、Codex 负责审查；如果启用了工作区 coordinator（协调者），它还能把大目标拆解成多个跟进任务并自动派发。

交接任务：Claude Code 做完，Codex 接着干

多 Agent 交接最容易踩的坑是"靠聊天记录传递上下文"。CompozyOS 的官方用法（见 handoff-between-agents.mdx）是：把交接所需的一切写进任务描述里，让下一个 Agent 直接读取落盘状态：

1. 写清交接单：在任务描述中写明期望结果、相关文件、已完成的工作、以及剩余待检查项；
2. 保留交接证据：记录任务 ID、运行 ID、会话 ID、检查过的文件、产出的工件和验证结果；
3. 审查与续跑：需要把关的任务走审查门（review gate），被拒的运行可以带着持久化的改进建议产生续跑，通过则记录被接受的结果。

这样交接不依赖任何一个 Agent 的对话窗口——Codex 接手时读的是持久化上下文，而不是"刚才 Claude Code 说的那段话"。

共享项目记忆：新 Agent 秒懂上下文

Agent 团队里还有一个隐形基础设施：工作流记忆（Workflow Memory）。它是守护进程持有的、按作用域隔离的持久记忆——Agent 可以像人一样通过同一套公开契约检查、提出和整合记忆。这意味着：

• Codex 接手时，不必重新"探索"项目约定，直接读取既有记忆；
• 一个 Agent 踩过的坑、做过的决定，其他 Agent 也能看到；
• 记忆属于 daemon，关闭任何客户端都不会丢失。

自动化：让 Agent 团队无人值守地跑

分工和交接打通后，可以让团队按时自动开工：

• Cron 定时：按计划触发任务，例如每晚跑一次 Codex 审查；
• Webhook / 触发器：外部事件（如代码推送）直接唤醒对应 Agent；
• Loops（循环）：把"检查 → 执行 → 报告"固化为可复用的循环对象，而不是每次重写脚本。

所有自动化都运行在同一个 daemon 状态上，你在浏览器里随时可以看到"什么在跑、什么在等你审批、什么已完成"。

常见问题 FAQ

Q：一定要同时装三个 CLI 吗？不需要。装一个也能用；多 CLI 的价值在于按岗位分工与互相审查。CompozyOS 运行的是 ACP 兼容的 Agent CLI 和适配器。

Q：交接会不会丢失之前的对话？不会依赖对话。交接走任务描述 + 运行历史 + 共享记忆这些持久化对象，会话本身也是持久对象，可随时回看完整历史。

Q：多 Agent 并行会不会互相踩代码？工作区和任务都有明确的归属与租约（claim/lease）机制，所有权与完成判定以任务服务为准，避免"两个 Agent 同时改同一处"的混乱。

Q：状态存在哪里？数据安全吗？本地优先：一个 Go 二进制 + SQLite 存储，运行时状态默认留在你自己的机器上。

小结

CompozyOS 多 Agent 协作的落地路径可以概括为四步：

1. 装：一键安装并启动 daemon，浏览器即可监督；
2. 定义岗位：用AGENT.md给 Claude Code、Codex、Gemini CLI 分别指定实现、审查、运维职责；
3. 拆分任务：用 Task 对象派发工作，配好 worker 与 reviewer；
4. 持久化交接：交接单写进任务描述，证据落在运行历史，上下文同步进共享记忆。

Agent 们从此是一个能分工、能交接、能自动运转的团队，而你只需要在浏览器里掌舵。

【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy