Maestro

项目定位#

Maestro 是一个跨 Gemini CLI、Claude Code、OpenAI Codex、Qwen Code 四种 AI 编码运行时的多智能体开发编排平台。它本身不包含 LLM 推理能力，必须依赖上述受支持的 CLI 作为底层执行引擎，定位在编排层，解决开发者使用不同 AI 编码助手时面临的工作流割裂与缺乏系统级多 Agent 协作的问题。

核心能力#

• 39 个专家 Agent：覆盖前端、后端、全栈、DevOps、安全、数据库、ML/AI、云架构、平台工程、SRE、可观测性、发布管理、移动端及遗留系统（COBOL、DB2、z/OS、HLASM、IBM i）等领域。
• 独立质量门控工具：提供 7 个可独立于编排流程直接调用的审查工具——review、debug、security-audit、perf-check、seo-audit、a11y-audit、compliance-check。
• MCP 服务能力：内置 17 个 MCP 工具包，提供会话管理、设计门控、阶段对账等底层能力。
• 会话持久化：会话归档于 docs/maestro/，支持 Resume、Status、Archive 操作，可中断后恢复长周期编排任务。

工作流模式#

• Express（快速路径）：简单任务 — 1-2 个澄清问题 → 简报 → 委派单个专家 → 代码审查 → 归档。
• Standard（标准路径）：中/复杂任务 — Design → Plan → Execute → Complete 四阶段，含显式审批门控，最终审查阻断未解决的 Critical/Major 发现。

架构设计#

采用 src-first, generated-runtime 架构：所有共享行为和内容在 src/ 下编写一次，通过 scripts/generate.js 生成器管道生成各运行时适配文件（Gemini CLI 的 TOML 命令、Claude Code 的 Markdown 技能、Codex 的插件技能、Qwen Code 的 Gemini CLI 兼容扩展）。

• 清单系统：src/manifest.js 声明源文件到运行时输出的映射规则，支持 glob 模式和变换管道。
• 6 个变换器：parse-frontmatter、extract-examples、rebuild-frontmatter、agent-stub、skill-discovery-stub、skill-metadata。
• 设计门控：服务端强制设计审批流程，MCP 工具 create_session 在设计未批准时拒绝创建会话。
• 入口点注册表：9 个入口点 + 3 个核心命令在 src/entry-points/ 中定义，生成到各运行时的命令/技能表面。
• 工程化：Node.js 内置测试运行器（node --test）及 c8 覆盖率工具；通过 scripts/install-git-hooks.js 安装 Git Hooks。

安装与使用#

运行时要求：Node.js ≥ 20，需安装任一支持的 AI CLI。

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

Qwen Code：

qwen extensions install https://github.com/josstei/maestro-orchestrate

Gemini CLI 和 Qwen Code 需在配置文件中启用实验性子 Agent：{"experimental": {"enableAgents": true}}

命令参考#

12 个入口命令：orchestrate（自动分类任务选工作流）、execute（跳过编排直接执行）、resume、status、archive、review、debug、security-audit、perf-check、seo-audit、a11y-audit、compliance-check。Claude Code/Gemini CLI/Qwen Code 使用 /maestro:<command> 格式；Codex 使用 $maestro:<command> 格式。