用途：Multi-Agent Orchestrator 负责协调 codex（代码）与 Gemini（UI）两类智能体，按 Kiro spec 实现任务，并管理派发、评审与状态同步的整条编排循环。
主要能力：自动解析 spec 任务并生成 TASKS_PARSED.json、AGENT_STATE.json 与 PROJECT_PULSE.md；由 Codex 生成派发分配（owner_agent/target_window/criticality/writes/reads）；循环执行派发→评审→合并→同步，直到所有任务完成；按类型路由到对应后端（code→codex、ui→gemini、review→codex-review）；支持 dispatch unit（父任务打包子任务）以减少上下文切换，支持阻塞与修复循环，错误时给出处理策略。
必要用法：先获得用户显式确认才可启动。Codex CLI/IDE 用 /prompts:orchestrate SPEC_PATH=.kiro/specs/my-feature，Claude Code 用 /orchestrate .kiro/specs/my-feature。/opencode 单命令模式：python scripts/orchestration_loop.py --spec <spec_path> --workdir . --assign-backend codex。手动调试步骤：python scripts/init_orchestration.py <spec_path> --session roundtable --mode codex；再依次运行 dispatch_batch.py、dispatch_reviews.py、consolidate_reviews.py、sync_pulse.py（均传入 AGENT_STATE.json 等参数）。退出码：0 完成、1 中止/未完成、2 需人工输入。
适用场景：把 Kiro spec 中的前后端与评审任务自动分配给不同智能体并行推进的项目。限制：需具备 codeagent-wrapper（缺失时设 CODEAGENT_WRAPPER 或放入 ./bin/），tmux 报错时设 CODEAGENT_NO_TMUX=1；无 writes/reads 的任务串行执行；派发依赖 owner_agent 与 target_window，缺失会失败；具体收费、平台支持与效果暂未提供。