MathModelAgent — Development skill for Claude Code

MathModelAgent — 数学建模国赛（CUMCM）全流程自动化 Skills

一套面向 Claude Code 的**全国大学生数学建模竞赛（CUMCM）**技能包。从赛题分析、建模设计、编码绘图到论文撰写与验收，全流程自动化、规范化、可复现，专为国赛 A/B/C 题定制。

---

📌 1. 项目解决什么问题

全国大学生数学建模竞赛（CUMCM，高教社杯）赛程约 **72 小时**，A/B/C 三题类型迥异：

• A 题：机理 / 连续问题（物理、工程机理，常需微分方程建模）；
• B 题：离散 / 优化问题（图论、规划、组合优化）；
• C 题：数据驱动问题（统计、大数据分析、预测）。

一支队伍要在三天内完成读题、拆解、建模、编程、绘图、写论文、验收的全流程，环节多、容错低：

• 读懂题面、拆解子问题、确定评价指标；
• 选择并建立数学模型，给出目标函数与约束；
• 编写可复现代码并跑出可信结果；
• 绘制论文可用的数据图表与流程图；
• 按国赛模板撰写并编译论文；
• 交付前自检格式、数值一致性与可复现性。

**人工在环节间切换时极易出现**：模型与代码不一致、数值前后矛盾、图表与结论对不上、模板格式出错、占位符漏删、论文无法编译等问题。

**本插件**把以上流程拆解为一组职责清晰的 Claude Code 技能，按固定顺序自动衔接。每个阶段产出结构化报告，把结论、数值、图表资产明确交付给下一阶段，从机制上避免"编造结论""数值不一致""格式违规"等国赛论文高频硬错误。

---

✨ 2. 主要功能

工作流技能（按顺序调用）

技能	阶段	主要产物
1start-mathmodel	总控入口	询问用户偏好，生成 plan.md、todo.md，按顺序调度下游技能
2analysis-modeling	赛题分析与建模设计	子问题拆解、假设敏感性预检、数据理解、变量/目标函数/约束/求解策略 → reports/ANALYSIS_MODELING_REPORT.md
3coding-visual	编程实现与数据图表	按建模报告编写可复现代码、运行求解、验证约束、生成数据驱动图表 PDF → code/、results/、figures/、reports/RESULTS_REPORT.md
4drawio	非数据图示绘制	技术路线图、求解流程图、模型结构图等 DrawIO 图并导出 PDF → figures/*.drawio、figures/*.pdf、reports/DRAWIO_REPORT.md
5writing	国赛论文撰写	按国赛写作模板组织章节、选择排版引擎、按章节直接插入图表 → paper/
6verity	验证与验收	检查章节结构、图表引用、数值一致性、占位符、编译与视觉检查 → reports/VERIFY_REPORT.md

国赛论文写作模板（`5writing` 依据）

文件	内容
mathmodel-writing-template.md	国赛论文写作规范蒸馏版：标题句式、摘要三段式（前言/逐问建模思路/总结升华）、问题重述防查重改写、问题分析三要素、五类模型假设、三线表符号说明、建模四步（预处理/建立/求解/分析）、模型检验、优缺点评价、参考文献格式速查、附录写作检查清单
main.tex	国赛 LaTeX 模板（对应 Typst zh/cumcm），ctexart + xelatex 编译，内置摘要页、目录页、参考文献、附录、三线表等自定义命令

支持 **Typst 与 LaTeX 双引擎**：Typst 使用 `typst compile`，LaTeX 使用 `xelatex`（跑两遍解决交叉引用）。

国赛模型选择库（`math-model-selection`）

按赛题关键词判断问题类型（评价 / 优化 / 预测 / 随机过程 / 智能优化），推荐对应模型：

AHP、熵权法、TOPSIS、灰色关联、线性/非线性/0-1 规划、最小费用最大流、最短路、马尔可夫链、遗传算法、模拟退火、NSGA-II、时间序列

内置 **国赛 B/C 题关键词快速匹配库**、组合模型使用策略（评价+排序、预测+优化、整数规划+图论等）与"模型选择口诀"，覆盖国赛 A/B/C 题从