claw-code 源码分析：OmX `$team` / `$ralph`——把 AI 辅助开发从偶发灵感变成可重复流水线

说明 ：OmX（oh-my-codex）、$team、$ralph 在 claw-code 中主要出现在 README 叙事与资源目录 ，是 外部编排工具 的概念名；仓库 并未 实现 OmX 本体。本文说明：官方如何描述它们，以及 同一哲学 在源码与仓库制度里如何落成 可重复、可验证 的流水线。

---

1. 官方定义：OmX 与两种模式在 README 中的角色

维护者将 Python 移植会话描述为在 oh-my-codex (OmX) 上端到端编排，并点名两种工作模式：

61:65:README.md
The whole thing was orchestrated end-to-end using [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) by [@bellman_ych](https://x.com/bellman_ych) --- a workflow layer built on top of OpenAI's Codex ([@OpenAIDevs](https://x.com/OpenAIDevs)). I used `$team` mode for parallel code review and `$ralph` mode for persistent execution loops with architect-level verification. The entire porting session --- from reading the original harness structure to producing a working Python tree with tests --- was driven through OmX orchestration.

The result is a clean-room Python rewrite that captures the architectural patterns of Claw Code's agent harness without copying any proprietary source. I'm now actively collaborating with [@bellman_ych](https://x.com/bellman_ych) --- the creator of OmX himself --- to push this further. The basic Python foundation is already in place and functional, but we're just getting started. **Stay tuned --- a much more capable version is on the way.**

The Rust port was developed with both [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) and [oh-my-opencode (OmO)](https://github.com/code-yeongyu/oh-my-openagent): OmX drove scaffolding, orchestration, and architecture direction, while OmO was used for later implementation acceleration and verification support.

文末再次归纳 模式语义（与洁净室、人工校验并列）：

194:199:README.md
Key workflow patterns used during the port:

- **`$team` mode:** coordinated parallel review and architectural feedback
- **`$ralph` mode:** persistent execution, verification, and completion discipline
- **Cleanroom passes:** naming/branding cleanup, QA, and release validation across the Rust workspace
- **Manual and live validation:** build, test, manual QA, and real API-path verification before publish

读法 ：$team 强调 并行、评审、架构反馈 ；$ralph 强调 持久执行环、验证、完工纪律 。二者都不是 claw-code 里的函数名，而是 人机协作节奏的标签 ；可重复性来自「节奏 + 验收标准」，而不是单次神提示词。

---

2. 仓库如何把「节奏」固化成流水线制品

2.1 验收门禁：unittest discover 与 CLI 子命令网

README 把验证路径写进 Quickstart，与 OmX 叙事同一文档内并列------谁 clone 都能复跑：

Run verification:

```bash
python3 -m unittest discover -s tests -v

这与 WorkspaceSetup.test_command（src/setup.py）一致，构成 与 IDE/Agent 无关 的硬门禁；对应分析见 result/26.md。
$ralph 的工程化对应物 ：不是「模型多聊几句」，而是 红绿可判定 的 check=True 子进程、parity-audit、bootstrap/turn-loop 等 可脚本化步骤。

2.2 并行评审与架构反馈：$team 在仓库内的「影子」

README 用 assets/omx/ 截图展示 分屏评审（caption 中直接出现 Ralph/team orchestration）：

### OmX workflow screenshots

![OmX workflow screenshot 1](assets/omx/omx-readme-review-1.png)

*Ralph/team orchestration view while the README and essay context were being reviewed in terminal panes.*

![OmX workflow screenshot 2](assets/omx/omx-readme-review-2.png)

*Split-pane review and verification flow during the final README wording pass.*

在 代码侧，「多视角对齐」更接近：

• parity-audit + reference_data/* ：把「像不像」从主观变成 比例与缺失列表 （src/parity_audit.py）。
• PARITY.md ：Rust/TS 表面只读对比的 长文评审记录 ，显式写 not feature-parity，避免口头并行评审后仍假装完成。

这些不依赖 OmX 运行，但承担 $team 所追求的「架构反馈可被引用」 之功能。

2.3 编排状态不进库：.omx 忽略与 diff 排除

根目录与 rust/.gitignore 均忽略 .omx/，暗示 OmX 本地状态 与 可发布源码 分离：

__pycache__/
archive/
.omx/
.clawd-agents/

claw 的 diff 报告对 git diff 排除 .omx，避免终端工作流垃圾污染「工作区是否干净」的判定：

// 2267:2270:rust/crates/claw-cli/src/main.rs
fn render_diff_report() -> Result<String, Box<dyn std::error::Error>> {
    let output = std::process::Command::new("git")
        .args(["diff", "--", ":(exclude).omx"])
        .current_dir(env::current_dir()?)

流水线哲学 ：易变、机密的编排缓存 留在本机；契约与快照 （tests/、reference_data/、文档）进 Git------重复跑的是后者。

---

3. 与产品内「多角色」的弱类比（非同一实现）

Rust Agent 工具按 subagent_type 划分工具白名单，例如 Explore / Plan / Verification （探索、规划、带 bash 的验证），与 $team（多视角）/$ralph（执行---验收闭环）在 隐喻上 同构，但是 运行时内置策略，不是 OmX：

// 1665:1701:rust/crates/tools/src/lib.rs
fn allowed_tools_for_subagent(subagent_type: &str) -> Vec<String> {
    let tools = match subagent_type {
        "Explore" => vec![
            "read_file",
            "glob_search",
            ...
        ],
        "Plan" => vec![
            ...
            "TodoWrite",
            ...
        ],
        "Verification" => vec![
            "bash",
            "read_file",
            ...
        ],

区分清楚：OmX 是开发 claw-code 时用的外壳 ；Subagent 类型是 claw-code 交付给用户的能力。二者都体现「别把智能体当成单轮聊天」，但层级不同。

---

4. 小结：从偶发灵感到流水线的翻译表

OmX 叙事中的概念	在 claw-code 仓库中的可触摸对应
OmX 编排层	外部工具；仓库用 README + 截图 + .gitignore 记录其角色，不内嵌实现
$team	并行评审与架构反馈 → PARITY.md、parity-audit、reference_data、多子系统 manifest
$ralph	持久执行 + 验证纪律 → unittest discover、大量 src.main CLI 黑盒测、bootstrap/turn-loop 链、cargo 构建与测试（及 README 中的 cleanroom / manual validation）
OmO（Rust 阶段）	README 所述加速实现与验证支持；与 Python 阶段分工并列
可重复	标准命令 + 版本化快照 + 条件 parity（无 archive 不谎称对齐，见 result/26.md）

一句话 ：$team / $ralph 是工作流层的命名 ；claw-code 用 测试、审计 CLI、快照与诚实 parity 文案 把同一意图落成 任何人都能跑的流水线------AI 辅助从「某次对话很顺」变成「门禁与文档可继承」。

---