███╗   ███╗ █████╗ ████████╗██╗  ██╗    ███╗   ███╗ ██████╗ ██████╗ ███████╗██╗         ██████╗ ██████╗  ██████╗
████╗ ████║██╔══██╗╚══██╔══╝██║  ██║    ████╗ ████║██╔═══██╗██╔══██╗██╔════╝██║         ██╔══██╗██╔══██╗██╔═══██╗
██╔████╔██║███████║   ██║   ███████║    ██╔████╔██║██║   ██║██║  ██║█████╗  ██║         ██████╔╝██████╔╝██║   ██║
██║╚██╔╝██║██╔══██║   ██║   ██╔══██║    ██║╚██╔╝██║██║   ██║██║  ██║██╔══╝  ██║         ██╔═══╝ ██╔══██╗██║   ██║
██║ ╚═╝ ██║██║  ██║   ██║   ██║  ██║    ██║ ╚═╝ ██║╚██████╔╝██████╔╝███████╗███████╗    ██║     ██║  ██║╚██████╔╝
╚═╝     ╚═╝╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝    ╚═╝     ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝    ╚═╝     ╚═╝  ╚═╝ ╚═════╝

数学建模Pro 是一个为数学建模竞赛（国赛 CUMCM / 美赛 MCM/ICM / 各类邀请赛）打造的 AI Agent 全流程工作流 Skill。它把一次完整的建模比赛拆解为 审题 → 建模 → 编程 → 图表 → 论文 → 验收 六个阶段，每个阶段都有可照做的操作手册、量化验收标准和血泪教训清单。

它不是模板，而是一套被实战验证过的方法论：内置 9 份国赛获奖论文的范式提炼、4 篇训练论文的评审扣分点、2000/2001 年经典赛题的算法速查，以及一条可生成合规 Word 论文的自动化生产线（pandoc + 样式模板 + MathType + 视觉检查）。

• 🎯 六阶段操作手册：每个阶段按 输入 → 编号步骤 → 公式/算法 → 产出物 → 验收标准 组织，可直接照做
• 📐 分题型方法论：优化 / 预测 / 评价 / 机理 / 网络 五大题型的选型决策树与防错速查
• 📊 国赛级图表规范：泳道式技术路线图、Nature 配色、图证三段式、图内文字≈正文大小
• 📝 Word 论文生产线：Markdown → pandoc → 三线表（1.5/0.5 磅）→ 公式居中编号 → MathType 一键转换 → 页码 → 逐页视觉检查
• 🔍 两级验收门禁：硬错误（FAIL 必修）/ 警告（WARN 尽量修），占位符零容忍、数值唯一事实源
• 🧠 教学双模式：自动识别"我在想…"（引导教学）与"帮我做…"（直接执行）
• 📚 知识沉淀：每次解题自动写入 Obsidian 笔记与记忆库

mathmodel-pro/
├── SKILL.md                              # 主文件:六阶段操作手册
├── references/                           # 方法论与案例库
│   ├── teaching-golden-rules.md          #   教学黄金规则(模式检测/禁忌/五步流程)
│   ├── modeling-norms.md                 #   建模规范(题型决策树/防错速查/验收门禁)
│   ├── word-paper-pipeline.md            #   Word 论文生产线(含血泪教训)
│   ├── document-handling.md              #   文档处理规范
│   ├── case-vessel-3d-reconstruction.md  #   案例:血管三维重建(2001 B题)
│   ├── case-pipe-optimization.md         #   案例:钢管订购运输(2000 B题)
│   ├── training-papers-lessons.md        #   训练论文+评审扣分点提炼
│   └── award-winning-papers.md           #   9份国赛获奖论文范式
└── assets/                               # 自动化生产线资产
    ├── ref_custom.docx                   #   论文样式模板(宋体小四/行距/段前段后)
    ├── make_ref.py                       #   样式模板生成脚本
    ├── fix_equations.py                  #   公式居中+右编号后处理
    └── fix_tables.py                     #   三线表+表格宽度后处理

MathModel Pro is a full-pipeline AI-agent workflow skill for mathematical modeling contests (CUMCM, MCM/ICM, and beyond). It decomposes a complete contest into six stages — Problem Analysis → Modeling → Coding → Visualization → Paper Writing → Verification — each shipped with an actionable manual, quantitative acceptance criteria, and hard-won lessons.

It is not a template but battle-tested methodology: distilled patterns from 9 national-award-winning papers, review deductions from 4 training papers, algorithm quick-references for classic problems (2000/2001 CUMCM B), and an automated pipeline that produces submission-grade Word papers (pandoc + style template + MathType + visual inspection).

• 🎯 Six-stage operating manual: every stage organized as input → numbered steps → formulas/algorithms → deliverables → acceptance criteria
• 📐 Problem-type methodology: selection decision trees and pitfall guides for optimization / prediction / evaluation / mechanistic / network problems
• 📊 Contest-grade figure standards: swim-lane roadmaps, Nature-style palettes, figure-evidence triads, in-figure text ≈ body text size
• 📝 Word paper pipeline: Markdown → pandoc → three-line tables (1.5/0.5 pt) → centered numbered equations → one-click MathType conversion → page numbers → page-by-page visual check
• 🔍 Two-tier verification gates: hard errors (must-fix FAIL) vs warnings (WARN), zero tolerance for placeholders, single source of truth for all numbers
• 🧠 Dual interaction modes: auto-detects "I'm thinking…" (Socratic guidance) vs "do it for me…" (direct execution)
• 📚 Knowledge sedimentation: auto-writes Obsidian notes and a growing memory bank after every problem

1. 将本仓库的 SKILL.md、references/、assets/ 复制到你的 AI Agent 的 skills 目录（如 .claude/skills/mathmodel-pro/）
2. 对 Agent 说："用 mathmodel-pro 做这道建模题"，并提供题面文件（.doc/.docx/PDF）
3. 按六阶段推进，每阶段结束对照验收标准自查
4. 论文产出后，在 Word 的 MathType 选项卡执行一次 Convert Equations 完成公式格式收尾

1. Copy SKILL.md, references/, and assets/ into your AI agent's skills directory (e.g., .claude/skills/mathmodel-pro/)
2. Tell the agent: "Solve this modeling problem with mathmodel-pro", and provide the problem statement (.doc/.docx/PDF)
3. Progress through the six stages, self-checking against the acceptance criteria after each
4. Finish by running Convert Equations once in Word's MathType tab

本 Skill 经 5 轮自测迭代与真实赛题实战验证（模拟评分 76 → 90+）：

• ✅ 2001 CUMCM B 题（血管三维重建）：R = 30.08 ± 0.14，亚像素定位，32 页论文
• ✅ 运输优化 / 供应商评价 / 灰色预测 三类题型全流程演练
• ✅ 骨架法对比、噪声稳健性、平滑参数敏感性等方法间互验实验

Validated through 5 self-test iterations and a real contest problem (simulated score 76 → 90+).

MIT License — 自由使用、修改与分发，注明出处即可。