ao-orchestrator Skill 技能

ao-orchestrator（别名 agent-orchestrator）是一款面向运行中编码 Agent 的生命周期编排工具。它的核心理念是"指向你已经在跑的 Agent，从那里接手"——不需要新建 harness，不需要重启会话，直接挂载到现有 Agent 上，监控其状态、在其卡住时重启、验证其工作质量、决定什么可以提交。

技能简介

大多数 Agent 编排工具自己拥有 Agent 的生命周期：启动进程、驱动循环，采用它意味着把工作迁移到它内部重启。ao-orchestrator 反其道而行：它拥有的是权限——什么完成了、什么质量合格、什么可以落地——而让 Agent 留在原地不动。这意味着采用 ao 不需要改变现有的工作流，也不需要重启进行中的任务。

核心能力

• 挂载到运行中 Agent：通过读取 Agent 自身的 session store 发现并接管，不需要重新启动 Agent
• Watch 面板：实时显示 Agent 在做什么、上下文和消耗成本、open reviews、工作看板，以及"忙碌但不产出"的检测
• 自动重启：在 turn 结束时检测 Agent 是否卡住，自动 nudge（带多层 guard 保护）
• 验证门禁：运行你声明的门禁命令，记录结果，不依赖 Agent 自己的报告
• 提交决策：基于通过的门禁和批准的 review 决定是否可以提交，每个拒绝都明确命名缺失条件
• 多 Agent 支持：支持 kiro、claude-code、antigravity（full）、opencode、command-code（partial）、cursor-agent（documented）等
• MCP / A2A 接口：ao mcp serve 和 ao a2a serve 将状态暴露给 MCP 客户端或其他 Agent
• 零依赖设计：不依赖 Python 以外的东西，可以监视它并不控制的机器上的 Agent

安装配置

方式一：pip 安装

pip install ao-orchestrator
# 或
uv tool install ao-orchestrator

然后添加别名到 shell 配置：

echo 'alias ao="$HOME/.local/bin/ao"' >> ~/.zshrc && exec zsh

方式二：零依赖（无需安装）

git clone https://github.com/hakkisagdic/agent-orchestrator ~/ao
echo 'alias ao="$HOME/ao/bin/ao"' >> ~/.zshrc && exec zsh

Windows 用户使用 PowerShell 脚本 bin/ao.ps1（status、board、doctor 子集）。

使用步骤

1. 安装并配置别名（如上）

2. 进入项目目录，查看状态：

   cd ~/your-project && ao status

   ao 自动发现运行中的 Agent session。

3. 启动 Watch 面板：

   ao watch

4. 运行验证门禁：

   ao verify
   # 或完整验证
   ao verify -p full

5. 检查是否可以提交：

   ao commit-ok

6. 查看多项目总览：

   ao fleet
   # 或
   ao watch --all

适用场景

• 长时间运行的 Agent 监控：让 Agent 在你睡觉时继续工作，ao 负责看门
• 多 Agent 协作协调：多个 Agent 在同一代码库上工作时，ao 统一管理提交权限
• 质量门禁自动化：不依赖 Agent 自我报告，用实际命令重新运行验证
• Session 恢复：Agent 崩溃或断开后，ao 从 ledger 恢复上下文继续工作
• 并行 Agent 管理：fan-out 多个子 Agent 时统一协调和成本追踪
• 人机协作：Agent 需要人工决策时自动park，优先处理可自动化的任务

适用人群

• 重度 AI 编码用户：长时间运行 Claude Code 等 Agent 的工程师
• 平台工程师：构建多 Agent 协作系统的技术负责人
• 技术管理者：关注 Agent 使用成本和工作质量的团队负责人
• DevOps 工程师：需要将 Agent 编排接入现有 CI/CD 流程的工程师

工作原理

ao 通过适配器读取目标 Agent 的 session store（不同 Agent 的 session 存储位置和格式不同，适配器负责统一抽象）。Watch dog 比较文件 mtime 和 git 状态检测 Agent 是否卡住，nudge 机制带有五层 guard（无运行中 turn 时才 nudge、不在 provider 宕机时 nudge、不超过轮次预算等）。验证门禁运行用户声明的实际命令并记录结果，基于证据而非 Agent 自我报告做出提交决策。所有状态和决策记录写入 ledger 文件，支持崩溃恢复和历史追溯。

官方链接

• PyPI：https://pypi.org/project/ao-orchestrator/
• GitHub：https://github.com/hakkisagdic/agent-orchestrator
• 文档：docs/protocol.md、docs/safety.md、docs/roles.md、docs/slices.md、docs/gates.md 等