EZ math model

English · 技能星图 · 安装 · 工作流 · 交付内容

EZ Math Model 是面向数学建模竞赛与课程项目的 Agent Skill。把题面和数据附件交给 Codex 或 Claude Code，它会沿固定的七阶段流程完成题目解析、建模、Python 求解、论文撰写、质量审查与标准打包。

适用于 CUMCM、MCM/ICM、研究生数学建模竞赛，以及具有多小问、数据附件和论文交付要求的课程建模任务。

一次运行会得到什么

赛题 + 数据附件
      │
      ▼
题目解析 → 建模方案 → Python 求解 → 图表与结果 → 论文 → 质量审查
      │
      ▼
output.zip
├── output/source code/
├── output/paper/paper.md
├── output/paper/paper.docx
├── output/paper/paper.txt
├── output/paper/paper.pdf
└── output/附件文件夹/

这不是只生成一段答案的提示词。Skill 会创建独立的 runtime/ 保留中间证据，并通过 staging、对象级导出审查和 manifest 一致性检查发布最终 output/ 与 output.zip。

核心能力

环节	真实能力
输入理解	读取 PDF、DOCX、Markdown、CSV、XLSX 与混合附件；识别赛事、年份、题号、小问和输出语言
建模与求解	从优化、预测、评价、图论、统计、综合建模、机器学习算法库选择方案，并编写、执行 Python 脚本
图表与论文	生成结果表与图表，执行 chart manifest 质量门；按中文或英文模板组织论文
写作编排	内置 PaperOrchestra 子 Skill，用于大纲、文献、章节成文与精修
质量审查	检查图文绑定、公式、表格、模板残留、工程痕迹，以及 DOCX/PDF 中的图片、公式和表格对象
可追溯交付	区分 formal、demo、blocked；使用 staging 原子发布并核对 output/、manifest 与压缩包

缺少关键附件时，Skill 不会静默合成数据并冒充正式结果：

• formal：真实输入齐全，可生成正式结论。
• demo：用户明确允许示例或合成数据，仅用于验证流程。
• blocked：缺少关键输入且未授权 demo，停止并输出诊断。

安装

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

要求：Python >= 3.10。Pandoc、MinerU、LibreOffice、OpenAlex 和 Semantic Scholar 等均为按需启用的可选工具。

第一次成功运行

1. 新建一个项目总文件夹。
2. 将题面、要求、补充说明和数据附件放入 用户输入/。
3. 在这个项目总文件夹中打开 Codex 或 Claude Code。
4. 连同题面与附件一起发送：

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

首次运行会先完成 setup gate。永久工具决策只在用户确认后写入；如果仅使用本次临时默认，最终状态最高为 provisional。

运行目录会整理为：

项目总文件夹/
├── 用户输入/             # 题面、数据、需求与补充说明
├── runtime/              # 每次运行的中间产物、状态与审查证据
├── output/
│   ├── source code/
│   ├── paper/
│   │   ├── paper.md
│   │   ├── paper.docx
│   │   ├── paper.txt
│   │   └── paper.pdf
│   └── 附件文件夹/
└── output.zip            # 面向用户的最终交付包

七阶段工作流

下列路径均相对 skills/ez-math-model/。

#	阶段	契约文件	关键产出
00	Setup + 环境检查	pipeline/00-environment-setup.md	setup 状态、环境检查、标准目录
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	Python 源码、结果表、图表、chart manifest
04	论文撰写	pipeline/04-paper-writing.md	paper.md
05	质量审查	pipeline/05-quality-audit.md	quality_report.json、quality_report.md
06	打包交付	pipeline/06-packaging-output.md	四格式论文、manifest、output.zip

想了解角色、算法库与子工具之间的完整关系，请查看 技能星图。

交付内容

正式交付不只检查“文件是否存在”。质量门还会核对：

• 图表是否全零、全相等、平线、坐标压缩、不可读或语言不一致。
• 论文中的图片、公式和表格是否与导出 DOCX 对象对应。
• PDF 是否使用了低保真的 text-only fallback。
• output/manifest.json 中的验证状态是否有质量审查证据。
• staging 中的输出、最终 output/ 与 output.zip 是否一致。