Skip to content
Conduit

skill

math-modeling-contest

touhouZELDA/math-modeling-contestcommunitylistedunreviewed

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

Skills do not use an MCP config. Follow the steps in the README below.

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.8xuec699-sudo/math-modeling-skills无显式声明,本仓库按 MIT 再发布
community/zhnnky329-skills(28 个)zhnnky329/MathModeling-skillsMIT
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 框架将技能目录放入各自技能根即可。

↑↓ navigate openesc close