codex-construction

codex-construction — 轻量派工编排

编排的价值在分工、边界、验收，不在过程管控。不替 codex 写码，不给实现细节；给合同、给全权、给对得上的档位，验收结果。

分工

• 主代理：出方案与施工合同、拆批、定档、派工、监控、验收、终审。
• Codex：一批之内全自主——读合同、实现、跑门禁、分阶段 commit、写验收包。
• 互不越界：主代理不中途接管施工，codex 跑砸了重派而不是主代理替写；codex 不做产品级裁决。

codex 独干的系统性偏差是过度工程（含过度测试），所以主代理只在三处介入：合同定稿时杀复杂度、验收时拒收合同外机制、BLOCKED 快裁快回。

档位

effort 只用三档：medium / high / xhigh。档位跟合同留给 codex 的裁量空间和出错代价走，不跟任务「重要性」走。

档位	用于	判据
medium（施工默认）	常规功能施工、按合同写测试、机械收尾、根因已知的定点修复、审查已定位问题的修复轮、收口核验	合同已写明「做什么」，codex 只定局部「怎么做」；做错门禁或 diff 能抓住，返工不出本批
high	骨架批、跨模块重改动、根因未知的排查、全批次审查、medium 拒收/BLOCKED 后的重派	合同留了设计空间，或任务是「找问题」而非「做事」
xhigh	架构重构定型批、资金/并发/安全核心、最终态全面对抗审、high 重派再失败的最后一轮	错了要回滚多批，或要找上一轮 high 没找到的问题

• 用户点名优先：用户指定了档位或模型就按用户的；没指定才按本表。
• 升档，不同档重试：某档拒收、BLOCKED 或无交付，重派升一档；xhigh 仍不过 → 熔断回方案层。
• 审 ≥ 施工：审查档不低于被审批次的施工档。
• 不降档区：xhigh 项不因额度降档，额度不够等窗口。
• 省额度靠合同和批次，不靠降审查档：批拆细、合同写到「做什么」才派 medium；合同还留着设计题的批，先在方案层把题做掉，或派 high。
• 启动和 resume 都必须显式传 effort，漏传静默掉回 config 默认档。

启动

nohup bash -c 'exec codex exec -m gpt-6-astra -c model_reasoning_effort="medium" \
  --dangerously-bypass-approvals-and-sandbox -o LAST.md - < PROMPT_FILE' > RUN.log 2>&1 & echo "pid=$!"

• 模型名以本机 ~/.codex/config.toml 为准；换名先用 codex exec -m <名字> "打印 ok" 探针验证，400 即无效。
• --dangerously-bypass-approvals-and-sandbox：关沙箱和审批，不依赖 config，exec / resume 都收。没有兜底，边界全靠 prompt 写明。
• -o LAST.md：最终消息落盘，终态只看它。每批独立命名，启动前不得已存在。
• 合同必须走 stdin（- < FILE），不许 argv "$(cat FILE)"：argv 会把合同泄进 ps，codex 会把含本合同的进程认成别人的施工会话转去监控它，轮询自己零开工（2026-08-15：5 小时 0 commit）。
• 合同开头角色钉死：你就是施工者本人，收到即开工；ps 里含本合同文本的进程就是你自己。
• 启动调用必须秒回：同一次 Bash 里不得再带耗时前台命令——外层超时按进程组 SIGKILL，nohup 挡不住。
• 运行中的日志不要 truncate。
• 启动后立刻记下日志头部的 session id:（修复轮靠它续接），顺手核对 reasoning effort: 是所选档。

监控：先等进程，再读 LAST.md

echo $! 拿到的 pid 就是 codex 本身——靠的是 bash -c 里那个 exec；漏掉它 $! 就是 bash 包装进程，codex 是其子进程，kill -0 仍能判活，但杀它不会杀到 codex。进程还在就是在跑，不解析日志；进程消失后看 LAST.md：