Modeling Workbench

Modeling Workbench

简体中文 | English

从赛题到论文，让 AI 辅助建模有据可查。

面向数学建模比赛的 Codex / Claude Code 工作流。提供官方赛题与附件，由 agent 按阶段完成问题拆解、模型比较、计算、复核和中英文 LaTeX/PDF 交付；你在三个关键节点审阅并决定是否继续。

读题 → 比较模型 → 运行计算 → 独立复核 → 写论文 → 检查并交付 PDF

- 模型经过比较再选定：先试算候选方案，记录取舍依据，再进入正式计算。
- 论文数值有出处：计算记录关联代码、数据和结果，代码修改后能发现旧证据失效。
- 默认充分论证、图文并重：展开关键推导与结果解释，主动绘制有证据支持的图表和模型示意图，按比赛要求控制篇幅。
- 交付包含可检查的材料：中英文论文、源码与结果、复核记录，以及经过编译和逐页检查的 PDF。

工作流帮助组织和核验过程；模型是否合理、结论是否成立，仍需要结合题意与证据判断。

快速开始 · 比赛支持 · 架构与七个阶段 · 完整走查 · 开发说明

快速开始

准备好 Codex 或 Claude Code，把官方赛题、附件和当届提交要求放进同一个文件夹。 接下来复制两段提示词即可，无需先安装 Skill、填写契约或逐个运行脚本。

第一步：准备环境（首次使用）

在一个可写的本地目录中打开对话，发送：

如果 agent 下载仓库遇到网络问题，可以改用下面的 ZIP 补充方式完成第一步；原来的启动方式仍然可用。

补充方式：提前下载 ZIP，从本地准备环境

先在浏览器中打开仓库主页，选择 Code → Download ZIP，完整解压后再让 agent 操作。已有完整本地副本可直接使用，无需重新下载。

将解压后的工作流放在独立工具目录，例如 数学建模/modeling-workbench-main/；官方材料另放一个目录，第二步的项目输出目录使用尚不存在的新目录。提供包含 README.md 和 .agents/ 的那一层路径，不要提供 ZIP 文件或它的上级目录。.agents 是隐藏目录，解压时也需要保留。

在环境准备对话中，用下面的提示词替代第一步原提示词：

随后继续原来的第二步，将工具目录替换为实际解压路径。ZIP 下载仍需要浏览器能访问 GitHub；这条路径避免 agent 反复尝试获取仓库，不代表依赖安装也能离线完成。缺少 LaTeX 等论文工具时，可以先开展基础环境支持的读题与建模，进入论文阶段前再补齐。

第二步：开始建模（每道新题）

环境就绪后，新开一个对话，替换下面三处路径并发送。工具目录用第一步返回的路径；输出目录使用尚不存在的新目录，与工具和材料目录分开。

接下来你只需跟随阶段提示审阅材料。 同一环境再次使用时可直接从第二步开始。中断后，提供项目输出目录并说“继续 cumcm-workflow”；已有项目应恢复，不要重新初始化。

你也可以随时说“检查环境”或“这个项目现在做到哪了”。agent 会调用环境体检或项目状态工具，报告缺失依赖、证据问题和待确认事项；工具不会自动安装软件、修改项目或替你确认。

高级使用：手动查看环境和项目状态

S 为工作流工具目录下 .agents/skills/cumcm-workflow/scripts 的绝对路径：

加 --json 可查看完整结构化结果。环境体检按阶段报告缺失项，缺 LaTeX 不妨碍先建模；状态检查截至当前阶段，并区分检查结果与行动关卡。退出码为 0 仍可能需要人工确认。详见诊断工具说明。

路径、Windows 和环境问题

- macOS：路径例如 /Users/你的名字/Documents/赛题资料。
- Windows 推荐 WSL2：在 WSL2 中运行 agent 和工具，材料路径例如 /mnt/c/Users/你的名字/Documents/赛题资料；新项目可放在 /home/你的WSL用户名/modeling-projects/2026B。
- 路径须采用 agent 执行环境可见的格式。Python、计算后端和 XeLaTeX 也须在同一环境中可用。
- 原生 Windows：决策记录器已使用 Windows 文件锁；提交检查按…