OmX 高控制编排工作流全解析ralplan - team - ralph的定位、设计与仓库现状【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex本篇技术指南以 OmX 仓库中的 PR 草稿 dev-team-ralph-workflow-positioning.md 为骨架完整展开其核心命题为什么$team不只是并行 fanout而是协调、可检查、runtime 感知的执行模型以及ralplan - team - ralph如何构成一套既快又操作纪律严明的完整工作流。读者读完后将掌握三阶段工作流的职责边界、$team与$ultrawork的定位差异、后续规划follow-up planning的源码级设计方向并了解该工作流在当前仓库中已发生的版本演化ultrawork/ralph相继退役、omx team ralph弃用。一、工作流全景为什么team不只是 fanout原 PR 草稿的立论起点是一个经常被误解的问题当$ultrawork或如今的$team已经能提供并行执行时为什么还需要专门的 team 模式原文档给出的答案是team mode 不是简单的扇出fanout。它同时具备三个$ultrawork时代所不具备的工程属性协调Coordinatedworkers 之间可以共享阻塞感知blocker awareness可以早期暴露阻塞、重新分配工作而不是各干各的互不感知可检查Inspectable执行过程通过 tmux panes 可见同时叠加持久化状态durable state让现在团队在做什么随时可审计runtime 感知Runtime-awareleader 对恢复recovery和生命周期命令lifecycle commands拥有更强的控制权。把这三点与前置的ralplan共识规划和后置的ralph持久化 验证配对就得到一条既快又操作纪律严明fast and operationally disciplined的主路径ralplan - team - ralph这条工作流在仓库中的落地证据直接可见于 src/team/followup-planner.ts后续规划器明确定义了FollowupMode team | ralph并输出FollowupStaffingPlan含recommendedHeadcount、allocations、launchHints、verificationPlan也就是说规划产出直接导向 team 或 ralph 启动这一设计在源码层面已经成真。二、前置阶段ralplan共识规划ralplan是 OmX 的共识规划阶段作为$autopilot默认链$deep-interview - $ralplan - $ultragoal的中间环节见 README.md。从 skills/ralplan/SKILL.md 看它的核心不是写一个计划文件而是驱动Planner → Architect → Critic三个角色的顺序评审生命周期Planner产出右规模的实施计划与紧凑的 RALPLAN-DR 摘要原则、决策驱动、可行选项及取舍、唯一选项时的失效理由Architect评审架构合理性必须给出最强的 steelman 反题与至少一个真实取舍张力Critic按质量标准评估可返回APPROVE/ITERATE/REJECT非通过则进入最多 5 轮的全闭环重评审。原 PR 草稿将ralplan定位为team 后续规划应该变得更显式的地方并提出了具体的设计方向In future work,ralplancan emit lane recommendations, role placement hints, and launch guidance for a directteamhandoff, whileralphremains the persistence and verification layer.这个设计方向在仓库中已经有对应的落地痕迹。首先ralplan的执行入口是omx ralplan run --task arguments [--session id]其ralplan_execution_handoff记录{authorized: true, reason, authorized_at, session_id, review_cycle, source: autopilot|user}只有当该记录持久化后执行才被允许见 skills/ralplan/SKILL.md。其次ralplan的 Goal-Mode 后续建议明确把$team作为一等执行选项Keep$teamas a first-class execution option and keep$ralphavailable only as an explicit fallback where appropriate: use Ultragoal as the default durable goal-mode follow-up, Team for coordinated parallel implementation, and Ralph only for intentionally selected persistent single-owner completion/verification pressure.也就是说规划阶段就要产出 role/staffing 分配、按 lane 的 reasoning 建议、以及omx team的具体启动提示。三、核心阶段$team协调执行与 runtime 状态模型3.1 启动形态与前置条件按照 skills/team/SKILL.mdteam 的启动形态是omx team [N:agent-type] task $team [N:agent-type] task例如omx team 3:executor implement X。前置条件包括需要tmux -V、leader 会话运行在$TMUX中macOS/Linux 主路径Windows 仅psmux次路径推荐 WSL2启动前任务应落地到最近的.omx/context/{slug}-*.md上下文快照禁止嵌套启动 Team 运行worker CLI 可通过OMX_TEAM_WORKER_CLIcodex|claude|auto或OMX_TEAM_WORKER_CLI_MAP...指定每个 agent 的 reasoning 由agentReasoning控制合法值为low、medium、high、xhigh、maxultra不被支持。3.2 运行产物与状态权威启动后runtime 会创建.omx/state/team/name/下的config.json、manifest.v2.json、tasks/task-id.json、worker 身份/inbox、mailbox 文件与 dispatch 队列workers 通过环境变量OMX_TEAM_WORKER、OMX_TEAM_STATE_ROOT、OMX_TEAM_LEADER_CWD感知归属。关于状态归属docs/contracts/team-runtime-state-contract.md 明确了一份权威归属清单这正是可检查 runtime 感知的契约基础状态权威归属主要入口pending/notified/delivered/failedteam dispatch 请求状态dispatchstatus为权威时间戳只是佐证src/team/state/dispatch.ts、src/team/state.tsRust 侧见 crates/omx-runtime-core/src/dispatch.rsintegratedmonitor 快照integrationByWorkerworker 只有通过 leader-head 推进/收敛检查后才算integratedmailbox 投递和 tmux 活动都不充分src/team/runtime.ts、src/team/state/monitor.tsstale按边界拆分runtime authoritycrates/omx-runtime-core/src/lib.rs、leader activitysrc/team/leader-activity.ts、sessionsrc/hooks/session.ts不得仅凭 dispatch/integration 状态推断这套契约强调notify-hook观察到的 mailbox/tmux 证据是派生证据dispatch 成功必须通过 dispatch-request 状态转移表达——这正是协调执行、状态可检查与纯 fanout的本质差异。3.3 机器可读的操作接口team 提供 CLI API 供 leader 与 workers 以 JSON 方式交互见 skills/team/SKILL.mdomx team api send-message --input {team_name:name,from_worker:leader-fixed,to_worker:worker-1,body:short trigger} --json omx team api read-task --input {team_name:name,task_id:id} --json omx team api transition-task-status --input {team_name:name,task_id:id,from:in_progress,to:completed,claim_token:token} --json监控与收尾omx team status name --json omx team await name --timeout-ms 30000 --json omx team shutdown name只有pending0、in_progress0、failed0或明确承认的失败路径时才执行 shutdown且必须先验证 shutdown 证据与状态清理不能在 workers 仍在写入时就宣告完成。四、后置阶段ralph持久化 验证层含版本演化说明原 PR 草稿把ralph描述为persistence and verification layer在 team 执行完成后由一个 leader 或独立 worker 选择性地启动ralph作为独立的持久化回环持续施加直到证据支持的完成evidence-backed completion的压力让工作流保持诚实keep the workflow honest。需要特别说明的版本演化从当前仓库的实际状态看原 PR 草稿写作时的三条工作流组件已发生显著演化$ultrawork已在 OMX 0.21 中移除skills/ultrawork/SKILL.md 目前是 sunset stub明确写着$ultraworkwas removed in OMX 0.21; use$teaminstead理由正是原 PR 草稿的核心论点——并行执行是 team 的职责ultrawork 的纯提示词并行引擎在没有独立 runtime 的情况下制造了第二个权威。换句话说原文档team 不是 fanout的论证最终在版本演化中直接取代了 ultrawork。$ralph也已在 OMX 0.21 中移除skills/ralph/SKILL.md 同样是 sunset stub指明改用$ultragoal。Ralph 的loop-until-done行为被视为退化的单目标 ultragoal run由$ultragoal承接持久化 Codex goal 交接、.omx/ultragoalledger 检查点、实现/测试/构建/lint/typecheck 证据以及跨 story 恢复。omx team ralph ...的链接工作流已被弃用见 docs/prs/dev-deprecate-team-ralph.md。它移除了 team↔Ralph 的链接 runtime bridge、链接 notify-hook 终端同步、链接 cleanup/shutdown 策略、linked_ralph生命周期 profile 与omx team ralph ...启动提示让omx team ...成为唯一受支持的团队启动路径而omx ralph ...保留为独立、显式的后续动作。现在调用omx team ralph ...会得到明确的弃用错误而非被静默容忍。因此在阅读原 PR 草稿时ralplan - team - ralph应理解为设计方向与思想骨架在当前仓库0.21中等价的推荐落地形态是ralplan规划 →$team协调并行执行含自身验证 lane→ 需要持久化单目标完成回环时用$ultragoal或按需显式选择$ralph作为后备。原文档ralphremains the persistence and verification layer的职责如今由 team 自己的验证 lane 与ultragoal共同承接。五、$team与$ultrawork的定位差异从文档澄清到版本事实原 PR 草稿的Changes清单第一条就是clarify the positioning difference between$teamand$ultrawork。二者的差异可以总结为下表依据 skills/team/SKILL.md、skills/ultrawork/SKILL.md 与 README.md维度$team$ultrawork已移除定位协调执行coordinated execution纯提示词并行扇出worker 载体tmux worker panes无独立 runtime状态共享任务状态、mailbox/dispatch、monitor 快照无持久状态模型生命周期leader 拥有 shutdown/await/恢复控制无生命周期命令现状唯一受支持的团队启动路径OMX 0.21 起为 sunset stub迁移到$teamREADME 中也给出了当前推荐的分工README.md默认用$ultragoal作为持久完成包装只有当某个特定 story 需要协调并行时才在该执行路径内使用$team当想要单所有者的完成回环时用$ralph。这与原 PR 草稿帮助高级用户判断何时选 team 而非简单并行扇出的目标完全一致。六、设计方向让ralplan显式产出 team 后续规划原 PR 草稿提出的后续工作方向是让ralplan成为 team 后续规划的显式出口并附带一份 issue 草案docs/issues/team-ralph-followup-team.md。该 issue 提案ralplan支持--followup team这类显式后续模式其产出应包含五项内容常规实施计划与验收标准acceptance criteria推荐的 worker lanes / 角色分配recommended worker lanes / role allocation每条 lane 的建议 reasoning 级别suggested reasoning levels by lane面向omx team/$team的显式后续命令或启动提示explicit follow-up commands or launch hints匹配team - ralph执行路径的验证预期verification expectations。该 issue 同时记录了备选方案与取舍仅把模式写在文档里帮助发现性但用户仍需手工把计划翻译成 worker lanes或全部折叠进autopilot适合默认自动化但对想直接控制规划、人员配置与验证的用户太弱。从源码结构看这个设计方向已经部分实现。在 src/team/followup-planner.ts 中FollowupMode team | ralph是显式的后续模式枚举第 6 行buildLaunchHints会按模式生成可直接执行的启动命令第 172-190 行team 模式产出omx team N:role task/$team N:role taskralph 模式产出omx ralph task/$ralph taskteam 模式的验证计划明确delivery lanes 并行运行同时由专门的 verification lane 在 shutdown 前捕获新鲜证据第 193-203 行默认 headcount 计算也区分模式team 模式默认 2、ralph 模式默认 3第 280 行并且 team 模式使用team-exec交付 lane、ralph 模式使用team-verify主实现 lane第 284 行。这些实现细节印证了原 PR 草稿的判断planning output that already anticipates team staffing and follow-up execution是一条可信的设计方向。七、为什么这套工作流重要预期成果与适用场景原 PR 草稿列出的预期成果可以归纳为四点均与当前仓库的架构能力一一对应更好的 onboarding用户评估 OmX 编排模型时README 不只说存在 team mode而是说清为什么在已有并行能力时 team 仍重要更容易解释$team与$ultrawork的差异前者是协调 runtime 控制后者只是扇出从规划到执行的更清晰路径ralplan的产出直接包含 staffing 与 launch hints减少用户把计划手工翻译成 worker lanes 的摩擦对混合 CLI 团队与 runtime 边界场景的更好支持team runtime 已支持 worker roles、mixed CLIscodex/claude/auto、runtime state 与可检查的团队生命周期命令见 skills/team/SKILL.md 与 src/team/ 下的role-router.ts、allocation-policy.ts、rebalance-policy.ts、runtime-cli.ts等模块这类runtime 边界 编排边界的工作恰恰是持久协调比原始任务拆分更重要的场景。原 PR 草稿还点出一个附带收益这让autopilot也更容易解释——因为它可以描述为在同一底层工作流之上的一层自动链式封装an automatic chaining layer over the same underlying workflow。这正是 README.md 中$autopilot的官方定义$deep-interview - $ralplan - $ultragoal链式默认编排器而每个阶段在输入契约已满足时都可独立调用。八、验证与实操检查清单原 PR 草稿给出的验证方式针对的是文档类改动npm run build # TypeScript build npm test对于使用者验证自己的工作流环境推荐按 README 的 smoke 路径检查三条边界README.mdomx doctor codex login status omx exec --skip-git-repo-check -C . Reply with exactly OMX-EXEC-OKomx doctor检查 OMX 文件、hooks 与 runtime 前置真正冒烟测试则验证 auth、profile、provider/base-URL 等只有 Codex 实际发起请求才会暴露的问题。team 模式的平台前置是tmuxmacOSbrew install tmux、Debian/Ubuntusudo apt install tmux、Fedorasudo dnf install tmux、Archsudo pacman -S tmux原生 Windows 仅winget install psmux次路径推荐 WSL2见 README.md。九、结语从 PR 草稿到仓库演化的完整图景ralplan - team - ralph是 OmX 文档中最值得研究的一条高控制编排路径。它回答了一个本质问题当并行执行已经廉价时编排的价值来自协调、可检查性与 runtime 控制而不只是任务拆分。原 PR 草稿docs/prs/dev-team-ralph-workflow-positioning.md与其配套 issuedocs/issues/team-ralph-followup-team.md把这条路径的定位与设计方向固化进了文档而当前仓库的源码与版本演化src/team/followup-planner.ts 的双模式后续规划、ultrawork与ralph的退役、omx team ralph的显式弃用则进一步证明了team 是协调执行而非扇出不仅是一个叙事而是最终被代码与产品决策采纳的核心原则。对于评估 OmX 编排模型的读者这条工作流是理解其又快又稳设计哲学的最佳切入点。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考