ACO — Agent 协作调度中枢

你有 5 个 Agent，谁来决定哪个干什么？

Agent 越来越多，协作越来越乱。任务派给了不该接的人，开发 Agent 自己审自己的代码，某个 Agent 卡死了半小时没人发现，主会话被一个耗时任务堵住、用户消息进不来。你盯着终端手动串联每一步，调度规则写在文档里，模型一长上下文就忘了。

ACO 把多 Agent 协作的调度治理收拢成一套代码级强制执行的框架。派发准入、角色约束、超时熔断、失败重派、自动推进——全部可编程、可追溯、可观测。

核心优势

派错了直接拦住 每个任务经 LLM 语义分类，只有对应角色的 Agent 才能接。PM 写需求，开发写代码，审计做审查。派错了不靠模型自觉，代码级阻断。

开发审计物理隔离 开发 Agent 写完代码，自动触发独立审计 Agent 复查。开发和审计永远是两个人，代码级强制，杜绝自己给自己打分。

卡死了秒级发现 Agent 超时自动熔断，5 分钟无输出即告警，僵尸进程自动回收。任务失败后自动升级梯队重派，不原样重试。

主会话永远畅通 耗时任务全部派给子 Agent，主会话只做秒级调度决策。用户消息永远不会因为 Agent 忙碌而被丢弃。

声明式任务链 定义「开发→审计→测试→发布」的推进链，上一步完成自动触发下一步。失败即时重派，不等同批任务回收。

全链路可审计 每个派发决策带时间戳、规则 ID、拦截原因写入日志。出了问题秒级定位，不用翻聊天记录猜发生了什么。

快速开始

npm install -g @self-evolving-harness/aco
npx aco init

init 自动检测环境、发现现有 Agent、生成配置。初始化完成后，ACO 作为 OpenClaw Gateway 插件自动运行——dispatch-guard 拦截违规派发，run-watchdog 监控超时熔断，无需手动操作。

CLI 命令

aco init          # 初始化项目（生成配置文件 + 数据目录）
aco dispatch      # 派发任务到 Agent（通过宿主适配器）
aco task          # 任务管理（查看/取消/重试）
aco board         # 任务看板（实时状态聚合视图）
aco pool          # Agent 池管理（查看/同步状态）
aco rule          # 调度规则管理（查看/启用/禁用）
aco chain         # 任务链管理
aco stats         # 资源利用率统计
aco audit         # 决策溯源查询
aco config        # 配置管理
aco notify        # 通知管理
aco health        # 健康检查

每个命令支持 --help 查看详细用法。

工作方式

ACO 的核心价值不是 CLI 工具箱，而是安装即生效的治理框架：

1. aco init 生成配置文件（aco.config.json）
2. Gateway 加载 ACO 插件，自动激活以下治理能力：
   • dispatch-guard：每次任务派发前校验角色准入、梯队路由
   • run-watchdog：监控 Agent 执行超时、僵尸进程回收
   • audit-logger：记录所有派发决策到审计日志
   • chain-engine：推进链自动触发下一步

你不需要手动执行命令——治理规则在 Agent 协作过程中自动强制执行。

使用场景

多 Agent 研发流水线 3 个以上 Agent 分工协作（开发→审计→测试→发布），需要统一调度、角色约束、故障自愈。ACO 管住谁干什么、什么时候干、失败了怎么办。

单人 + 多 Agent 做产品 你是产品操盘手，Agent 是执行团队。ACO 帮你管住派发纪律——任务不会派错人，卡死了自动处理，完成了自动通知你。

单 Agent 也有用 只有一个 Agent 也能获得超时保护、失败重试和状态通知。随时扩展到多 Agent，调度规则无缝升级。

Agent 梯队体系

编码 Agent 分四级，按任务复杂度和空闲状态自动路由：

| 梯队 | 定位 | 失败后 | |------|------|--------| | T1 | 主力编码，高并发 | 自动升级到 T2 | | T2 | 中等任务，备选 | 自动升级到 T3 | | T3 | 复杂任务，深度推理 | 自动升级到 T4 | | T4 | 兜底，轻量任务 | 告警人工介入 |

非编码角色独立管理：架构师、PM、审计、UX、调研，各司其职。

渐进式解锁

ACO 按 Agent 数量自动解锁功能：

• 1 个 Agent：超时保护、失败重试、状态通知
• 2-5 个：角色约束、梯队路由、开发审计分离
• 5+ 个：并发控制、负载均衡、全链路审计、推进链编排

零配置启动，规模大了自动解锁更多治理能力。

编程接口

import { createScheduler } from '@self-evolving-harness/aco';

const scheduler = createScheduler({ configPath: './aco.config.json' });
await scheduler.dispatch({ label: 'code-review', prompt: '...' });

也可作为 Gateway 插件直接加载（推荐方式）。

文档

• 产品需求规格
• 架构设计

License

MIT