用途：诊断并修复 oh-my-codex（OMX）的安装与发现类问题。共享的安全、生命周期、钩子、团队、自主与取消规则位于 templates/AGENTS.md；当设置了 CODEX_HOME 时，~/.codex 指 ${CODEX_HOME:-~/.codex}。
主要能力：运行 omx doctor 检查安装状态，可用 --team 加入 Team 运行时检查、--verbose 输出详细证据、--force 修复符合条件的仓库产物归属问题、--dry-run --force 预览归属修复。检查项包括插件缓存与版本、钩子配置（config.toml / 旧版 settings.json）、旧版脚本、AGENTS.md、插件缓存、旧版 agents/commands、技能根目录。
使用方式：本地源码检出需先构建，再执行 node dist/cli/omx.js doctor。插件缓存位于 ${CODEX_HOME:-$HOME/.codex}/plugins/cache，可用 npm view oh-my-codex version 查看最新版本。无缓存为 INFO（npm/setup-only 安装属正常）；非本地缓存版本与最新版不一致，或同一 marketplace 存在多个版本为 WARN。插件发现不能替代 npm 安装加 omx setup，原生/运行时接线仍由 setup 负责。
判定与修复：旧版钩子引用为 CRITICAL（重复钩子）；keyword-detector.sh、persistent-mode.sh、session-start.sh、stop-continuation.sh 为 WARN；缺少 AGENTS.md 为 CRITICAL，缺少 OMX 标记为 WARN。${CODEX_HOME:-~/.codex}/skills 是规范用户根，~/.agents/skills 为历史根，重叠树可能重复技能条目；旧版 agents/ 或 commands/ 下的 OMX 文件为 WARN。修复需用户确认且确认目标为 OMX 所有，仅删除确认的 OMX 旧内容并保留无关用户文件；AGENTS.md 缺失或过期时从当前发布源刷新后重跑 omx doctor，修复后重启 Codex 并报告前后证据。
限制：仅在必需路径、钩子/配置检查、AGENTS 标记、插件缓存状态及（请求时）Team 检查全部通过时才可判定 HEALTHY，否则报告 ISSUES FOUND、确切失败证据与最小确认修复；不得仅凭建议声称已修复。