用途：在 Codex 环境中独立运行完整的镜像同步，等价于 npm run codex:sync，但无需 npm 或 package.json。同时把可移植的 .claude/scripts/codex/codex-notify.mjs 复制到 .codex/scripts/codex/，并向 .codex/config.toml 写入通知与 TUI 状态行配置。
主要能力：按顺序执行 8 个阶段——migrate（迁移 Claude agents 到 .codex/agents/、镜像 skills 到 .agents/skills/、配置通知）、hooks（生成 .codex/hooks.json）、context（重新生成 .codex/CODEX_CONTEXT.md 与 AGENTS.md）、tests、wf-cycle、sk-proto、residue、sdd。前 3 阶段会修改文件，后 5 阶段为只读校验。流程快速失败，首个非零退出即中止；具备幂等性，重复运行仅产生时间戳差异。
使用方式： node .claude/skills/codex-sync/scripts/run-codex-sync.mjs 可用 --verbose 流式输出子进程日志，--copy-skills 强制技能复制模式，--only=tests,wf-cycle,sk-proto,residue,sdd 仅运行只读校验，--skip=migrate,hooks 跳过阶段。退出码 0 表示全部通过，1 表示编排失败。工作目录由脚本路径自动解析为仓库根目录，不要传 --cwd。
适用场景：需要在 Codex 中保持与 Claude 侧技能、钩子、上下文一致，或调试单个失败阶段时使用。
限制：仅限用户显式调用（$codex-sync），不得自动触发；必须编辑 .claude/skills/codex-sync/** 源文件，绝不能直接改 .agents/skills/codex-sync/** 镜像；.codex/scripts/codex/codex-notify.mjs 需从 .claude 源生成；配置写入需保留无关键值；AGENTS.md 需镜像完整 CLAUDE.md 并保留未托管前言；lessons 内容不得内嵌到 .agents/skills/**。其他细节资料暂未提供。