oma-orchestrator 是一个自动化多智能体协调器，用于把复杂请求拆解为任务，并行启动 CLI 子智能体，并通过内存协调、进度监控、验证、QA 交叉评审与重试来收集结果。
用途：当复杂功能需要多个专业智能体并行工作、用户希望自动执行而不手动逐个启动智能体，或需要进行跨后端、前端、移动端与 QA 的全栈实现时使用。简单单域任务应直接使用对应智能体；需要逐步手动控制时使用 oma-coordination；快速缺陷修复或小改动不适用。
主要能力与流程：先解析供应商路由与运行时派发路径，将请求分解为带优先级层级的任务，并按已安装技能的意图签名分入 domain_tags，计算每个任务的 exposed_skill_set（过小时回退为全量曝光并记录 exposure_fallback）。随后经历 PHASE 1 规划、PHASE 1.5 域门控、PHASE 2 初始化会话内存与任务板、PHASE 3 按优先级并行派发、PHASE 4 轮询监控、PHASE 4.5 验证，以及 PHASE 5 收集结果并生成摘要。
评审循环：智能体完成后先做机械自检（lint、类型检查、测试、diff 范围），再执行 oma verify {agent-type} --workspace {workspace} --json，通过后由 QA 智能体交叉评审；失败则把反馈回传实现智能体修正。自检修复最多 3 轮，交叉评审拒绝最多 2 次，总循环最多 5 次，超出则报告评审历史并给出质量警告。
必要用法：优先使用运行时原生派发路径，包括 Claude Code 的 claude --agent <agent>、Codex CLI 的 codex exec "@agent ..."、Gemini CLI 的 gemini -p "@agent ..."；不可用时回退到 oma agent:spawn <agent-type> "<task>" <session-id> -w <workspace>，验证使用 oma verify <agent-type> --workspace <workspace> --json。
配置与限制：默认 MAX_PARALLEL 为 3、MAX_RETRIES 为 2、POLL_INTERVAL 为 30s，实现类智能体 MAX_TURNS 为 20、评审类为 15、pm 为 10；不得超出配置的并行与重试限制。内存提供者与工具名可通过 mcp.json 的 memoryConfig 配置，例如 provider 为 serena、basePath 为 .serena/memories。还需 .agents/oma-config.yaml、.codex/agents/.toml、.gemini/agents/.md 等依赖。会派生进程、读写内存与结果文件，并可能通过智能体修改代码。会话中用户纠正会累计澄清债务，CD >= 50 需 QA 生成 RCA，CD >= 80 暂停会话请求重新定义需求，redo >= 2 触发范围锁定。其余细节暂未提供。