用途：通过 codex-wrapper 执行 Codex CLI，把复杂代码任务委托给 Codex AI，用于代码分析、重构、代码生成与测试等。要求已安装并认证 Codex CLI。
主要能力：支持 @ 语法引用文件、多模型与沙箱控制；解析 Codex JSON 流，抽取 agent_message 并附会话 ID（SESSION_ID），可用 resume 继续会话；支持 --parallel 并行与依赖编排，自动拓扑排序、错误隔离、依赖阻塞。
使用方式：所有自动调用须经 Bash 工具前台运行，使用 HEREDOC 避免 shell 转义问题，timeout 固定为 7200000 毫秒。基本形式：codex-wrapper - [working_dir] <<'EOF' … EOF。简单单行任务可用 codex-wrapper "simple task here" [working_dir]。恢复会话：codex-wrapper resume <session_id> - [working_dir] <<'EOF' … EOF。并行需把任务元数据放入 stdin：codex-wrapper --parallel <<'EOF'，块以 ---TASK--- 开始，含 id（必填、建议 <feature>_<timestamp>）、可选 workdir、dependencies、session_id，---CONTENT--- 后为任务内容；--parallel 不接受额外命令行参数，workdir 须写在任务块内。
适用场景：大规模多文件重构、需深度理解的代码分析、带安全控制的自动化生成、并行执行分析→实现→测试等链式任务。
限制：不得后台运行，每次 Codex 任务保持单次前台 Bash 调用；超时默认 2 小时，可用 CODEX_TIMEOUT 覆盖（毫秒），超时返回 124；直接执行仅在 Codex 不可用或同一任务连续失败两次时允许，需记录 CODEX_FALLBACK 并在下个任务重试 Codex。使用 --skip-git-repo-check 可在任意目录工作；跨平台支持 Linux（amd64/arm64）与 macOS（amd64/arm64），为单个 Go 二进制。PowerShell 用 @' … '@ here-string。