omx-setup 是 oh-my-codex（OMX）的安装与配置任务卡，用于在当前项目或用户范围安装或刷新 OMX。共享的安全、生命周期、钩子、团队、自主与取消规则位于 templates/AGENTS.md，本卡不推断新的 CLI 行为，以实现为准。
主要命令：omx setup [--force] [--merge-agents|--no-merge-agents|--clear-merge-agents-policy] [--dry-run] [--verbose] [--scope <user|project>] [--plugin|--legacy|--install-mode <legacy|plugin>] [--mcp <none|compat>] [--no-mcp|--with-mcp] [--disable-team|--enable-team|--team-mode <enabled|disabled>]；omx agents-init [path] [--dry-run] [--force] [--verbose] 仅用于轻量生成 AGENTS.md，不是完整安装。
选项要点：--force 覆盖/重装受管产物，不持久化；--merge-agents 等为裸选择器，冲突会在变更前失败；--dry-run/--verbose 预览或显示细节；--scope 选择用户（~/.codex、~/.omx/agents）或项目（./.codex、./.omx/agents）；--plugin/--legacy 选择交付模式；--mcp none|compat 控制第一方 MCP 兼容与共享注册表同步；--disable-team 等控制 Team 技能/上下文生成。
作用域与模式解析：显式标志、持久化的 ./.omx/setup-scope.json、TTY 选择（默认 user）或非交互 user；模式由显式标志、持久化模式、发现的插件缓存或默认 legacy 决定。成功后才创建目录并原子持久化偏好。
setup 会安装提示/原生代理/技能并合并 config.toml（legacy），或归档移除旧产物、刷新原生代理 TOML 并保留运行时钩子（plugin）；两种模式都验证 Team CLI 互操作标记、按需生成 AGENTS 默认值并写入 ./.omx/hud-config.json。AGENTS.md 为 ./AGENTS.md，无 --force 或 --merge-agents 时交互会询问、非交互保留。
验证：omx setup --force --verbose 与 omx doctor，检查所选作用域的提示与技能、项目根 AGENTS.md、.omx/state 及 config.toml。本地源码需先 npm run build，再运行 node dist/cli/omx.js setup --force --verbose 和 node dist/cli/omx.js doctor。若 AGENTS 未覆盖或合并，停止活动会话后重跑，不要手动编辑生命周期状态。
故障排查：若 $omx-setup 缺失或过期，运行 omx setup --verbose 与 omx doctor，检查对应 SKILL.md 路径；插件模式确认插件已安装/发现；重复项检查历史 ~/.agents/skills 重叠。退出时报告作用域/模式、dry-run 与变更、AGENTS 策略、受影响根与 doctor 指标；失败时保留原始输出并重跑最小修正命令，不得仅凭 dry-run 声称安装成功。