MathModelAgent Skill：把数学建模比赛 3 天压成 1 小时的端到端自动化

在 GitHub Trending 的 Agent Skill 赛道上，多数仓库瞄准的是写代码、画架构、做检索这一类「通用工程师」场景。但 9 月第一周的 trending 报告里，出现了一个明显偏垂直的异类——MathModelAgent：一个把「数学建模比赛」全流程封装成 SKILLS 的中文社区项目，让 Claude/Codex 直接产出可以提交到国赛、华数杯、华为杯、MCM/ICM 的 PDF 论文。对于被 3 天 72 小时建模赛折磨过的同学来说，这等于把赛期压到 1 小时。

总结

MathModelAgent 是一套面向「数学建模比赛」垂直场景的 Agent Skills 合集，把问题分析、模型选型、代码生成、图表绘制、Typst 排版与论文验收 9 个阶段拆成可独立调用的 Skill，配合 17 套比赛模板与 RAG 知识库，让 Claude Code 或 Codex 在一条 /1start-mathmodel 命令下，端到端输出一份可直接提交的建模论文。它在 GitHub trending 被多个 AI 周榜点名，原因是切准了「数学建模 = 限时高压写作 + 多类型模板」的痛点，是 Agent Skill 走向「行业纵深」的代表性项目。

功能与原则

核心能力覆盖建模比赛全链路：
– 自动分析赛题、选择模型、编写并自检代码
– Code Interpreter（本地 Jupyter / E2B / Daytona 云端三选一）
– 17 套 Typst 论文模板（国赛、华数杯、华为杯、MCM/ICM 等）
– 建模知识库 RAG（ChromaDB + Rerank，含 AHP/TOPSIS/ARIMA/GA 等模型决策树与常见易错模式）
– 9 步自动验收（文本泄漏、数值一致性、Typst 编译、PDF 可视化）
– HIL 人机协作（关键节点暂停 6 种决策动作）
– 四层容错（重试 → Fallback → Evaluator Shadow → Feedback Rerun）

设计原则：纯 SKILLS 驱动、不做 Harness 层——作者明确说「项目以后只会做 SKILLS 层迭代」，任何兼容 Claude Code / Codex 的 agent 都能直接装上使用，可单独调用某个阶段（如只跑分析、只写论文）。

认可度

• GitHub Stars：4,394（截至 2026-09-08，API 实时核对）
• Forks：369，Watchers：4,394
• Releases：18 个（最新 v0.0.17，发布于 2026-09-08）
• 桌面版装机量活跃，作者同步托管了一个在线版 mathmodel.top
• 出现在 GitHub 周榜 trending report 与中文 AI 周报多份盘点（startupcorners、devpress、quidproquo 等）
• Topics：agent, llm, mathmodel, skills
• 第三方宣传自荐帖（2026-06-07 GitHub Discussions）讨论度高

链接

GitHub：https://github.com/jihe520/MathModelAgent
Releases（桌面版）：https://github.com/jihe520/MathModelAgent/releases/latest
在线体验：https://mathmodel.top/home

原作者

jihe520（GitHub username，74 个 commits，74 个 PR）
简介：中文社区独立开发者，长期深耕 Agent + Skills 方向。除了 MathModelAgent，还维护姊妹项目 jihe520/sci-box（科研绘图与流程图 SKILL 合集）。项目从 2025-01-30 立项，迭代至今已重构为「完全 SKILLS 驱动」架构。
其他贡献者：MuWinds（6 commits）、HP-Patience（5）、YangChengyi-dev（4）、GreyJohnny（2）。

介绍

MathModelAgent 解决的是一类非常具体但强需求的存在：全国大学生数学建模竞赛、国赛、华数杯、华为杯、MCM/ICM 这类限时比赛中，参赛者通常要在 72 小时内同时完成选题、文献、建模、代码、写作、排版六件事，而其中 80% 的工作是模板化、可重复的。

它把这件事拆成两条线同时跑：
– Agent 工作流线：分析手 → 建模手 → 代码手 → 论文手 四个 multi-agent 协作，每个 subagent 可挂不同模型（通过 litellm 接入任意模型）
– SKILLS 知识线：把建模规范、模型决策树、常见易错模式、比赛模板都做成独立 SKILL，按需加载到上下文

