Back to search
meta-model-agent
SkillWorks with Claude CodeGitHub
Meta-model-agent 致力于辅助研究者与参赛团队完成高质量数学建模研究和论文产出,提供从问题理解、模型构建、计算实验、证据可视化到论文写作、冠军级多轮审稿与提交验收的完整工程支持。适用于 CUMCM、51MCM、MCM/ICM 及同类数模研究任务,可用于启动或恢复项目、按证据门禁推进、修复薄弱环节并形成可复现、可验证、可提交的高质量数模论文。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/wuxinbo-bo--math-model-skills)HTML
<a href="/listings/wuxinbo-bo--math-model-skills"><img src="/api/listings/wuxinbo-bo--math-model-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 212 lines
- ---
- name: meta-model-agent
- description: Meta-model-agent 致力于辅助研究者与参赛团队完成高质量数学建模研究和论文产出,提供从问题理解、模型构建、计算实验、证据可视化到论文写作、冠军级多轮审稿与提交验收的完整工程支持。适用于 CUMCM、51MCM、MCM/ICM 及同类数模研究任务,可用于启动或恢复项目、按证据门禁推进、修复薄弱环节并形成可复现、可验证、可提交的高质量数模论文。
- ---
- # Meta-model-agent
- Meta-model-agent v1.3 是面向数学建模研究与竞赛论文生产的工程化辅助系统。它将题意研判、数学建模、程序求解、结果验证、图形表达、论文组织和提交检查连接为一条可执行、可恢复、可审计的研究链,帮助使用者把零散的分析过程转化为证据完整、逻辑一致且能够复现的高质量数模论文。
- ## 项目说明
- 本项目的核心目标不是简单生成一篇论文文本,而是辅助完成从研究问题到最终论文的完整质量闭环:先建立可信的问题与模型契约,再通过真实计算获得结果,以图形、表格和结构图组织证据,最后形成符合竞赛规范的论文并接受多轮质量审稿。
- 项目优先适配 Codex,并兼容能够读取 Skill、访问工作区和运行本地命令的其他 AI 工具。Meta-model-agent 仅提供数学建模辅助;实际使用者必须核验题意、数据、模型、程序、引用、结果与最终论文,并自行承担采用或提交相关产出的风险。
- 项目按照研究依赖组织工作,并提供三层质量能力:
- - `baseline`:保持阶段、交付物和门禁稳定,保证完整流程能够可靠运行;
- - `enhancement`:针对模型、程序、证据链或论文薄弱项实施受控返工;
- - `championship`:在最终验收前执行多轮独立模拟审稿和全文修订,以更高标准检验数学正确性、可复现性、逻辑一致性、表达质量与提交合规性。
- Meta-model-agent 强调研究证据优先。论文中的公式、数值、图表和结论应能追溯到题面、模型、程序或结果文件;若上游证据存在根本问题,系统应回退相应阶段修复,而不是仅通过文字润色掩盖缺陷。
- ## 条件数据准备路线
- 数据准备是七阶段内的条件子流程,不新增顶层阶段:DISCOVERY 声明 `supplied/collected/none` 数据模式,FORMULATION 定义预处理合同,COMPUTATION 按“质量审计 → 题目驱动预处理 → 前后质量核验 → 冻结模型输入 → 模型计算”执行。无数据时必须明确豁免且不得伪造预处理产物;有数据时模型只能读取 `数据/processed/` 下经过哈希固化的规范输入。预处理方法必须由字段类型、数据质量、时间/空间结构和模型需求决定,禁止对所有题目套用同一个清洗脚本。
- ### 模型身份与算法分离合同
- - FORMULATION 在现有 `建模报告.md` 中分开登记审计身份与论文表达,不新增文件。建立或扩展模型的子问题写 `模型定义`、`模型结构`、`模型语义` 和 `论文表达`;模型扩展另写 `模型增量`。仅做比较、验证或应用的子问题只写 `论文表达`,并明确继承的上游模型,禁止强造新模型。
- - `论文表达 QN | 展示名称: ... | 问题角色: new_model/model_extension/comparison/validation/application | 继承模型: none/QN,... | 核心方法: ...`。展示名称必须是简洁、可发表的模型名;内部机制、方案代号、运行预算、验证器和工作文件名不得塞入展示名称。
- - 正式名称使用“题目定制机制 + 标准数学模型”格式,例如“考虑维护约束的机组承诺混合整数线性规划模型”“基于季节项与滞后项的动态回归模型”。`优化模型`、`决策模型`、`预测模型`、`综合模型`等泛化名称不能单独通过;标准模型族必须能识别为线性/整数/鲁棒/随机规划、车辆路径、网络流、回归、时间序列、状态空间、微分方程、多指标决策、仿真等明确结构。
- - 数学模型、定制机制和求解算法必须分开:模型回答变量如何关联以及目标/约束是什么,定制机制说明题目特有结构,算法只说明如何求解。HiGHS、Gurobi、分支定界、遗传算法、粒子群、匈牙利算法等不得冒充数学模型。
- - COMPUTATION 必须在现有 `图表/全部结果.json.model_identity` 中逐问固化名称、模型族、求解算法及模型语义字段,并与 FORMULATION 身份卡逐字一致;不新增结果文件。
- - MANUSCRIPT 正文保持模型语义一致,但不复制内部身份卡句式。摘要使用论文表达卡中的展示名称和核心方法;比较、验证或应用类问题应写“基于前述模型进行……”,不得伪造独立数学模型。
- ### 统一机理与逐问增量合同
- - FORMULATION 必须先识别跨问题复用的机制内核,再按 `new_model/model_extension/comparison/validation/application` 组织后续问题。后续问题不得重复包装前问,也不得仅因更换算法就宣称建立新模型。
- - `new_model/model_extension` 在现有 `建模报告.md` 中增加模型语义卡,明确目标数量、方向、变量类型、关系类型和多目标证据;多资源、高维决策或多个评价指标不自动构成多目标优化。
- - `model_extension` 另登记继承方程、新增变量、新增/修改约束、目标变化、求解变化和验证变化。扩展后的验证必须针对新增机制。
- - 物理、几何、事件、仿真和混合决策题优先形成“状态/机制内核 -> 判定或事件集合 -> 外层优化/分配 -> 执行方案”的连续主线。具体合同见 `references/model-quality-contracts.md`。
- - COMPUTATION 使用现有 `全部结果.json.publication_claims` 固化发布数值、来源键和派生关系;摘要、正文、图表与结论不得各自手抄同一结果。
- ### 摘要内容合同
- - 中文竞赛摘要按“总述—逐问—评价”组织:首段说明问题、核心矛盾、主要数学模型及任务;中间每个子问题用自然学术语言写“简洁模型名或继承关系—核心方法—1 至 2 个关键结果—验证结论”;尾段总结模型的可解释性、稳健性、推广性和局限性。
- - 摘要不得出现“标准模型族为”“冻结合同”“统一验证器”“搜索预算”“Q1/Q2 求解器”等字段化或内部工作流语言;不得罗列初始化、修复、加速、校验等完整算法链。方案缩写首次出现必须解释,结果数字服务于结论而不是形成流水账。
- - 关键词优先使用标准模型族和核心求解算法,通常 3--5 个,例如“混合整数线性规划、动态回归、车辆路径、鲁棒优化”;不得只使用自创长名称,也不得用“研究、分析、结果、优化问题”等空泛词。
- - MCM/ICM 的英文 Summary Sheet 使用同一信息链,并额外保留 recommendations 与 limitations;模型名和算法名必须与正文一致。
- - 摘要必须最后写,所有模型名、算法名、数值和检验结论均从当前有效正文与验证证据提取,不得凭规划阶段记忆补写。
- ### 论文版面与正文密度硬约束
- - 图表文件的原始画布尺寸不是论文嵌入尺寸。LaTeX 普通图默认使用 `width=0.72\linewidth,height=0.70\textheight,keepaspectratio`,再按可读性调整;宽表或宽图最高不得超过 `\linewidth`,禁止依赖 PDF 查看器裁切超出版心的内容。
- - DOCX 中按页面可用宽度缩放图表:A4 常规页边距下正文图推荐宽 13.5--15.0 cm,绝不超过实际版心宽;必须锁定纵横比,禁止把像素尺寸或厘米尺寸原样放大到页面之外。
- - 图表过大或导致页数超限时,优先裁除空白边缘、合并相关子图、精简重复图、缩短图注、将次要图表移至附录;不得通过把整张图缩到文字不可读来“塞进页面”。图中文字在最终 PDF/DOCX 的 100% 显示比例下必须可读。
- - `MAX_PAGES` 是上限,不是正文字数目标。页数紧张时必须优先保护问题分析、模型机制、公式推导、求解过程、验证、结果解释和局限性,不能为了满足页数而删成只有结论和图表的空心论文。
- - 页数合规与正文充分性必须分别验收。即使 PDF 未超页,若任一子问题缺少“机制/推导 -> 结果 -> 验证 -> 解释”,或正文有效字数明显不足,仍不得通过 MANUSCRIPT/ASSURANCE 门禁;禁止用放大字号、拉大行距、堆图或空泛文字补页。
- - CUMCM 按 2026 官方规范执行:摘要原则上不超过 1 页,正文不要目录且不超过 30 页,附录单独计数且页数不限。必须通过编译后的 `AbstractStart/AbstractEnd` 与 `BodyStart/BodyEnd` 标签实测,禁止用字符估算代替最终门禁。
- - 普通图默认使用 `0.72\linewidth`,`0.85\linewidth` 仅作为普通宽图建议上限;确需更宽时最高不得超过 `\linewidth`,并始终启用 `keepaspectratio`。普通 LaTeX 图表使用 `[htbp]` 并在章节边界用 `\FloatBarrier` 收束,禁止全篇强制 `[H]` 造成空白页和页数膨胀;只有模板或局部版式明确要求时才允许少量 `[H]`。
- - LaTeX 核心公式必须使用原生数学环境,执行“机制引入 -> 编号公式 -> 符号/单位/定义域 -> 公式作用”的语义顺序;禁止公式截图、公式无解释堆叠和手写图表公式编号。具体规则见 `references/paper-layout/latex-math.md`。
- - ASSURANCE 必须审计最终 PDF 的页面构成,不以编译成功代替排版通过。重点检查低页面占用率、标题孤悬、正文孤行、图题分离、跨页表头、极小文字、连续大图和密度突变,见 `references/paper-layout/page-composition.md`。
- ### 图表与流程图克制表达硬约束
- - 每张图和每个 `TABLE_*` 表必须登记明确论点、数据来源和读者任务;使用 `图表/figure_manifest.json` 的 `figures/tables` 区分正文、附录和诊断资产,只有 `publish=true` 的图表必须嵌入正文。
- - 图表同时登记所属问题、`mechanism/result/validation/decision/diagnostic` 视觉角色和所依赖的结果键。正文证据按“机制 -> 结果 -> 验证/决策”组织,不以图表数量替代论证。
- - 图形类别按数据结构和读者任务选择,禁止为了“高级感”或多样性强制使用渐变、阴影、圆角标注框、KDE 背景和无必要多层叠加。
- - 所有 DrawIO/TikZ 流程图中的普通矩形、矩形容器和表头必须使用直角矩形;菱形、圆形、六边形、圆柱、平行四边形等其他语义形状保持不变。
- - AI Image 默认关闭,禁止用于技术路线图、流程图和模型架构图;仅在用户明确需要且经过内容级核验的物理场景示意中使用。
- ### 代码附录硬约束
- - COMPUTATION 必须生成 `程序/code_manifest.json`,登记入口、逐问程序、依赖、代码行数和源码哈希。
- - MANUSCRIPT 必须运行 `工具/build_code_appendix.py`,从当前源码自动生成附录;禁止用一段复现说明或“代码见支撑材料”替代真实核心实现。
- - 三种赛制的论文附录均只嵌入主程序和逐问核心实现;数据处理、绘图、校验及公共工具仅进入支撑材料清单,不展开完整源码。附录中的程序显示名统一使用英文,真实路径和源码哈希仅保留在机器审计标记中。源码哈希、附录标记和运行入口不一致时不得通过门禁。
- ## 快速启动
- 1. 在目标工作目录初始化运行时工作区:
- ```bash
- python scripts/workspace_init.py --workspace . --competition cumcm --output-format pdf
- ```
- `--competition` 支持 `cumcm`、`51mcm`、`mcm-icm`。竞赛类型会写入状态并控制模板与硬门禁;如需更换竞赛,应重新初始化工作区并重新执行论文及验收阶段。
- `--output-format` 支持 `pdf`(默认)和 `docx`。DOCX 路线以 `论文/论文正文.md` 为写作源,使用 `python 工具/docx_export.py --workspace .` 生成 `论文/数模论文.docx` 与图片尺寸报告。
- 2. 查阅 [references/workflow-map.md](references/workflow-map.md)。
- 3. 查询当前阶段:
- ```bash
- python scripts/stage_executor.py current --workspace .
- ```
- 4. 启动当前阶段,自动化同步该阶段所需的 `工具` / `参考资料` / `模板`:
- ```bash
- python scripts/stage_executor.py begin DISCOVERY --workspace .
- ```
- 5. 仅加载当前阶段的实施协议:
- - `references/stage_protocols/<skill-name>/SKILL.md`
- - 如该阶段有额外 `references/` 或 `templates/`,只加载当前阶段需的文件。
- 6. 阶段实施完毕后,严格按下面次序收口:
- ```bash
- python scripts/stage_executor.py validate DISCOVERY --workspace .
- python scripts/stage_executor.py gate_check DISCOVERY --workspace .
- python scripts/stage_executor.py complete DISCOVERY --workspace . --artifacts "问题分析.md"
- ```
- 7. 若该阶段有核验点,继续处理核验点:
- ```bash
- python scripts/stage_executor.py checkpoint DISCOVERY --workspace . --action approve --note "checkpoint passed"
- ```
- ## 实施准则
- ### 冠军质量模式
- 需冲击最高质量时,先设定冠军模式:
- ```bash
- python scripts/pipeline_manager.py set-mode championship --workspace .
- ```
- 冠军模式保持问题分析、模型构建、计算实验、证据整理、论文写作与提交验收之间的依赖关系不变,并在论文写作完成后强制加入多轮模拟审稿。载入 `references/stage_protocols/championship-review/SKILL.md` 和 `references/championship-review-method.md`,依次开展独立审稿、修订规划、全文重写与逐项复核。完成不少于三轮,且终版满足 P0 为 0、P1 不超过 2、综合分不低于 85 后,方可转入提交质量验收。
- ### 1. 严守 `baseline` 基线
- - 默认运行模式为 `baseline`。
- - 基线运行严禁打乱上游与下游依赖、缩减交付物目录、改变核验点类别、降低最低文件规模或取消伴随文件条件。
- - 只有完整基线证据通过后,才能启动增强处理。
- ### 1.1 严格执行竞赛 Profile
- - 初始化时将竞赛类型、语言、模板、允许/禁止身份字段、字号和页数限制写入状态。
- - `MANUSCRIPT` 只能同步当前竞赛模板,不得混用其他竞赛封面或文档类。
- - MCM/ICM 强制英文、至少 12pt、Summary Sheet、Control Number 且完整 PDF 不超过 25 页。
- - 51MCM 强制 `51mcmthesis` 电子提交模式,并移除学校、成员、邮箱和电话字段。
- - CUMCM 使用 `cumcmthesis`,提交前按当届官方通知复核匿名、编号页、页数与附件。
- - 规则变化时先更新机器 Profile 和对应竞赛规则文档,再运行工作流。
- - 论文章节目录允许项目统一采用 `章节/` 或模板原生采用 `sections/`;主文件引用路径必须与磁盘目录一致。
- - 门禁会读取实际竞赛 `.cls`,检查纸张、页边距、基础字号、页眉或摘要页等关键合同,不能仅靠文档类名称通过。
- ### 2. 按阶段渐进加载
- - 严禁一次载入全部研究协议。
- - 先用 `stage_executor.py current` 确认活动阶段,再查阅相应实施协议。
- - 对当前阶段之外的资料,只有在当前协议明确引用时才可加载。
- ### 3. 落实主控与工作角色分层
- - 主控角色负责阶段编排、运行状态落盘、门禁收束、核验点推进和跨阶段一致性维护。
- - 工作角色承担当前阶段内的原子工作项,例如题意拆解、方案质询、程序实现、图形与表格制作以及论文组装。
- - 若运行环境不支撑并行工作角色,可按角色次序实施;交付路线、复核独立性和阶段边界仍须保持不变。
- ### 4. 保持门禁契约稳定
- - 全部阶段都务必核验原产物合同。
- - `computational-realization` 务必同时核验 `程序/主程序.py`、`计算结果.md` 和伴随结果文件。
- - `evidence-visualization` / `systems-diagramming` 共用 `图表/图表引用.tex`,避免误删前一步产物。
- - `manuscript-synthesis` 此后再转入 `delivery-assurance`,不可跳。
- ### 5. 依据证据恢复运行
- - 续跑前先看:
- - `状态/工作流状态.json`
- - `状态/事件日志.jsonl`
- - `python scripts/stage_executor.py status --workspace .`
- - 若某阶段被标记完成,但产物缺失或尺寸不达标,应重新 `begin` 并补做,而不是盲目向前推进。
- ## 项目组成
- - `assets/workflow_manifest.json`: 研究工作流机器可读清单
- - `assets/competition_profiles.json`: 三类竞赛的机器可读模板与合规硬约束
- - `references/workflow-map.md`: 人类可读的过程总图和阶段映射
- - `references/gate-matrix.md`: 各个阶段的机器门禁与人工复核要点
- - `references/phase-control.md`: `baseline -> enhancement` 模式切换准则
- - `references/subagent-architecture.md`: 主控、工作与复核角色的闭环契约
- - `references/enhancement-operations.md`: 增强模式的返工与质量提升方法
- - `references/cumcm-official-notes.md`: 国赛官网准则与时间节点摘录
- - `references/guide-*.md`: 各项研究工作的主控与执行角色指南
- - `references/stage_protocols/`: 研究工作协议及配套参考资料与模板
- - `references/runtime_reference/`: `workflow_engine.py` 与 `agent_runner.py` 的运行参考实现
- - `scripts/workspace_init.py`: 初始化运行时工作区
- - `scripts/stage_executor.py`: 运行状态机、门禁、核验点、断点续跑入口
- - `scripts/gate_contracts.py`: 研究工作流的机器门禁引擎
- - `scripts/pipeline_manager.py`: 总入口、下一步提示、阶段切换
- - `scripts/baseline_smoke.py`: 完整研究工作流基线冒烟校验
- - `scripts/stateful_smoke.py`: 核验 checkpoint rerun、rework 传播、resume 行为
- - `scripts/enhancement_audit.py`: enhancement 阶段的返工与增强推荐入口
- - `scripts/championship_review.py`: 冠军模式多轮审稿、修订和终版论文回写入口
- - `scripts/build_code_appendix.py`: 生成源码哈希清单,并从当前程序确定性构建 LaTeX/DOCX 代码附录
- - `references/championship-review-method.md`: 冠军审稿评分、攻击策略与回退知识库
- - `scripts/state_store.py`: JSON 运行状态存储
- - `assets/shared-scripts/`: 原共享脚本
- - `assets/templates/`: 原论文模板
- ## 最终交付说明
- 完成全部必要阶段后,项目应形成一套能够相互印证的研究成果,包括问题分析、模型报告、可运行程序、结构化结果、论文图形、完整 LaTeX 源稿和最终 PDF。冠军模式启用时,还应保留逐轮审稿报告、修订计划、修改后论文和修复验证记录。
- 最终论文必须满足以下原则:研究过程可解释,关键结果可复现,论文结论有证据支撑,图表与正文保持一致,格式符合目标竞赛要求,并且不存在已知的 P0 级质量问题。
README.md · README · 251 lines
- <p align="center">
- <img src="assets/branding/logo.svg" alt="Meta-model-agent" width="200">
- </p>
- <h1 align="center">Meta-model-agent</h1>
- <p align="center">
- 面向数学建模研究与竞赛论文的可执行、可恢复、可审计工作流
- </p>
- <p align="center">
- <img alt="Workflow" src="https://img.shields.io/badge/Workflow-7%20Stages-0E7490">
- <img alt="Targets" src="https://img.shields.io/badge/Targets-CUMCM%20%7C%2051MCM%20%7C%20MCM%2FICM-2563A8">
- <img alt="Outputs" src="https://img.shields.io/badge/Outputs-PDF%20%7C%20DOCX-6D4CC3">
- <img alt="Platform" src="https://img.shields.io/badge/Primary-Codex-111827">
- <img alt="Version" src="https://img.shields.io/badge/Version-v1.3-16A34A">
- <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-MIT-16A34A"></a>
- </p>
- Meta-model-agent 将题意分析、模型构建、真实计算、结果验证、证据可视化、论文写作和提交验收连接为一条工程化研究链。它优先作为 Codex Skill 使用,也可以由能够读取 Markdown 指令、访问工作区并执行本地命令的其他 AI 工具调用。
- 项目适用于 CUMCM、51MCM、MCM/ICM 及结构相近的数学建模任务。它强调结果可复现和证据一致性,不以单纯生成一篇完整论文文本为目标。
- > Meta-model-agent 只提供研究辅助。题意、数据、模型、程序、引用、结果、竞赛规则与最终提交材料必须由使用者核验;项目内部评分和门禁不代表竞赛结果承诺。
- ## 核心能力
- - 从真实题面、附件和数据建立问题底稿,并按 `supplied/collected/none` 声明数据模式;
- - 有数据时执行题目驱动的数据审计、预处理、质量复核和输入冻结,无数据时明确跳过;
- - 将自然语言任务转化为可计算、可验证的数学模型,严格区分模型名称、定制机制与求解算法;
- - 建立跨问题复用的机制内核,通过逐问继承与真实增量形成连续数学主线;
- - 先建立可解释基线,再通过对照、消融和稳健性分析验证改进;
- - 运行逐问程序并保存结构化结果,使论文数值能够追溯到计算输出;
- - 生成数据图、结果表、DrawIO/TikZ 流程图和稳定的论文引用;
- - 按目标竞赛模板组织 LaTeX 或 DOCX 论文,控制摘要结构、正文密度、图表尺寸与页数;
- - 对最终 PDF 执行公式语义、章节引用和页面构成审计,检查空白、孤行、小字、断表和硬编码编号;
- - 从当前源码生成仅包含主程序和逐问核心实现的代码附录,并使用英文程序显示名;
- - 通过阶段门禁、返工传播、断点恢复和多轮审稿控制研究质量。
- ## v1.3 重点升级
- v1.3 保持七阶段流程和论文交付物数量不变,将高质量论文的建模递进、学术叙事和页面节奏转化为可执行合同:
- - **统一机理与逐问递进**:先建立跨问题复用的状态、几何、统计或资源机制,再通过模型增量卡记录新增变量、约束、目标、求解与验证,避免每问独立堆模型。
- - **模型语义门禁**:新增目标数量、方向、变量类型、关系类型与多目标证据;多资源、高维变量或多个指标不再自动通过“多目标模型”命名。
- - **发布声明一致性**:在现有 `全部结果.json` 中固化关键结果、来源键和派生方式,摘要、正文、图表与结论读取同一证据,减少加总、区间并集和人工抄数冲突。
- - **逐问学术叙事**:正文按“任务作用—模型/继承—机制公式—求解—结果—验证—解释边界”推进,结果段采用“结论—数值—机制—例外”闭环,不再使用机械句数补写。
- - **公式与交叉引用**:核心公式使用原生可编辑数学环境,补齐动机、符号、单位、定义域和后续作用;拦截公式截图、硬编码图表公式编号和重复标签。
- - **证据角色**:`figure_manifest.json` 对图与表统一登记所属问题、视觉角色、结果键和发布状态,区分机制、结果、验证、决策和诊断资产,避免重复图表与正文堆叠。
- - **动态问题章节**:国赛模板可按真实问题数同步章节和主文件输入,防止四问、五问文件存在却未进入最终 PDF。
- - **编译后页面审计**:新增最终 PDF 页面检测,识别低占用页面、底部大空白、标题孤悬、不可读小字和内容越界;页数合规不再替代页面质量。
- 具体规则见 [模型质量合同](references/model-quality-contracts.md)、[LaTeX 数学表达](references/paper-layout/latex-math.md) 和 [页面构成合同](references/paper-layout/page-composition.md)。
- ## 工作流
- 正式工作流由 [机器清单](assets/workflow_manifest.json) 定义,当前包含 7 个阶段:
- | 阶段 | 目标 |
- | --- | --- |
- | `DISCOVERY` | 读取题面、附件与数据,拆解问题并声明数据模式 |
- | `FORMULATION` | 建立数学机制、模型身份、预处理合同与验证方案 |
- | `COMPUTATION` | 按需预处理数据,编写程序并开展真实计算 |
- | `EVIDENCE` | 将结果转化为论文图表与数据证据 |
- | `SCHEMATICS` | 绘制技术路线和系统逻辑图 |
- | `MANUSCRIPT` | 集成模型、实验、图表、引用与核心代码附录 |
- | `ASSURANCE` | 编译并检查内容、版式、身份与最终材料 |
- 详细的阶段依赖、核验点和产物映射见 [工作流总图](references/workflow-map.md) 与 [门禁矩阵](references/gate-matrix.md)。
- ## 阶段与质量模式
- 项目将研究阶段和质量模式作为两个独立维度:
- | 维度 | 可选值 | 说明 |
- | --- | --- | --- |
- | 研究阶段 `phase` | `baseline`、`enhancement` | 默认先完成稳定基线,再对薄弱环节实施受控增强 |
- | 质量模式 `mode` | `standard`、`championship` | 默认使用标准模式;冠军模式在论文完成后增加多轮独立审稿 |
- 切换命令:
- ```bash
- python scripts/pipeline_manager.py set-phase enhancement --workspace ../contest-workspace
- python scripts/pipeline_manager.py set-mode championship --workspace ../contest-workspace
- ```
- `enhancement` 不能绕过基线证据。`championship` 至少执行三轮审稿,并应用项目内部的 P0/P1 和综合评分门槛。详细规则见 [阶段控制](references/phase-control.md)、[增强操作](references/enhancement-operations.md) 和 [冠军审稿方法](references/championship-review-method.md)。
- ## 运行要求
- - Python 3.8 或更高版本,建议使用 Python 3.10 或 3.11;
- - PDF 路线需要 Bash、XeLaTeX、BibTeX、PyMuPDF 和相应 TeX 宏包;
- - DOCX 页数门禁需要 LibreOffice;DrawIO 和 PDF 视觉核验需要对应系统工具;
- - 完整的分平台安装、可选建模依赖和自检命令见 [环境配置说明](ENVIRONMENT.md)。
- 安装 Python 依赖:
- ```bash
- python -m pip install -r scripts/requirements.txt
- ```
- ## 快速开始
- ### 方式一:在 Codex 中配置并直接使用(推荐)
- 先向 Codex 发送下面的提示词,将项目配置为全局 Skill:
- ```text
- 将 https://github.com/WuXinbo-bo/Math-model-skills 这个 Skill 直接配置到 Codex 全局 Skill 中。
- ```
- 配置完成后,上传赛题、附件和数据,再发送:
- ```text
- 开始处理我上传的数学建模赛题。
- 竞赛类型:CUMCM
- 模式:冠军模式
- 论文撰写方式:LaTeX
- ```
- 可以按实际任务将竞赛类型改为 `CUMCM`、`51MCM` 或 `MCM/ICM`,将模式改为标准模式或冠军模式,将论文撰写方式改为 `LaTeX` 或 `DOCX`。根目录的 [`SKILL.md`](SKILL.md) 是 Skill 执行入口;运行时应按当前阶段渐进加载协议,而不是一次读取全部参考文件。
- ### 方式二:使用命令行运行
- 以下命令均从本仓库根目录执行,`../contest-workspace` 表示独立的目标研究工作区。不要把仓库根目录和研究工作区视为同一目录。
- #### 1. 初始化工作区
- ```bash
- python scripts/workspace_init.py --workspace ../contest-workspace --competition cumcm --output-format pdf
- ```
- `--competition` 支持 `cumcm`、`51mcm` 和 `mcm-icm`;`--output-format` 支持 `pdf` 和 `docx`。竞赛类型会控制模板、语言、匿名字段、字号和页数门禁。
- #### 2. 查看状态
- ```bash
- python scripts/pipeline_manager.py overview --workspace ../contest-workspace
- python scripts/stage_executor.py current --workspace ../contest-workspace
- ```
- #### 3. 开始当前阶段
- ```bash
- python scripts/stage_executor.py begin DISCOVERY --workspace ../contest-workspace
- ```
- 阶段开始后,系统会把当前阶段需要的工具、参考资料和模板同步到目标工作区。完成实际研究工作后,按顺序执行:
- ```bash
- python scripts/stage_executor.py validate DISCOVERY --workspace ../contest-workspace
- python scripts/stage_executor.py gate_check DISCOVERY --workspace ../contest-workspace
- python scripts/stage_executor.py complete DISCOVERY --workspace ../contest-workspace --artifacts "问题分析.md"
- python scripts/stage_executor.py checkpoint DISCOVERY --workspace ../contest-workspace --action approve --note "reviewed"
- ```
- 使用以下命令获取下一步建议:
- ```bash
- python scripts/pipeline_manager.py next --workspace ../contest-workspace
- ```
- #### DOCX 路线
- 初始化时选择 `--output-format docx`。论文源稿完成后,使用初始化过程中复制到目标工作区的导出工具:
- ```bash
- python "../contest-workspace/工具/docx_export.py" --workspace ../contest-workspace
- ```
- ## 文档导航
- | 主题 | 文档 |
- | --- | --- |
- | 环境安装与依赖自检 | [ENVIRONMENT.md](ENVIRONMENT.md) |
- | 总流程与阶段映射 | [workflow-map.md](references/workflow-map.md) |
- | 阶段门禁与人工核验 | [gate-matrix.md](references/gate-matrix.md) |
- | 模型语义与逐问增量 | [model-quality-contracts.md](references/model-quality-contracts.md) |
- | LaTeX 数学表达 | [latex-math.md](references/paper-layout/latex-math.md) |
- | 编译后页面构成 | [page-composition.md](references/paper-layout/page-composition.md) |
- | Baseline 与 Enhancement | [phase-control.md](references/phase-control.md) |
- | 增强模式操作 | [enhancement-operations.md](references/enhancement-operations.md) |
- | 冠军模式审稿与评分 | [championship-review-method.md](references/championship-review-method.md) |
- | 主控、工作与复核角色 | [subagent-architecture.md](references/subagent-architecture.md) |
- | CUMCM 官方规则摘录 | [cumcm-official-notes.md](references/cumcm-official-notes.md) |
- | 竞赛机器配置 | [competition_profiles.json](assets/competition_profiles.json) |
- | 分阶段实施协议 | [`references/stage_protocols/`](references/stage_protocols/) |
- 目标竞赛的当期正式规则始终高于仓库中的模板、摘录和机器门禁。
- ## 项目结构
- ```text
- Meta-model-agent/
- ├── SKILL.md # Skill 入口与总执行规则
- ├── ENVIRONMENT.md # 环境安装、依赖分层与自检
- ├── agents/ # Skill 界面配置
- ├── assets/ # 工作流清单、竞赛配置、模板和共享工具
- ├── references/ # 工作流指南、知识库和阶段协议
- └── scripts/ # 初始化、状态机、门禁、审稿和回归脚本
- ```
- 初始化后的研究工作区通常包含:
- ```text
- 用户数据/ 程序/ 图表/ 论文/ 审查/
- 状态/ 日志/ 工具/ 参考资料/ 模板/
- ```
- ## 质量边界
- - 自动门禁只能检查已编码的合同,不能证明题意、模型、数据或结论一定正确;
- - 外部资料、参考文献、数据集和竞赛规则必须回到原始来源核验;
- - 使用者应重新运行程序,检查随机种子、参数、输入、关键数值和图表一致性;
- - `championship` 是内部质量模式名称,不代表获奖、录用或任何第三方评价;
- - 最终提交前必须完成人工通读、匿名检查、格式检查和提交确认。
- 出现中断或上游错误时,先运行 `stage_executor.py status` 和 `pipeline_manager.py next`;需要返工时从对应阶段执行 `rework`,不要只修改最终论文掩盖模型或数据问题。
- ## 许可与致谢
- 本项目采用 [MIT License](LICENSE),允许在保留版权和许可声明的前提下使用、复制、修改、合并、发布、分发、再许可和销售软件副本。
- 工作流设计参考了 [xuec699-sudo/math-modeling-skills](https://github.com/xuec699-sudo/math-modeling-skills),并从 **Modex-MH-Agent** 的工作流组织方式中获得部分灵感。本项目为独立设计与实现,与上述项目不存在官方隶属或质量背书关系。
- ## 赞助支持
- <table>
- <tr>
- <td align="center" width="28%">
- <a href="https://88.scxai.top/">
- <img src="assets/branding/sponsor-chuangshi-xinyuan.jpg" alt="创世の鑫元" width="150">
- </a><br>
- <strong>创世の鑫元</strong><br>
- <a href="https://88.scxai.top/">访问官方网站</a>
- </td>
- <td>
- 感谢 <strong>创世の鑫元</strong> 对本项目的赞助与支持。其网站提供 AI 相关服务与工具信息;具体服务内容、价格、可用性及使用条款请以官方网站的最新说明为准。
- </td>
- </tr>
- </table>
- ## ⭐ Star History
- <a href="https://www.star-history.com/#WuXinbo-bo/Math-model-skills&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=WuXinbo-bo/Math-model-skills&type=Date&theme=dark">
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=WuXinbo-bo/Math-model-skills&type=Date">
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=WuXinbo-bo/Math-model-skills&type=Date">
- </picture>
- </a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.