Maestro 编排平台
为 Gemini CLI、Claude Code、Codex 和 Qwen Code 提供多智能体开发编排：39 个专家、并行子代理、持久会话与内置审查、安全、SEO、无障碍和合规工具。
- Star 数
- ★ 485
- 最近更新
- 2 天前
- License
- Apache-2.0
- 主语言
- JavaScript
- FA 评分
- 75/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 全栈开发者用一条命令从零编排一个 REST API 的设计、实现和审查流程
- 不适合
- 只想用单一 CLI 的团队，需为四种运行时分别配置命令与设置
- 不愿手动编辑 settings.json 启用实验性子代理的用户
- 源码审查
- 75/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Maestro（josstei/maestro-orchestrate，Apache-2.0，v1.6.4）是一个多智能体开发编排平台，从单一的 src/ 源码树生成针对四种运行时的产物。它提供 39 个专家代理、面向简单任务的 Express 路径、面向中复杂任务的四阶段 Standard 工作流（设计、计划、执行、完成），以及独立的代码审查、调试、安全审计、性能检查、SEO、无障碍和合规入口。会话状态持久化在 MAESTRO_STATE_DIR（默认 docs/maestro/），失败会记录阻塞点而非静默继续。它通过宿主运行时的权限与确认模型执行，不要求提交任何密钥或长期凭据。
运行时入口命令（如 /maestro:orchestrate、$maestro:orchestrate、/orchestrate）接收任务描述后，Maestro 对任务分类，选择 Express 或 Standard 工作流，提出必要的设计问题，需要时生成实施计划，将执行委派给专家子代理，运行质量门，并把会话、计划、阶段报告和归档记录写入 docs/maestro/。Standard 工作流要求已批准的计划、完成的阶段报告，且最终审查不允许存在未解决的 Critical 或 Major 发现。独立命令包括 /maestro:review、/maestro:debug、/maestro:security-audit、/maestro:perf-check、/maestro:seo-audit、/maestro:a11y-audit 和 /maestro:compliance-check。Codex 运行时通过插件技能和 spawn_agent 提供 MCP 服务器支持；Qwen Code 使用 Gemini-CLI 兼容扩展并读取 QWEN.md。
- 全栈开发者用一条命令从零编排一个 REST API 的设计、实现和审查流程
- 团队在提交前对暂存更改运行 /maestro:review，检查正确性、回归、安全与缺失测试
- 安全工程师在改动认证、授权或密钥处理路径前运行 /maestro:security-audit
- 前端团队用 /maestro:a11y-audit 和 /maestro:seo-audit 做无障碍与 SEO 检查
- 需要切换 CLI 工具的开发者在 Gemini CLI、Claude Code、Codex、Qwen Code 间复用同一套编排流程
- 项目负责人用 /maestro:resume 和会话归档在中断后恢复和追溯多阶段工作
如何安装或部署这个 Agent？
前置条件：一个受支持的运行时（Gemini CLI、Claude Code、Codex 或 Qwen Code），Node.js 20+（用于 MCP 服务器和辅助脚本）；Gemini/Qwen 需在 ~/.gemini/settings.json 或 ~/.qwen/settings.json 中启用 experimental.enableAgents: true（Maestro 不会代为修改）。安装：Gemini CLI — gemini extensions install https://github.com/josstei/maestro-orchestrate；Claude Code — claude plugin marketplace add josstei/maestro-orchestrate 然后 claude plugin install maestro@maestro-orchestrator --scope user；Codex — codex plugin marketplace add josstei/maestro-orchestrate，启动 Codex 后运行 /plugins 选择 Maestro 安装；Qwen Code — qwen extensions install https://github.com/josstei/maestro-orchestrate。本地开发可 git clone 后使用 gemini extensions link . 或 qwen extensions link .，或 claude --plugin-dir /path/to/maestro-orchestrate/claude。
如何使用这个 Agent？
以 Gemini CLI/Qwen Code 为例：/maestro:orchestrate Build a REST API for a task management system with user authentication。Maestro 会分类任务、选择 Express 或 Standard 工作流、提出设计问题、委派专家执行并归档会话。独立用法：/maestro:review Review the staged changes for correctness, regressions, security, maintainability risk, and missing tests；/maestro:security-audit Audit authentication, authorization, data exposure, secret handling, and exploitability risks。可用环境变量调优：MAESTRO_STATE_DIR（默认 docs/maestro）、MAESTRO_EXECUTION_MODE（parallel/sequential/ask）、MAESTRO_AUTO_ARCHIVE、MAESTRO_MAX_RETRIES、MAESTRO_MAX_CONCURRENT、MAESTRO_DISABLED_AGENTS。用 /maestro:resume、/maestro:status、/maestro:archive 管理会话。
这个 Agent 有哪些优点和局限？
- 一份 src/ 源码树同时生成四种运行时（Gemini CLI、Claude Code、Codex、Qwen Code）的产物，避免多套维护
- 39 个专家代理加 Express/Standard 双工作流，简单任务不走重流程，复杂任务有显式审批门和质量门
- 会话状态持久化并可恢复（/maestro:resume、/maestro:archive），失败时记录阻塞点和下一步而非静默失败
- 内置安全审计、性能、SEO、无障碍和合规等独立入口，且对 Claude/Codex 刻意避开与宿主命令冲突的裸命令名
- Gemini CLI 和 Qwen Code 需手动启用实验性子代理功能（experimental.enableAgents），且不同运行时命令名不同，存在学习成本
- 生成产物由 src/ 驱动，直接改 agents/、commands/ 等目录会被重新生成覆盖，定制必须走 src/ 加 node scripts/generate.js 流程
- 宿主于第三方 CLI 工具，能力受这些工具本身成熟度和实验性特性限制
- 来源仅含 README，缺少第三方采用证据或独立评测
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Maestro 编排平台 当前 | 75 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 485 | 2 天前 | JavaScript | Codex · Claude Code |
| MCO | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 540 | 17 天前 | Python | Codex · Claude Code |
| Claude Code 子代理集合 | 48 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.7k | 1 年前 | — | Claude Code |
| Munder Difflin – 多智能体办公桌 | 43 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 9k | 2 天前 | TypeScript | ChatGPT · Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README明确声明遵循宿主运行时的权限与确认模型、不要求提交密钥、状态仅写入MAESTRO_STATE_DIR，集成测试还证明initialize_workspace会拒绝插件缓存路径；但这些都是声明加局部测试，未看到对并行子代理与hooks的全面权限审计，故最低权限、确认、数据流与敏感数据各扣1分记2分。依赖面极小（仅devDep c8），扣分点是无锁定依赖的供应链声明。外部效应：不代改用户settings.并明说，写盘范围有界，记2分；回滚仅有archive/resume，无显式撤销或恢复机制，记1分。来源归属仅package.中的自述作者信息，发布者未经验证，记1分。
CI中generator-check强制src与生成产物零漂移并跑完整测试套件，自洽性证据扎实，记3分。依赖几乎为零（Node内置test运行器），可用性风险极低，记3分。集成测试显示错误是结构化的、带端点顺序提示（如design_document不存在的NOT_FOUND错误同时指名两个端点），记3分。
README按四种运行时分别给出命令面、安装与配置表格，明确区分Express/Standard工作流适用场景，记3分。命令命名刻意避开宿主保留名（review/debug/resume）且有测试保障，触发精度记3分。环境适配覆盖四个运行时并分别有runtime文档，记3分。但39名专家的能力边界、限制条件在所给文件中基本未展开，capability_boundaries记2分。
文档结构清晰（overview/architecture/usage/flow/runtime-*），安装说明按运行时分步给出且含本地开发路径，目录架构（canonical src/ + 生成产物）有一致性CI保障，均记3分。命名稳定性有专门测试防止与宿主命令冲突，记3分。许可为完整Apache-2.0文本，记3分。EXAMPLES.md、CHANGELOG.md被引用与列入files但未在证据中出现，examples_and_faq与versioning_changelog各记2分。已知限制章节缺失，记1分。SECURITY.md给出支持版本与响应时间线但单人维护、无明确治理，maintenance_responsibility记2分。
输出路径、成功标准（审批计划、阶段报告、Critical/Major阻塞）写得具体可核，输出可用性记3分。多运行时编排加质量门确有差异化价值，但39专家与各类审计入口的实际增益仅由声明支撑，marginal_value与cost_benefit各记2分。
多数核心声明（生成器一致性、错误语义、命名避让、工作区拒绝）有对应测试可追溯，记2分。docs/EXAMPLES等被大量引用但内容未在证据中，跨源印证不足，记1分。声明与推断基本分开（如明确'不代改settings.'），记2分。
- 本次为静态评审，未执行任何安装或编排流程；39名专家与各审计入口的实际行为未经执行验证。
- EXAMPLES.md、CHANGELOG.md与各runtime文档被引用但未在证据文件中，采纳前请自行核对。
- 回滚仅有archive/resume路径，缺少对已变更代码的显式撤销机制，请配合版本控制使用。
- 并行子代理与hooks的权限面依赖宿主沙箱，敏感仓库请先设置MAESTRO_DISABLED_AGENTS并运行security-audit。
- 发布者身份未经企业注册表验证，属单一维护者项目，长期维护存在不确定性。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Added - Maestro cheatsheet: added an English quick-reference guide covering supported runtimes, common commands, workflow concepts, and suggested reading order. Changed - npm package identity: renamed the planned npm package to @josstei/maestro, added [email protected] to public author metadata, and moved the stable release publish path into GitHub Actions with npm token authentication. Fixed …在 GitHub 查看 ↗ -
发布说明摘录
Added - 5 new MCP tools (Session pack 5 → 10; total pack count 12 → 17): - enter_design_gate, record_design_approval, get_design_gate_status — server-side design-gate lifecycle; create_session now enforces approval before session creation - scan_phase_changes, reconcile_phase — post-hoc phase reconciliation when an agent's actual file manifest diverges from the plan - 17 additional specialist agents — Expanded the roster from 22 to 39 specialists: - ML / AI: ml-engineer, mlops-engineer, prompt-engineer …在 GitHub 查看 ↗ -
发布说明摘录
Added - Qwen Code runtime support (#26) — Fourth runtime target with hook adapter, extension manifest (qwen-extension.json), context file (QWEN.md), 22 agent stubs, and hooks.json for SubagentStart/SubagentStop lifecycle events - getExitCode(result) adapter contract (#42) — Each hook adapter now owns its exit code semantics; shared exit-codes.js constants (EXIT_SUCCESS, EXIT_BLOCK) verified against Gemini CLI, Claude Code, and Codex CLI source …在 GitHub 查看 ↗