codex-constructionlisted
Install: claude install-skill shengyy/agent-skills
# codex-construction — 轻量派工编排
核心哲学:新一代模型(GPT‑5.6+/Claude 5+)能力过剩,编排的价值在**分工、边界、验收**,
不在过程管控。不替 codex 写码,不给实现细节,不搭沙箱管道;给合同、给自主权、验收结果。
## 分工
- **主代理**(任意模型,不锁死):产品/架构方案与施工合同、拆批、派工、监控、分批验收、终审。
- **Codex**:一批之内全自主——读合同、实现、跑门禁、分阶段 commit、写验收包。
- 主代理不要中途接管施工,codex 不要反向���产品级裁决;两边都越界就乱。
**为什么必须有监工**:codex 独立干活的系统性偏差是**过度工程**(防御层、状态机、
分类学自发膨胀);放权施工 + 主代理监工恰好互补。监工只盯三件事,不管过程:
1. **方案裁决在先**——复杂度要在合同定稿时杀掉,施工中再拦成本翻倍;
2. **分批验收盯复杂度漂移**——验收包里新出��的合同外机制按负收益默认拒收,
要求论证真实威胁模型才保留;
3. **BLOCKED 裁决**——codex 停下来问的点快裁快回,不让施工空转。
## 调用
```bash
codex exec -m gpt-5.6-sol -c model_reasoning_effort="<high|xhigh>" -s danger-full-access "$(cat PROMPT_FILE)"
```
- 模型:`gpt-5.6-sol`(2026-07 当前最优;模型换代只改这一处)。裸传简称会被服务端 400 拒。
- effort:`high` = 边界清楚的常规施工、定点修复、**收口核验轮**(验证指定修复落点的轻量复审);
`xhigh` = 架构级重构、资金/并发核心、**全面对抗审查轮**(跨模块因果链追踪型发现只在这一档稳定出现)。
别为省时间降全面审的档;若确需多视角拆审(见「改-审循环」的升级判据),并行开会话,墙钟只等最慢一路。
- `danger-full-access` 没有沙箱兜底:**一切边界靠 prompt 写明**(见模板第 5 条)。
## 启动(launch-only 原则)
```bash
nohup bash -c 'codex exec ... "$(cat PROMPT_FILE)"' > RUN.log 2>&1 & echo "pid=$!"
```
- prompt 先写文件再 `cat`,避免引号地���;日志放任务专属 tmp 目录。
- 启动调用必须秒回:**同一次 Bash 里不得再带任何耗时前台命令**——外层超时按进程组
SIGKILL,`nohup` 挡不��组杀,会把刚起的 codex 连带杀死且日志无收尾。
- 运行中的日志不要 truncate(`>` 重定向下会变稀疏文件,破坏完成检测)。
## 监控(三终态,不看 PID)
| 终态 | 判定 |
|---|---|
| 完成 | 日志出现 codex 收尾标记 `tokens used` |
| 崩溃 | 进程消失且无收尾标记 |
| 停滞 | 日志 mtime 静默 20–25 分钟 |
坑:不要直接 grep 自己定义的完成标记——codex 会**回显 prompt 原文**(内含标记文本),
必��先确认 `tokens used` 再解析其后的输出。
## Prompt 模板(五要素,轻量)
1. **现场