命令行工具
Untrivial-ai/agent-orchestrator avatar
Untrivial-ai/agent-orchestrator

Agent Orchestrator:把一群编码代理变成一支受控的团队

Agent IDE 使您能够管理编码代理组。它配备了一个代理协调器,可以规划任务、生成代理并自动处理 CI 修复、合并冲突和代码审查。 AO 提供了围绕它们的工具:隔离的工作空间、实时终端访问、会话状态、PR 感知以及将 CI 失败、审查评论和合并冲突发送回正确代理的自动循环。

12,018 个 Star1,649 个 ForkGoApache-2.0

秒懂

它是什么?
Agent Orchestrator(AO)是一个本地桌面工作区,用看板、工作树和反馈回路管理多个编码代理。它适合需要并行处理多个任务、又不想让上下文互相污染的团队,但它的编排层尚不成熟,值得先验证。
适合谁用?
Agent Orchestrator 适合那些已经在用多个编码代理、但苦于分支冲突和上下文丢失的团队。它把每个任务隔离在独立 worktree 中,用看板汇总 CI 和审查状态,确实解决了并行开发的痛点。
能商用吗?
可以。Apache-2.0 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库最近一次提交在 1 天前。
用什么语言写的?
主要是 Go(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月14日)和我们的分析,不构成法律意见。

开源项目深度解析

一个代理是工具,一群代理是问题

单个编码代理可以完成一个任务。但当你同时运行五个代理时,真正的问题不再是写代码,而是如何分配任务、避免分支冲突、以及把 CI 失败和审查意见送回正确的代理。Agent Orchestrator(简称 AO)就是为这个场景设计的。它是一个本地桌面应用,把仓库、代理、分支、PR、CI 和审查状态全部绑定到一个会话里。README 里反复强调一个概念:每个任务都有自己的代理、工作区和反馈回路。这不是一个 IDE 插件,而是一个独立的监督层。

Worker 是执行单元,Orchestrator 是规划层

AO 的核心抽象是 worker。一个 worker 对应一个任务、一个代理、一个隔离的工作区。你可以用 New task 直接创建 worker,也可以让项目编排器(orchestrator)来规划。编排器是一个持久化的规划代理,它拥有项目级的对话历史,能结合仓库上下文和当前活跃的 worker 状态来制定计划。当计划可行时,编排器会把计划拆成具体任务,生成或重定向 worker,并把相关上下文传给它们。关键的分工是:编排器负责规划和委派,worker 负责实现、测试、提交和 PR。这个分层避免了把所有上下文塞进一个共享对话的混乱。

看板不是装饰,是状态机

AO 的看板不是手动拖拽的任务列表。每个 worker 的卡片位置由会话、PR、CI 和审查状态自动推导。Working 表示代理正在实现,Needs you 表示阻塞或需要输入,In review 表示等待检查,Ready to merge 表示已批准。这个设计把看板变成了项目的实时操作视图。你不需要打开多个终端和浏览器标签页来跟踪进度,看板上的状态就是事实。但要注意,这个状态完全依赖 AO 对 CI 和审查事件的识别能力,如果你的 CI 系统不在支持范围内,看板就会失真。

隔离是硬性的,反馈是闭环的

每个 Git 支持的 worker 都有自己的分支和 worktree,Scratch worker 则使用 AO 管理的无分支目录。这种隔离是硬性的,意味着并行任务不会互相踩踏。反馈回路是 AO 的另一个核心特性:CI 失败、审查评论、合并冲突都会自动送回给对应的代理。你可以在 worker 的会话中继续对话,也可以附加到它的终端,或者查看它的浏览器预览。这个闭环让代理能持续迭代,而不是在每次失败后由人工重新解释上下文。但这也意味着你需要信任 AO 对事件的理解,如果它误判了某个 CI 状态,反馈就可能送错地方。

安装与启动:从 nightly 到稳定版的距离

README 提供了下载链接和文档地址,但没有给出具体的安装命令。从仓库的 releases 页面可以看到,最近的版本都是 nightly 构建,比如 v0.12.10-nightly.202608290454。这暗示项目处于快速迭代阶段,稳定版可能还没有发布。你需要在 aoagents.dev 的文档中找到安装步骤。作为 Go 项目,理论上你可以从源码构建,但 README 没有提供 go install 指令。如果你不想追 nightly,可能需要等待官方发布稳定版。

支持的代理:26 个,但兼容性需要验证

README 声称支持 26 个编码代理,并列举了 Claude Code 作为例子,但列表被截断了。这意味着你常用的代理可能不在其中。即使代理被支持,AO 对代理的控制深度也因代理而异。README 提到可以使用结构化 Chat 或代理的原生终端界面,这说明 AO 并不接管代理的内部逻辑,而是提供外部监督。如果你的代理有特殊的配置或认证方式,可能需要额外适配。在采用前,务必检查完整列表,并测试你的代理是否能被 AO 正确识别。

局限与替代:编排器仍像任务分解器

AO 的编排器目前看起来更像一个任务分解工具,而不是一个真正的项目管理平台。它能把模糊目标变成具体任务,但跨仓库的复杂依赖、多阶段发布计划、或者跨团队协调,可能超出了它的范围。另外,AO 依赖 Git 工作流,如果你的项目不使用 Git,它的隔离机制就退化为无分支目录,反馈回路也会失去 PR 和 CI 的支撑。替代方案是直接使用每个代理自带的编排功能,比如 Claude Code 的 subagent 机制,或者用 GitHub Actions 来协调多个代理。区别在于,AO 提供了一个统一的看板和反馈回路,而原生方案需要你自己拼装。

维护成本与许可证

项目采用 Apache-2.0 许可证,这意味着你可以自由使用、修改和分发,甚至用于商业用途,只要保留版权声明。但 nightly 版本的频繁更新(每天多个版本)暗示 API 和配置文件可能不稳定。你需要定期更新以获取修复,但也要承担破坏性变更的风险。文档地址是 aoagents.dev/docs,但 README 没有描述升级路径或配置迁移指南。在投入生产前,建议先在一个非关键仓库上试用,并记录当前版本的行为,以便在升级时对比。

编辑结论

Agent Orchestrator 适合那些已经在用多个编码代理、但苦于分支冲突和上下文丢失的团队。它把每个任务隔离在独立 worktree 中,用看板汇总 CI 和审查状态,确实解决了并行开发的痛点。但如果你只有一个代理、或者你的工作流不依赖 Git,它的编排能力就派不上用场。在采用之前,先验证三件事:你常用的代理是否在支持的 26 个列表中,你的 CI 系统能否被 AO 正确识别,以及 nightly 版本的更新频率是否会影响你的稳定性。如果你需要的是跨仓库的复杂依赖规划,AO 的编排器目前还只是任务分解工具,不是完整的项目管理平台。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记