EZ Math Model

English README | 技能星图 | SkillsMP

EZ Math Model 是一个面向数学建模竞赛的可上架 Agent Skill。它把题目和附件交给智能体后，按固定流程完成：setup 授权、题目解析、模型选择、Python 求解、绘图、论文撰写、质量检查和标准打包交付。

适用场景包括全国大学生数学建模竞赛、MCM/ICM、美赛、研究生数学建模竞赛，以及课程里的建模作业。

QQ 交流群

群号：1106854834

EZ数学建模 QQ 群二维码

能做什么

读取 PDF、DOCX、Markdown、CSV、XLSX 和混合附件。
按项目总文件夹创建 用户输入/、runtime/、output/ 三段式结构。
首次运行强制完成 setup；未经用户确认不会写永久工具决策。
显式区分 formal、demo、blocked，缺关键附件不会静默合成数据冒充正式结果。
识别赛事、年份、题号、小问、数据附件、输出语言等信号。
从内置算法库中选择优化、预测、评价、图论、统计、综合建模或机器学习方案。
编写并执行 Python 脚本，导出结果表和图片。
生成图表 manifest v2，剔除全 0、全相等、平线、坐标压缩、不可读、语言不一致等废图。
按中文或英文模板撰写建模论文，并在 formal 交付前抽取优秀论文格式作参考。
论文手内置 PaperOrchestra 写作编排子 skill，用于大纲、文献、成文与精修。
在交付前运行可执行质量门，检查图文绑定、公式、表格、模板残留和工程痕迹。
导出后审查 DOCX/PDF 对象，统计嵌入图片、Word 公式、Word 表格和 PDF fallback。
通过 staging 原子发布，避免 output.zip、manifest 和 output/ 不一致。
产出 output/paper/paper.md、paper.docx、paper.txt、paper.pdf，并把总文件夹打包为 output.zip。

SkillsMP 上架结构

EZ_math_model/
├── README.md                # 中文主 README
├── README.en.md             # 英文 README
├── STAR_MAP.md              # 技能星图
├── package.json             # 包与市场元数据
├── marketplace.json         # SkillsMP 展示元数据
├── manifest.json            # 内部资源索引
├── VERSION
└── skills/
    └── ez-math-model/
        ├── SKILL.md         # skill 主入口
        ├── pipeline/        # 七阶段流程契约
        ├── prompts/         # coordinator/modeler/coder/writer prompts
        ├── references/      # 算法库、角色守则、容错协议
        ├── templates/       # 论文模板和工作目录模板
        ├── tools/           # 子 skills，每个目录都有 SKILL.md
        ├── scripts/         # 安装和运行时辅助脚本
        └── external/        # 运行时外部资料和用户 corpus

安装

Codex:

gh skill install woodfishhhh/EZ_math_model skills/ez-math-model --agent codex --scope user

Claude Code:

gh skill install woodfishhhh/EZ_math_model skills/ez-math-model --agent claude-code --scope user

如果本机已经装过旧版，加 --force 覆盖：

gh skill install woodfishhhh/EZ_math_model skills/ez-math-model --agent codex --scope user --force

然后在对话里说：

用 ez-math-model 做这道数学建模题。

同一轮把题面和数据附件一起发给它。

标准使用流程

新建项目总文件夹。
把题面、需求、补充说明、数据附件放入 用户输入/。
在项目总文件夹打开 Codex / Claude Code，并调用 ez-math-model。
首次运行按提示完成 setup；如果只按临时默认继续，最终结果会标记为 provisional。
运行结束后查看 output/，交付给用户的是项目根目录的 output.zip。

标准运行目录：

项目总文件夹/
├── 用户输入/
├── runtime/
└── output/
    ├── source code/
    ├── paper/
    │   ├── paper.md
    │   ├── paper.docx
    │   ├── paper.txt
    │   └── paper.pdf
    └── 附件文件夹/

主流程

本节路径均相对 skills/ez-math-model/。

阶段	文件	关键产出
00 Setup + 环境检查	`pipeline/00-environment-setup.md`	setup 状态、`runtime/`、标准目录
01 题目解析	`pipeline/01-problem-intake.md`	`problem.md`、`intake.json`、`run_state.json`、附件预览
02 建模方案	`pipeline/02-modeling-plan.md`	`modeling_plan.md`
03 代码求解	`pipeline/03-coding-solve.md`	`src/.py`、`results/`、`figures/*.png`、`chart_manifest.json`
04 论文撰写	`pipeline/04-paper-writing.md`	`paper.md`
05 质量审查	`pipeline/05-quality-audit.md`	`quality_report.md`
06 打包交付	`pipeline/06-packaging-output.md`	`output/paper/*` 四格式、`output/manifest.json`、`output.zip`

内置子 Skills

本节路径均相对 skills/ez-math-model/。

能力域	入口
PDF 与 OCR 兜底	`tools/pdf/SKILL.md`、`tools/mineru/SKILL.md`
Word 与表格	`tools/docx/SKILL.md`、`tools/xlsx/SKILL.md`
文献与网页上下文	`tools/paper_search/SKILL.md`、`tools/scholar/SKILL.md`、`tools/webcrawl/SKILL.md`
公开数据集发现	`tools/dataset/SKILL.md`
用户资料库索引	`tools/user-corpus-explorer/SKILL.md`
论文写作编排	`tools/paper-orchestra/SKILL.md`
流程辅助	`tools/brainstorming/SKILL.md`、`tools/systematic-debugging/SKILL.md`、`tools/verification-before-completion/SKILL.md`
结果润色	`tools/humanizer/SKILL.md`、`tools/simplify/SKILL.md`、`tools/scientific-slides/SKILL.md`
Agent 编排	`tools/dispatching-parallel-agents/SKILL.md`、`tools/subagent-driven-development/SKILL.md`、`tools/external-context/SKILL.md`

完整能力关系见 STAR_MAP.md。

运行时策略

仓库不内置上游优秀论文和用户私有材料。工具决策和可选参考资源放在 skills/ez-math-model/external/，并由 .gitignore 排除：

skills/ez-math-model/external/zhanwen-mathmodel/：可选拉取的上游优秀论文。
skills/ez-math-model/external/paper-orchestra/：vendored PaperOrchestra 写作 skill pack。
skills/ez-math-model/external/user-corpus/：用户自己的论文、教材、笔记和题解。
skills/ez-math-model/external/tools/：本机工具启用决策。

密钥使用 EZMM_ 环境变量，不写入仓库。

用户项目的运行时文件不写入 skill 安装目录，而是写入项目总文件夹的 runtime/ 和 output/。

许可

MIT。详见 LICENSE。

EZ_math_model