Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/touhouZELDA/math-modeling-contest itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 22, 2026从赛题到终稿,一站式交付。双模式运行、六维选题评估、模型依赖 DAG、五人评审团、学术诚信门控、公式自动渲染——把数学建模竞赛变成可追溯、可审计的工程流水线。
为什么需要这个?
建模竞赛真正失败的地方,往往不是"不会模型",而是流程漂移:
- 题没读清楚就上复杂模型
- 论文里写的数字脚本输出找不到
- bug 修复后论文数字偷偷漂移没人察觉
math-modeling-contest 把这些漂移模式做成"结构上藏不住"的形态——每个数字可追溯、每次修改有审计、每项声明有证据。
核心能力
| 能力 | 说明 |
|---|---|
| 双模式运行 | Autopilot(全自动管道)或 Manual(人工强制检查点) |
| 六维选题评估 | 从数据可得性、建模难度、创新空间等 6 个维度评估选题 |
| L3+ 模型推导深度 | 强制达到工程可复现的推导深度,拒绝"显然可得" |
| 模型依赖 DAG | 子模型间的依赖关系可视化为有向无环图 |
| 五人评审团 | 5 个独立 reviewer 打分,≥65 分才放行 |
| 学术诚信门控 | 7 类阻断式检查(抄袭、数据造假、引用缺失等) |
| 公式自动渲染 | LaTeX → OMML 原生 Word 公式(可编辑,非图片) |
| 三线表自动排版 | 国赛标准三线表,一键生成 |
| 获奖级图表风格库 | 2025 国赛 A 题获奖论文实证:示意图/判据图/地形图/分布图/技术路线图六图型模板 + 图注公式 |
| 图表两阶段自检 | 图级自检(read_image+字形审计) → 嵌入 LaTeX → XeLaTeX 编译 → 论文整页截图文级自检,强制闭环 |
| 分数轨迹追踪 | 每次修改后自动追踪论文质量分数变化 |
| 18-22 页标准输出 | 符合国赛/美赛页数规范,自动内容量检查 |
运行模式
Autopilot 模式
python scripts/pipeline_manager.py auto
全自动跑完:分析 → 建模 → 验证 → 论文。适合快速原型和 deadline 冲刺。
Manual 模式
python scripts/pipeline_manager.py manual
每个阶段有显式门控(enter_condition / pass_criteria / fail_fallback),失败会标脏下游产物。适合追求可控性和质量。
支持的竞赛
| 竞赛 | 语言 | 论文格式 |
|---|---|---|
| CUMCM 全国大学生数学建模竞赛(国赛) | 中文 | 三线表、宋体+黑体、A4 |
| 51MCM 五一数学建模竞赛 | 中文 | 三线表、宋体+黑体、A4 |
| MCM/ICM 美国大学生数学建模竞赛(美赛) | 英文 | 标准学术格式 |
快速开始
安装
# 安装到 Codex
codex skills install github.com/xuec699-sudo/math-modeling-skills
或手动复制 SKILL.md 所在目录到 $CODEX_HOME/skills/math-modeling-contest/。
使用
在 Codex 中说:
- "求解这道题" / "solve this" — 全流程跑
- "只做问题1" — 分段执行
- "生成论文" / "write paper" — 强制走
build_docx.py(非 Pandoc) - "修改论文" / "revise paper" — 原地编辑 DOCX
- "审阅论文" — QA 清单检查
论文生成(关键流程)
# 1. 写 Markdown 草稿(LaTeX 公式 + [FIGURE:] 占位符)
# 2. 一键生成 DOCX
python scripts/build_docx.py draft.md output.docx
# 3. 如果内容不足 15000 字 → HARD FAIL → 扩展后重试
⚠️ 严禁使用 Pandoc 或手动
python-docx绕过此流程。
项目结构
math-modeling-contest/
├── SKILL.md # 核心技能定义(45KB)
├── agents/ # Agent 配置
├── scripts/ # 核心脚本(60+ 个)
│ ├── pipeline_manager.py # 管道编排器(30KB)
│ ├── quality_gate.py # 质量门控(51KB)
│ ├── build_docx.py # DOCX 生成器(LaTeX→OMML)
│ ├── plot_figures_nature.py # 论文级图表生成
│ ├── model_remediator.py # 模型修复器
│ └── ...
├── references/ # 参考文档
│ ├── algorithm-library/ # 7 类算法库(优化/预测/评价/图论/统计/综合/ML)
│ ├── role-guides/ # 建模手/编程手/论文手角色指南
│ ├── problem-triage.md # 六维选题评估
│ ├── integrity_gate_checklist.md # 学术诚信 7 类检查
│ ├── model-formulation-guide.md # 模型建立指南
│ ├── premium-figures-2025a.md # 获奖论文图表精讲(2025国赛A题实证)
│ └── ...
└── templates/ # 论文模板(LaTeX + DOCX)
许可证
MIT License
版本控制(Git)
本 skill 目录是本地 Git 仓库(2026-08-13 初始化,main 分支,首次提交 b727a70)。
用途
- 跟踪 skill 自身的所有修改(主流程、community、脚本、模板)
- 备份与回溯:任何改动出错都可以
git checkout/git revert恢复
常用命令
git status # 查看当前改动
git add -A && git commit -m "说明本次改动" # 提交
git log --oneline # 查看提交历史
git diff # 查看未提交的改动详情
说明
.gitignore已排除运行产物(__pycache__/、竞赛 Workspace、日志、输出 JSON 等),提交时只会记录 skill 本身的文件- 本地提交身份:
zelda <zelda@localhost>;如需修改:git config user.name "你的名字"、git config user.email "你的邮箱" community/内容来自 GitHub 开源上游(zhnnky329/MathModeling-skills、sweetcornna/mathodology,2026-08 抓取)。如需更新上游,重新下载对应仓库后覆盖community/再提交即可- 已关联远程仓库
origin→git@github.com:touhouZELDA/math-modeling-contest.git(GitHub, 2026-08-13 推送) - 推送命令:
git push(首次:git push -u origin main);拉取更新:git pull
适配与定位
- 适配 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 协作)。 - 兼容性:同时兼容 Claude Code / Codex 等通用 SKILL.md 接口(
agents/openai.yaml仅 Codex 系使用),无任何专有平台依赖。 - 主要服务国赛(CUMCM):核心流程、格式标准、评审维度均按国赛评阅习惯定制(3-5 分钟初评、复盘检查 5 维度、40 条错误清单);同时支持美赛(MCM/ICM)、51MCM。
- 论文生成使用 LaTeX:论文一律以 LaTeX 撰写并经 XeLaTeX 两遍编译产出 PDF(ctex 中文支持 + 字体自动回退);禁止用 Pandoc/DOCX 替代主编译流程(详见 SKILL.md「PAPER GENERATION」与 §15)。
- 为什么有三个竞赛? 本 skill 由开源社区版本演进而来,流程框架设计为覆盖三大主流赛事——国赛 CUMCM(主服务,国赛评阅习惯定制)、美赛 MCM/ICM(英文写作、Presentation 风格)、51MCM 五一赛(独立格式规范)。三者共用同一套"选题→建模→求解→写作→评审"流水线,仅在格式标准与评审侧重上分流(见 SKILL.md §0.2 竞赛类型识别);若只打国赛,忽略美赛/五一赛相关分支即可。
社区来源与许可
| 部分 | 来源 | License |
|---|---|---|
| 主流程 v5.8 | xuec699-sudo/math-modeling-skills | 无显式声明,本仓库按 MIT 再发布 |
community/zhnnky329-skills(28 个) | zhnnky329/MathModeling-skills | MIT |
community/mathodology(9 个) | sweetcornna/mathodology | 见其 LICENSE |
本仓库整体按 MIT License 发布(见 LICENSE);community/ 子目录保留各自上游许可声明。
安装使用(DeepSeek Harness / 通用)
# 方式一:直接下载仓库放入 dsh 用户级技能根(自动被发现)
git clone git@github.com:touhouZELDA/math-modeling-contest.git ~/.dsh/skills/math-modeling-contest
# 方式二:已有目录更新
cd ~/.dsh/skills/math-modeling-contest && git pull
之后描述数学建模任务即可自动匹配(也可显式加载该 skill);其他支持 SKILL.md 约定的 agent 框架将技能目录放入各自技能根即可。