文档
介绍
MAESTRO-SSOT 是一个多智能体软件工程框架，其中专门的 LLM 智能体围绕共享结构化状态进行协作，而不是传递消息 —— 由自主控制循环协调，并由限制性执行沙盒保护。
共享状态优于消息传递
传统的多智能体系统（AutoGen、ChatDev）将协作视为消息传递：智能体在群组中聊天，然后尝试协调各自的输出。这会导致：
- 集成失败：智能体 A 假设智能体 B 实现了 X，但 B 从未实现
- 冗余通信：N 个智能体需要 O(N²) 的消息对
- 执行不透明：没有谁在何时更改了什么的审计记录
MAESTRO 用**单源真相（SSOT）**取代聊天 —— 一个 SQLite 支持的结构化存储，用于：
| 领域 | 用途 |
|---|---|
| 需求树 | 带依赖和状态的层级任务 |
| 契约注册表 | 智能体之间的 API 模式协议 |
| 执行日志 | 每个操作的不可变审计记录 |
| 智能体记忆 | 每个智能体的键值工作记忆 |
受保护的执行
每个智能体动作都经过 Harness 流水线：
智能体工具调用
│
▼
┌─────────────┐
│ ACL 检查 │ ← 文件路径允许/拒绝列表
│ (fnmatch) │
└──────┬──────┘
│
▼
┌─────────────┐
│ 验证器 │ ← 危险模式检测
│ (正则) │
└──────┬──────┘
│
▼
┌─────────────┐
│ 预算 │ ← Token/步数/时间限制
│ 追踪器 │
└──────┬──────┘
│
▼
┌─────────────┐
│ 沙盒 │ ← 子进程执行
│ (本地) │
└─────────────┘自主编排
Auto-Loop 是一个 LLM 驱动的控制器，观察完整的 SSOT 状态并动态决定下一步动作：
- 分解：将需求分解为子任务
- 分配：将任务匹配给最佳智能体
- 执行：在分配的任务上运行智能体
- 验证：验证契约、运行测试、审查代码
- 提交：快照成功状态
- 完成：所有工作完成后终止
何时使用 MAESTRO
MAESTRO 专为需要多个专业智能体的跨模块软件工程任务而设计：
- 后端 API + 前端 UI 协调
- 数据库模式 + 迁移 + 测试生成
- 多服务微服务与契约验证
- 跨多个文件的 Bug 修复
对于简单的单文件任务，单智能体方法可能更有效。
安装
一行命令安装
bash
curl -sSL https://raw.githubusercontent.com/HYPERVAPOR/maestro-ssot/main/scripts/install.sh | bash安装器会：
- 检查
uv、pipx或pip，使用最佳可用方法 - 安装
maestroCLI 工具 - 在
~/.maestro/config.toml创建全局配置
环境要求
- Python 3.12+
- macOS、Linux 或 WSL
验证安装
bash
maestro --version卸载
bash
curl -sSL https://raw.githubusercontent.com/HYPERVAPOR/maestro-ssot/main/scripts/install.sh | MAESTRO_UNINSTALL=1 bash手动安装（从源码）
bash
git clone https://github.com/HYPERVAPOR/maestro-ssot.git
cd maestro-ssot
uv sync
uv run maestro --version快速上手
即将推出...
配置
即将推出...
系统架构
即将推出...
SSOT Hub
即将推出...
Agent Harness
即将推出...
Auto-Loop
即将推出...
智能体
即将推出...
Contract-Bench
即将推出...
SWE-bench
即将推出...
API 参考
SSOTHub
即将推出...
Harness
即将推出...
AutoLoop
即将推出...
MaestroAgent
即将推出...