MathModelAgent 教程：数模比赛从 3 天压缩到 1 小时

📌 项目日期：2026年9月 | 数据来源：GitHub官方仓库 | 星数：4.8k+

📋 项目简介

MathModelAgent（4.8k 星，单日 +132）是一个数学建模 Agent，愿景很直白：把 3 天的数模比赛流程压缩到 1 小时。你在 Claude Code 或 Codex 里输入 /1start-mathmodel 一条命令，它就从数据一路跑到论文成稿——17 套 Typst 赛事模板、内置建模知识库、9 步自动验收全部串起来。想配更完整的科研技能体系，可先读 scientific-agent-skills教程：163个技能把AI代理变成AI科学家（37k星）。

✨ 核心特性

特性	说明
一条命令端到端	/1start-mathmodel 从数据→建模求解→论文成稿全流程串联
17 套 Typst 模板	覆盖国赛、华数杯、华为杯、MCM/ICM 等主流赛事版式
建模知识库	AHP/TOPSIS/ARIMA/GA 选型决策树 + 易错模式 + 评分标准
9 步自动验收	文本泄漏检查→数值一致性→Typst 编译→PDF 可视化逐关校验
桌面版免环境	内置 Claude Code + 全套 SKILLS，不用装 Python/Node/Redis
双运行形态	桌面版独立运行，或 skill 装进已有 Claude Code/Codex
姐妹项目 sci-box	npx skills add jihe520/sci-box 科研场景技能包

🏗️ 工作原理

比赛题目 / 数据集
   │
   ▼
/start-mathmodel（一条命令启动）
   │
   ├──→ 建模知识库选型（AHP / TOPSIS / ARIMA / GA 决策树）
   ├──→ 求解与实验（代码 + 数值结果）
   └──→ Typst 论文生成（17 套赛事模板任选）
   │
   ▼
9 步自动验收
（文本泄漏 → 数值一致性 → Typst 编译 → PDF 可视化）
   │
   ▼
成品论文 PDF（人工复核后提交）

🚀 安装与上手

# 形态A：桌面版（推荐新手，免环境）
#   GitHub Releases 下载：
#   macOS  .dmg（已签名公证，直接装）
#   Windows .exe（未签名，SmartScreen 点"仍要运行"）
#   内置 Claude Code + 全套 SKILLS

# 形态B：skill 装进已有 CLI agent
npx skills add jihe520/MathModelAgent --all

# Claude Code 里运行：
#   /1start-mathmodel
# Codex 里运行：
#   $start-mathmodel

# 姐妹项目：科研技能包 sci-box
npx skills add jihe520/sci-box

💡 使用建议

• 模板先对齐赛事：开跑前先选定目标赛事对应模板（国赛/MCM 等 17 套），避免成稿后再换版式返工。
• 把自动验收当第一道质检：9 步验收（数值一致性、文本泄漏等）全过后再进入人工复核，效率最高。
• 功能边界要心里有数：HIL 人机协同、Feedback 反馈闭环、RAG 检索等在 README 中标注为规划中/未完全实现，现阶段以"一条命令端到端"主线为主。
• AI 生成仅供参考：项目自述处于实验 demo 阶段，比赛提交前务必逐节人工复核——这是使用底线。
• 排版细节延伸：中文公文场景的排版 skill 可看 gongwen-gbt9704-skill教程：333星GB/T 9704公文排版AI Skill，插图风格统一可配 Handraw Style教程：手绘风格编号画廊+双语提示词Skill，AI绘图风格一键统一。
• 授权注意：个人免费使用，禁止商用。