{"id":"bab1e14e-d171-4ea7-b973-f34dd2fe4b9b","slug":"math-modeling-contest","kind":"skill","name":"math-modeling-contest","summary":"","owner":"touhouZELDA","repoUrl":"https://github.com/touhouZELDA/math-modeling-contest","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-08-13T14:11:49.000Z","addedAt":"2026-10-22T03:27:03.138Z","logoUrl":"https://avatars.githubusercontent.com/u/241536964?u=dd1ea3a691d39cb85f9d66fc3d3d0918777c27ec&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-22T13:57:13.352Z","sample":false,"url":"https://conduits.dev/tools/math-modeling-contest","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<p align=\"center\">\n  <img src=\"assets/icon-large.svg\" alt=\"Math Modeling Contest\" width=\"120\"/>\n</p>\n\n<h1 align=\"center\">Math Modeling Contest Agent</h1>\n\n<p align=\"center\">\n  <strong>v5.11</strong> · 工业级数学建模竞赛全流程 Agent · **主要服务国赛(CUMCM)**\n</p>\n\n<p align=\"center\">\n  <img alt=\"dsh\" src=\"https://img.shields.io/badge/适配-DeepSeek%20Harness%20(dsh)-4B8BBE\">\n  <img alt=\"Codex\" src=\"https://img.shields.io/badge/Codex-supported-339cff\">\n  <img alt=\"CUMCM\" src=\"https://img.shields.io/badge/竞赛-国赛%20CUMCM-1A6FC4\">\n  <img alt=\"MCM\" src=\"https://img.shields.io/badge/竞赛-美赛%20MCM%2FICM-E28E2C\">\n  <img alt=\"51MCM\" src=\"https://img.shields.io/badge/竞赛-五一赛%2051MCM-2E9E44\">\n  <img alt=\"Version\" src=\"https://img.shields.io/badge/version-5.11.0-blue\">\n  <img alt=\"License\" src=\"https://img.shields.io/badge/license-MIT-green\">\n  <img alt=\"LaTeX\" src=\"https://img.shields.io/badge/论文生成-LaTeX%20(XeLaTeX)-008080\">\n</p>\n\n---\n\n> 从赛题到终稿，一站式交付。双模式运行、六维选题评估、模型依赖 DAG、五人评审团、学术诚信门控、公式自动渲染——把数学建模竞赛变成可追溯、可审计的工程流水线。\n\n## 为什么需要这个？\n\n建模竞赛真正失败的地方，往往不是\"不会模型\"，而是**流程漂移**：\n- 题没读清楚就上复杂模型\n- 论文里写的数字脚本输出找不到\n- bug 修复后论文数字偷偷漂移没人察觉\n\n`math-modeling-contest` 把这些漂移模式做成\"结构上藏不住\"的形态——每个数字可追溯、每次修改有审计、每项声明有证据。\n\n## 核心能力\n\n| 能力 | 说明 |\n|---|---|\n| **双模式运行** | Autopilot（全自动管道）或 Manual（人工强制检查点） |\n| **六维选题评估** | 从数据可得性、建模难度、创新空间等 6 个维度评估选题 |\n| **L3+ 模型推导深度** | 强制达到工程可复现的推导深度，拒绝\"显然可得\" |\n| **模型依赖 DAG** | 子模型间的依赖关系可视化为有向无环图 |\n| **五人评审团** | 5 个独立 reviewer 打分，≥65 分才放行 |\n| **学术诚信门控** | 7 类阻断式检查（抄袭、数据造假、引用缺失等） |\n| **公式自动渲染** | LaTeX → OMML 原生 Word 公式（可编辑，非图片） |\n| **三线表自动排版** | 国赛标准三线表，一键生成 |\n| **获奖级图表风格库** | 2025 国赛 A 题获奖论文实证：示意图/判据图/地形图/分布图/技术路线图六图型模板 + 图注公式 |\n| **图表两阶段自检** | 图级自检(read_image+字形审计) → 嵌入 LaTeX → XeLaTeX 编译 → 论文整页截图文级自检，强制闭环 |\n| **分数轨迹追踪** | 每次修改后自动追踪论文质量分数变化 |\n| **18-22 页标准输出** | 符合国赛/美赛页数规范，自动内容量检查 |\n\n## 运行模式\n\n### Autopilot 模式\n```bash\npython scripts/pipeline_manager.py auto\n```\n全自动跑完：分析 → 建模 → 验证 → 论文。适合快速原型和 deadline 冲刺。\n\n### Manual 模式\n```bash\npython scripts/pipeline_manager.py manual\n```\n每个阶段有显式门控（enter_condition / pass_criteria / fail_fallback），失败会标脏下游产物。适合追求可控性和质量。\n\n## 支持的竞赛\n\n| 竞赛 | 语言 | 论文格式 |\n|---|---|---|\n| **CUMCM** 全国大学生数学建模竞赛（国赛） | 中文 | 三线表、宋体+黑体、A4 |\n| **51MCM** 五一数学建模竞赛 | 中文 | 三线表、宋体+黑体、A4 |\n| **MCM/ICM** 美国大学生数学建模竞赛（美赛） | 英文 | 标准学术格式 |\n\n## 快速开始\n\n### 安装\n\n```bash\n# 安装到 Codex\ncodex skills install github.com/xuec699-sudo/math-modeling-skills\n```\n\n或手动复制 `SKILL.md` 所在目录到 `$CODEX_HOME/skills/math-modeling-contest/`。\n\n### 使用\n\n在 Codex 中说：\n- \"求解这道题\" / \"solve this\" — 全流程跑\n- \"只做问题1\" — 分段执行\n- \"生成论文\" / \"write paper\" — **强制走 `build_docx.py`**（非 Pandoc）\n- \"修改论文\" / \"revise paper\" — **原地编辑 DOCX**\n- \"审阅论文\" — QA 清单检查\n\n### 论文生成（关键流程）\n\n```bash\n# 1. 写 Markdown 草稿（LaTeX 公式 + [FIGURE:] 占位符）\n# 2. 一键生成 DOCX\npython scripts/build_docx.py draft.md output.docx\n# 3. 如果内容不足 15000 字 → HARD FAIL → 扩展后重试\n```\n\n> ⚠️ **严禁**使用 Pandoc 或手动 `python-docx` 绕过此流程。\n\n## 项目结构\n\n```\nmath-modeling-contest/\n├── SKILL.md                    # 核心技能定义（45KB）\n├── agents/                     # Agent 配置\n├── scripts/                    # 核心脚本（60+ 个）\n│   ├── pipeline_manager.py     # 管道编排器（30KB）\n│   ├── quality_gate.py         # 质量门控（51KB）\n│   ├── build_docx.py           # DOCX 生成器（LaTeX→OMML）\n│   ├── plot_figures_nature.py  # 论文级图表生成\n│   ├── model_remediator.py     # 模型修复器\n│   └── ...\n├── references/                 # 参考文档\n│   ├── algorithm-library/      # 7 类算法库（优化/预测/评价/图论/统计/综合/ML）\n│   ├── role-guides/            # 建模手/编程手/论文手角色指南\n│   ├── problem-triage.md       # 六维选题评估\n│   ├── integrity_gate_checklist.md  # 学术诚信 7 类检查\n│   ├── model-formulation-guide.md   # 模型建立指南\n│   ├── premium-figures-2025a.md     # 获奖论文图表精讲(2025国赛A题实证)\n│   └── ...\n└── templates/                  # 论文模板（LaTeX + DOCX）\n```\n\n## 许可证\n\nMIT License\n\n---\n\n<p align=\"center\">\n  <sub>Built for CUMCM · 51MCM · MCM/ICM</sub>\n</p>\n\n---\n\n## 版本控制(Git)\n\n本 skill 目录是**本地 Git 仓库**(2026-08-13 初始化,`main` 分支,首次提交 `b727a70`)。\n\n### 用途\n- 跟踪 skill 自身的所有修改(主流程、community、脚本、模板)\n- 备份与回溯:任何改动出错都可以 `git checkout` / `git revert` 恢复\n\n### 常用命令\n```bash\ngit status                # 查看当前改动\ngit add -A && git commit -m \"说明本次改动\"   # 提交\ngit log --oneline         # 查看提交历史\ngit diff                  # 查看未提交的改动详情\n```\n\n### 说明\n- `.gitignore` 已排除运行产物(`__pycache__/`、竞赛 Workspace、日志、输出 JSON 等),提交时只会记录 skill 本身的文件\n- 本地提交身份:`zelda <zelda@localhost>`;如需修改:`git config user.name \"你的名字\"`、`git config user.email \"你的邮箱\"`\n- `community/` 内容来自 GitHub 开源上游([zhnnky329/MathModeling-skills](https://github.com/zhnnky329/MathModeling-skills)、[sweetcornna/mathodology](https://github.com/sweetcornna/mathodology),2026-08 抓取)。如需更新上游,重新下载对应仓库后覆盖 `community/` 再提交即可\n- 已关联远程仓库 `origin` → `git@github.com:touhouZELDA/math-modeling-contest.git`(GitHub, 2026-08-13 推送)\n- 推送命令:`git push`(首次:`git push -u origin main`);拉取更新:`git pull`\n\n---\n\n## 适配与定位\n\n- **适配 DeepSeek Harness (dsh)**（v5.9）:安装到 `~/.dsh/skills/math-modeling-contest/` 即被 dsh 自动发现(dsh 用户级技能根,`dsh-skill-filesystem` 扫描 `$DSH_HOME/skills`),无需平台配置文件;模型建议、工具映射见 SKILL.md §0.4(DeepSeek 官方 provider、subagent/read_image/MCP 协作)。\n- **兼容性**:同时兼容 Claude Code / Codex 等通用 SKILL.md 接口(`agents/openai.yaml` 仅 Codex 系使用),无任何专有平台依赖。\n- **主要服务国赛(CUMCM)**:核心流程、格式标准、评审维度均按国赛评阅习惯定制(3-5 分钟初评、复盘检查 5 维度、40 条错误清单);同时支持美赛(MCM/ICM)、51MCM。\n- **论文生成使用 LaTeX**:论文一律以 LaTeX 撰写并经 **XeLaTeX 两遍编译**产出 PDF(ctex 中文支持 + 字体自动回退);禁止用 Pandoc/DOCX 替代主编译流程(详见 SKILL.md「PAPER GENERATION」与 §15)。\n- **为什么有三个竞赛?** 本 skill 由开源社区版本演进而来,流程框架设计为覆盖三大主流赛事——**国赛 CUMCM**(主服务,国赛评阅习惯定制)、**美赛 MCM/ICM**(英文写作、Presentation 风格)、**51MCM 五一赛**(独立格式规范)。三者共用同一套\"选题→建模→求解→写作→评审\"流水线,仅在格式标准与评审侧重上分流(见 SKILL.md §0.2 竞赛类型识别);若只打国赛,忽略美赛/五一赛相关分支即可。\n\n## 社区来源与许可\n\n| 部分 | 来源 | License |\n|---|---|---|\n| 主流程 v5.8 | [xuec699-sudo/math-modeling-skills](https://github.com/xuec699-sudo/math-modeling-skills) | 无显式声明,本仓库按 MIT 再发布 |\n| `community/zhnnky329-skills`(28 个) | [zhnnky329/MathModeling-skills](https://github.com/zhnnky329/MathModeling-skills) | MIT |\n| `community/mathodology`(9 个) | [sweetcornna/mathodology](https://github.com/sweetcornna/mathodology) | 见其 LICENSE |\n\n本仓库整体按 **MIT License** 发布(见 `LICENSE`);`community/` 子目录保留各自上游许可声明。\n\n## 安装使用(DeepSeek Harness / 通用)\n\n```bash\n# 方式一:直接下载仓库放入 dsh 用户级技能根(自动被发现)\ngit clone git@github.com:touhouZELDA/math-modeling-contest.git ~/.dsh/skills/math-modeling-contest\n# 方式二:已有目录更新\ncd ~/.dsh/skills/math-modeling-contest && git pull\n```\n\n之后描述数学建模任务即可自动匹配(也可显式加载该 skill);其他支持 SKILL.md 约定的 agent 框架将技能目录放入各自技能根即可。\n"}