Maestro 是一个多智能体开发编排平台，可在 Gemini CLI、Claude Code、Codex 和 Qwen Code 上运行。它包含 39 个专家智能体、并行子智能体、持久会话状态，并提供独立的审查、调试、安全、性能、SEO、无障碍与合规入口点。平台从统一的 src/ 源码树生成各运行时的文件，因此四种运行时共享同一套编排逻辑。
主要能力方面，Maestro 提供 Express 与 Standard 两种工作流。Express 用于简单任务：提出 1 至 2 个澄清问题，给出简要方案，委派给一个专家智能体，运行代码审查并归档，不需要设计文档或实施计划。Standard 用于中等和复杂任务，按设计、计划、执行、完成四个阶段运行，设有明确的审批门、分阶段执行，并在最终评审中阻断未解决的 Critical 或 Major 发现。
使用方式上，用户需选择一个受支持的运行时：Gemini CLI、Claude Code、Codex 或 Qwen Code。MCP 服务器和辅助脚本需要 Node.js 20 及以上。Gemini CLI 和 Qwen Code 需在 ~/.gemini/settings.json 或 ~/.qwen/settings.json 中启用实验性 subagents，Maestro 不会代为修改这两个配置文件。启动完整编排使用运行时对应的入口命令，例如 Gemini/Qwen 的 /maestro:orchestrate、独立审查的 /maestro:review、安全审计的 /maestro:security-audit。在 Claude Code 和 Codex 中，为避免与宿主内置命令冲突，使用 /review-code、/debug-workflow、/resume-session，在 Codex 中则使用 $maestro:review-code、$maestro:debug-workflow、$maestro:resume-session。
输出与成功标准方面，Maestro 将编排输出写入 MAESTRO_STATE_DIR，通常为 docs/maestro/。Standard 工作流的输出包括活动会话状态、设计文档、实施计划、阶段报告、验证输出和归档记录。成功运行需满足：使用 Standard 工作流时计划已获批准、阶段报告完成、变更面有验证结果、且没有未解决的 Critical 或 Major 评审发现。若某个阶段无法完成，Maestro 会记录阻塞点和下一步所需操作，而不是静默继续。
安全与权限方面，Maestro 遵循宿主运行时的工具权限、沙箱和确认模型，不要求提交密钥或长期凭证，编排会话状态保持在 MAESTRO_STATE_DIR 内（除非另行配置）。可用 MAESTRO_DISABLED_AGENTS 在敏感仓库中限制专家智能体，并在采纳涉及认证、授权、密钥或数据暴露路径的变更前运行安全审计命令。
开发与发布方面，规范源码位于 src/ 下，agents/、commands/、hooks/、mcp/、policies/、claude/、plugins/maestro/、qwen/ 中的运行时文件为生成产物，应先更新 src/ 再重新生成。发布验证会生成 dist/release/maestro-vX.Y.Z-extension.tar.gz。稳定版本发布三个对齐产物：npm 包 @josstei/maestro@X.Y.Z、GitHub Release 资产 maestro-vX.Y.Z-extension.tar.gz，以及通过对应 npm 包版本启动 MCP 服务器的 Codex 插件。MCP 服务器、Node.js 版本、工作流细节及各运行时文档（docs/runtime-gemini.md、docs/runtime-claude.md、docs/runtime-codex.md、docs/runtime-qwen.md 等）在仓库中提供。
