Codex 派活验收 0xyxy/codex-collab

codex-collab

把 OpenAI Codex CLI 当成供应商而不是顾问——要产物，不要解释。

一套 PowerShell 脚本，给 AI 智能体（或你自己）用，解决同一个问题：怎么让 Codex 高效干活，而且干完能验收。

它解决什么

直接调 codex exec 的常见问题：

- 它给你一大段解释，你只想要代码
- 它写完不测，你不知道能不能用
- 改一个 bug 要来回五轮，每轮都重新交代背景
- 五个独立任务排队跑，等得心焦
- 出过的坑，下次又踩一遍

这套脚本把上面全包了：派活时强制附带验收标准 + 自测脚本，本地跑测试，失败把报错原文丢回去。

核心思路

你提需求 ↓ 派活（一次给足：文件名 + 验收标准 + 自测要求） ↓ Codex 写代码 + 写测试 ↓ 本地跑它写的测试 ── 绿 ──→ 补对抗性测试 ──→ 交付 ↓ 红把报错原文整段丢回去（续接同一会话）

两个关键点：

1. 它写的测试只能证明「它想到的都对了」，不证明「它没错」。所以必须补对抗性用例，打它想不到的地方。
2. 失败时不要自己分析再转述，把测试报错原文原封不动丢回去，省一轮翻译。

安装

1. 装 Codex CLI 并登录 https://github.com/openai/codex

2. 把本仓库放到技能目录（可选，用于 DSH/agent 自动加载）
git clone https://github.com/<you>/codex-collab.git "$HOME/.dsh/skills/codex-collab"

或者直接用，不放到技能目录也行
git clone https://github.com/<you>/codex-collab.git
cd codex-collab/scripts

依赖：PowerShell 7+。Python 可选（只有桌面端会话挂载功能需要）。

快速开始

写个脚本（最常用）

./codex-build.ps1
-Task "写一个日志分析脚本，统计访问最多的路径和状态码分布" -Files "Log-Analyzer.ps1" -TestScript "Test-Log-Analyzer.ps1" -Acceptance "参数 -Path/-Top；退出码 0成功 1文件不存在 2无有效数据；输出JSON"

它会自动：
1. 组装派活单（含必交文件、验收标准、自测要求、只回一行的纪律）
2. 调 Codex 写代码，落盘
3. 跑 Test-Log-Analyzer.ps1，告诉你绿还是红

红了就按提示把报错丢回去。

并行跑多个任务

./codex-fanout.ps1 -Tasks @(
"解释 PowerShell 里 $_ 和 $PSItem 的区别", "Get-ChildItem -Force 会不会列隐藏文件", "-ErrorAction Stop 和 try/catch 什么关系" ) -MaxParallel 3

实测 5 个任务并行 25 秒完成，串行要 150 秒。token 一点不多花。

多轮讨论

./codex-talk.ps1 -Message "我的判断是 X，你觉得呢" ./codex-talk.ps1 -Message "你说 Y，但我认为 Z" # 自动续接同一会话 ./codex-talk.ps1 -NewSession -Message "换个话题" # 另起一条

用的是 codex exec resume——真正续接同一个 thread，历史在服务端，不用重发。

修 bug

./codex-build.ps1
-Task "测试报错：FAILED: 状态码分布不符，期望 404:1 实际 404:0" -Files "Log-Analyzer.ps1" -TestScript "Test-Log-Analyzer.ps1" -KeepContext

-KeepContext 续接上一次会话，它记得之前写了什么。

脚本一览

| 脚本 | 用途 | 平台 |
| codex-build.ps1 | 派活 + 强制自测 + 自动验收 | 全平台 |
| codex-fanout.ps1 | 并行派活，多任务同时跑 | 全平台 |
| codex-talk.ps1 | 真单会话多轮续接 | 全平台 |
| codex-delegate.ps1 | 同步调用，快速取结果 | 全平台 |
| codex-post.ps1 | 投递消息到桌面端会话 | Windows |
| codex-send.ps1 | UI 自动化直发（会抢焦点） | Windows |
| codex-on.ps1 / codex-off.ps1 | 代理开关 + 重启桌面端 | Windows |
| _mount.py | 会话挂到桌面端「最近」列表 | Windows + Python |

参数说明

所有调用 Codex 的脚本共有：

| 参数 | 默认 | 说明 |
| -Model | gpt-6.1-sol | 模型名 |
| -Sandbox | read-only / workspace-write | 沙箱级别，要落盘必须用 workspace-write |
| -WorkDir | 当前目录 | 工作目录 |
| -Proxy | 空（直连） | 代理地址，如 http://127.0.0.1:7890 |

codex-talk 额外有 -NewSession（强制新建）、-Thread <id>（指定会话）、-Reset（清空本地记录）、-Full（关掉精简模式）。

codex-build 额外有 -KeepContext（续接上次会话）、-NoVerify（只派活不验收）。

成本参考

- 单次调用固定开销约 13-14K tokens，其中约 93% 是 Codex 内置系统提示（压不掉）
- 所以省额度靠减调用次数，不靠减字
- 默认精简模式：自动追加「正文 300 字以内，代码/命令/表格不计」
- -Full 关掉限制

实测：144 次调用共 41.6M 输入 tokens，其中 95.4% 命中缓存。

已知坑

踩过的都写进 SKILL.md 了，几个常见的：
- codex exec resume 不支持 -s，要用 -c "sandbox_mode=..."
- resume 不传 sandbox 会重置成 read-only，写文件前必须显式指定
- codex resume（TUI 版）需要真终端，脚本里用会报 stdin is not a terminal，要用 codex exec resume
- 从 stdout 提取答案在子进程里不稳定，改成从 rollout 文件读
- 出口 IP 被 Cloudflare 拦时报 403 且 cf-ray 结尾是 -HKG，需要代理

授权

MIT