用途：通过 Codex CLI 的 exec 与 resume 命令运行 Codex，用于代码分析、重构、并行工作、将任务委派给另一模型，或后台生成代码。
配置档案（Profiles）：默认无 profile 为只读分析，不做编译和测试；--profile edit 允许本地编辑、构建或测试（workspace-write，full-auto）；--profile full 允许网络或更广泛的文件系统访问（danger-full-access，full-auto）。涉及 go test、go build 等会写入构建产物的命令时，应加 --profile edit，因为默认只读沙箱会阻止包括编译器临时目录在内的所有写入。复杂任务可加 --config model_reasoning_effort="xhigh"。
模型选择：默认使用 .codex/config.toml 中的项目模型 gpt-5.4。追求速度的交互式工作可用 --model gpt-5.3-codex-spark，适合频繁来回迭代、快速修复与定向编辑、中小型重构或 UI 调整、需要频繁打断重定向的快速原型。深度优先任务保持默认 gpt-5.4，适合长时间自主运行、跨多文件的重推理改动、测试或验证密集任务、正确性与风险要求更高的场景。用户明确指定模型时，遵从用户要求。
命令用法：始终包含 --skip-git-repo-check 和 2>/dev/null。只读分析示例：codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null；速度优先交互循环加 --model gpt-5.3-codex-spark；应用本地编辑加 --profile edit；需要网络或广泛访问加 --profile full；恢复会话：echo "prompt" | codex exec --skip-git-repo-check -o "$CODEX_OUT" resume --last 2>/dev/null。运行前先创建输出临时文件 CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX)，完成后从该文件读取结果。使用 Bash run_in_background: true 运行，通过 TaskOutput 以 block: true、timeout: 600000 监控，不要用 sleep 轮询。
恢复会话：恢复时不要传 model、effort、sandbox 标志，原会话设置会沿用，-o 可安全保留。
约定与验证：这是 Go 项目，提示中使用 go test、go build、go vet。Codex 工作进程不接收 CLAUDE.md 或 hooks，因此项目约定必须显式写明。执行后始终用 git diff --stat 验证 Codex 输出，不要相信工作进程自报的文件列表，它可能做出范围外改动，如删除文件、回退无关代码、移除测试函数。同一代码库存在其他工作时，提示中应包含明确的“DO NOT modify or delete”文件列表，仅写“只改这些文件”不够，Codex 可能宽泛理解“清理”。使用 -C <worktree-dir> 时 worktree 有自己的 git 索引，.claude/ 可能软链到 .agents/，git 操作应使用 .agents/ 路径。