最终输出是一份编排好的、可直接打印的 PDF 论文。配合桌面版（macOS/Windows 一键安装，内置 Claude Code + 全部 SKILLS，填一个 API Key 即可开始），它把 3 天的比赛压到了「1 小时出一份获奖级初稿」的工程目标。

最近发布（v0.0.17，2026-09-08）进一步把项目结构收敛到「只做 SKILLS、不做 Harness」的定位，对 Claude Code / Codex / OpenClaw 等任意支持 SKILL.md 的 agent 友好。

特点

• 完全 SKILLS 驱动：每个阶段（分析、建模、代码、写作、验收）是独立 Skill，可单跑也可串跑；不绑定任何 Agent 框架
• 17 套 Typst 论文模板：覆盖国赛、华数杯、华为杯、MCM/ICM 等主流赛事，自动匹配赛事类型
• RAG 知识库内置：ChromaDB + Rerank 检索建模方法、代码模板、写作参考，每个阶段自动参考，降低模型幻觉
• 9 步自动验收：文本泄漏检测 → 数值一致性校验 → Typst 编译 → PDF 可视化，确保零低级错误
• 桌面版 + 在线版双形态：零环境门槛，填 API Key 即可；macOS 已签名公证，Windows 后续启用签名
• 多模型 + 多 Agent：每个 subagent 可挂不同模型（DeepSeek 写代码 / Claude 写论文等），实现「按任务分配大脑」

使用方法

最简路径（推荐）：下载桌面版，安装后填一个模型 API Key 即可。

开发者路径：

# 一行安装全部 SKILLS
npx skills add jihe520/MathModelAgent --all

# 在 Claude Code 中调用
claude --dangerously-skip-permissions
# 进入后输入：
# /1start-mathmodel 完成这个数学建模任务

# 在 Codex 中调用
codex --yolo
# $start-mathmodel 完成这个数学建模任务

关键命令：
– /1start-mathmodel：一站式完成建模全流程
– /doctor：检查环境配置（API Key、Typst、依赖等）
– /typst-author：Typst 排版知识补全

姊妹项目 sci-box（科研图表与流程图）可单独安装：npx skills add jihe520/sci-box

使用场景与人群

适用场景：
– 全国大学生数学建模竞赛（国赛 / 华数杯 / 华为杯 / MCM/ICM）
– 课程作业、毕业设计中需要「数模 + 论文排版」的环节
– 教师 / 助教快速产出参考答案、范例论文
– 科研团队做可重复的「建模 + 写作」pipeline

目标用户：
– 数学建模比赛参赛者（学生 / 指导老师）
– 高校数学 / 统计 / 工程类实验室的研究助理
– 把「限时高质量写作」当作通用能力的 Agent 开发者（可参考其 SKILL 模块化设计）
– 想做垂直 Agent Skills 创业的团队（MathModelAgent 是「行业纵深 + SKILLS 标准化」的代表案例）

输入与输出案例

输入：一段建模赛题文本（如「2026 年 MCM A 题：分析某地区太阳能资源分布与电网负荷的时空匹配关系，给出最优并网方案」）+ 选用「MCM/ICM」模板。

输出：
– 一份完整的 PDF 论文（Typst 排版，含摘要、模型假设、符号说明、模型建立、求解、灵敏度分析、结论、参考文献、附录代码）
– 一份 Jupyter Notebook（建模代码可二次运行与修改）
– 配套图表 PNG / PDF / SVG（SHAP、ROC、Taylor 等科研级图表）
– 验收报告（9 步自动验收结果：文本泄漏 0 / 数值一致性通过 / Typst 编译成功 / PDF 页数与字数符合模板规范）

最小 SKILL 调用示例（只跑分析）：

# Claude Code 中
/1start-mathmodel --only=analysis
# 输入：2026 MCM A 题文本
# 输出：赛题拆解报告（关键变量、约束条件、可能的模型方向、推荐模型 Top 3），耗时约 5 分钟

GitHub: https://github.com/jihe520/MathModelAgent