| name | auto-mcm |
| description | AutoMCM-Pro industrial-grade math modeling agent (Codex CLI binding). Supports AP (AI-led) and Manual (human-spec-led) dual modes with mandatory GitOps checkpoints, forced self-verification of all solver code before LaTeX inclusion, and structured human cross-validation at each pipeline stage. Use for both CUMCM (Chinese) and MCM/ICM (English) competitions.
|
AutoMCM-Pro：Codex CLI 绑定
这是 AutoMCM-Pro 协议在 OpenAI Codex CLI 上的运行时绑定（Binding），不是另一套
独立协议。 行为规范权威来源仍是仓库根目录的 AutoMCM_SOP.md（工具无关，原样
复用）；可选探索层见 LOS_ALAMOS_DESIGN.md。Claude Code 绑定是
.claude/skills/auto-mcm/SKILL.md，DeepSeek Harness 绑定是
.dsh/skills/auto-mcm/SKILL.md——三份文件描述同一套流程，只是把"怎么调用工具"
换成各自 runtime 的实际工具，流程逻辑、Checkpoint 规则、质量门控、Prompt 内容
不应该在几份文件间产生分歧。完整背景见
CODEX_INTEGRATION.md。
【与其他 runtime 最大的差异：Codex 只给模型一个"代码模式"工具，实测确认】
这不是源码调研的推测，是实跑一次任务、解压
~/.codex/sessions/**/rollout-*.jsonl 核对过的：Codex 模型端 function-calling
只看得到一个叫 exec 的顶层工具，参数是一段 JavaScript 代码；
tools.exec_command({cmd, workdir, ...}) 是这段 JS 代码内部能调用的异步
函数，不是模型能单独调用的顶层工具。也就是说，Bash/Read（文本）在 Codex
上都是：模型写一段 JS，里面调用 tools.exec_command({cmd: "..."})，再用
text(r.output) 把结果吐出来——不是直接的 {"tool": "exec_command", "cmd": "..."} 这种扁平 function call。
实测时甚至连读 SKILL.md 本身也是这样做的：模型用
tools.exec_command({cmd: "sed -n '1,240p' .agents/skills/auto-mcm/SKILL.md"})
直接读档，没有专门的 skill 载入工具——这点跟 opencode/dsh 都不一样（它们有
独立的 skill 工具）。
这件事对 AutoMCM-Pro 反而是天然契合——本项目的流水线绝大部分工作本来就是
"用 bash 调 Python 脚本"，很少直接依赖结构化文件工具，翻译成 Codex 的
JS-in-exec 模式没有额外损失。
【工具映射表】
| Claude Code | Codex 工具 | 说明 |
|---|
Bash | 顶层工具 exec（参数是一段 JS），内部调 tools.exec_command({cmd,...}) | ✅ 实测确认（喚醒協議 Step 1 跑通）。万能工具：跑 Python 脚本、cat 读文件、rg/grep/find 搜索、curl 抓网页，本文件后续所有"执行 python scripts/..."都是这个模式，不是直接的扁平 function call |
Read | 同上，exec 里的 JS 调 tools.exec_command({cmd: "cat ..."}) | ✅ 实测确认（读 SKILL.md 本身就是这么做的） |
Read（图片） | view_image | 专用图片查看工具，读图表/PDF 截图用它，不要用 cat |
Write/Edit | apply_patch | 结构化 diff 应用工具，写/改模型代码、.tex 文件优先用它（比 shell heredoc 更可靠地保留缩进/编码） |
Glob/Grep | exec_command 里 rg/find | 没有专用搜索工具 |
TodoWrite | update_plan | 语义对应 |
AskUserQuestion | 请求用户输入的工具（模块 request_user_input，确切工具名未逐字核对，见下方核验清单） | 语义对应 |
Agent(description, prompt) | 多代理协同工具家族（模块 multi_agents/multi_agents_v2，确切工具名未逐字核对） | Codex 有原生多代理能力，但这次没有把确切的工具调用 schema 读完，接入前务必先跑一个最小测试确认参数格式 |
WebSearch/WebFetch | 没有确认到的第一方工具 | 见下方【已知能力缺口】 |
上表里 exec_command/apply_patch/view_image/update_plan 四个工具名是从
codex-rs/core/src/tools/handlers/ 源码里的 ToolName::plain(...) 字面量直接
核对过的（不是猜的）；request_user_input、multi_agents/multi_agents_v2 是
从模块/文件命名推断，没有找到对应的字符串字面量，接入前务必先用一个最简单的
任务实测一次，确认真实暴露给模型的工具名。
【已知能力缺口：网络搜索】
Codex 核心代码里没找到独立的 web_search/web_fetch 工具（dsh/opencode 都有，
Codex 没有内置）。看到的只有 MCP（Model Context Protocol）相关模块，猜测 Codex
把网络检索能力交给用户自行配置的 MCP server，而不是内置。这意味着：
AutoMCM_SOP.md 里"文献调研至少 5 篇"这条硬性要求，在 Codex 上落地前必须先
确认有可用的网络检索能力（配置一个 MCP 网络搜索 server，或者退化成
exec_command 里 curl 调用一个你自己有权限的搜索 API）；- 若确认没有任何网络检索能力，不要静默跳过文献调研——按
AutoMCM_SOP.md
第 7 节"禁止静默跳过验证失败"的同一精神，在 Checkpoint①里如实告知用户"当前
环境无网络检索工具，本阶段建模假设未经文献交叉验证"，让人类决定要不要补充
MCP 配置或人工提供文献。
- 同样的缺口也影响
AutoMCM_SOP.md §18"画图前先查领域惯例"——判断某类问题的
常规可视化形式本质上也是一次网络检索。不要因为查不到就直接静默退化成随手
选个图表类型：先按上面同一套办法确认有没有可用的检索能力；确实没有的话，
在 thought_process.md 里如实记录"当前环境无网络检索工具，图表形式选择依据
建模者常识判断、未经领域惯例检索确认"，而不是不留痕迹地直接画图。
【运行方式】（Codex 特有）
codex
codex exec "task"
Skill 发现路径是 .agents/skills/auto-mcm/SKILL.md（仓库根向上找 .git，Codex
官方文档确认），显式调用用 $auto-mcm，或让模型按 description 隐式匹配。
【流水线执行】
阶段定义、状态机、Checkpoint 编号（①~⑤）、质量门控（quality_gate.py）、
Los Alamos 探索层（路径 C）、图表风格规范（plot_style.py）、Andon 紧急停止
（pipeline_manager.py andon-pull/andon-clear/andon-status）、Go/No-Go 发射前检查
（quality_gate.py launch-check，final_compile 前强制）、Skunk Works 轻量模式
（pipeline_manager.py init --skunk-works）、Track2 的 RAND Delphi 多轮收敛
（adjudicate.py delphi-summary）、Kaizen 质量打磨循环
（pipeline_manager.py kaizen-assess/kaizen-round-start/kaizen-status）、工作日志
（worklog.py append/tail，单文件简体中文完整记录，唤醒协议 Step 0）、文献引用
真实性核验+共享池（cite_check.py register/verify/list/export-bibitems）、写作
风格打磨（style_check.py scan，latex_draft 固有规范非可选 addon）、官方格式
合规（quality_gate.py anon-check、ai_usage_doc.py generate/cite-format/ mcm-entry、compile_pdf.py 编译后页数提醒，AutoMCM_SOP.md §17）、画图前先查
领域惯例（AutoMCM_SOP.md §18）全部内容
与 Claude Code 版本一致，见
.claude/skills/auto-mcm/SKILL.md 对应小节（标题相同），
按上方【工具映射表】替换调用方式：
- 子 Agent 调用：原文里每个
Agent(description=..., prompt=<模板>)，改为
Codex 的多代理工具调用，prompt 字段内容完全不变（先按【已知能力缺口】小节的
提醒实测确认参数格式，再套用到 Los Alamos 路径 C 的四套 Prompt 模板）
- 人类确认环节：
ask_user_question 换成 Codex 的用户输入请求工具
- 文件读写：模型代码/验证脚本/LaTeX 文件优先用
apply_patch，图表结果查看用
view_image
scripts/*.py 系列命令（pipeline_manager.py/quality_gate.py/
los_alamos/*.py/plot_style.py）完全不变，全部通过 exec_command 调用
【安全规程】
AutoMCM_SOP.md 的 S1~S5 原样适用。S3（外部服务调用告知）在 Codex 上尤其重要——
既然网络检索要靠用户自配的 MCP server，调用前更要做好关键词抽象化，不要把题目
原文整段发给一个你不确定信任边界的外部 MCP server。
