Mathmodel Skill

把 72–96 小时的数学建模竞赛，变成一条可恢复、可检查、可交付的 Agent 工作流

快速开始 · 核心亮点 · 30 秒看懂 · 工作流 · 竞赛支持 · 常见问题 · Star History

---

数学建模比赛很少因为“缺少一个更聪明的回答”而失败。更常见的是：模型换了，摘要没改；第二问重算了，第三问还在引用旧结果；关键假设只活在聊天记录里；直到提交前，才发现匿名、页数或 AI 披露不合规。

mathmodel-skill 不是一个试图一口气生成整篇论文的 Prompt，也不是替团队做决定的黑盒 Agent。它是一套可执行的建模工作流：把选题、拆题、模型选择、求解、稳健性分析、论文装配和终审组织成 10 个阶段，用一份共享决策日志保存整个项目的状态。团队只回答关键的编号问题，Agent 负责维护状态、调用脚本、整理产物。

[!TIP] 一句话上手：安装后在 Codex 里输入 使用 $mathmodel-skill，开始 CUMCM 建模。，或在 Claude Code 里说 开始建模。之后随时说 “看进度”，就能看到当前阶段、评分、合规门和下一步。

✨ 为什么是 mathmodel-skill

🧭 10 阶段，一条主线

选题 → 拆题 → 选型 → 求解 → 稳健性 → 写作 → 终审。每个阶段都有进入条件、退出条件和回退路径，Agent 在可检查的位置停下来，而不是一口气跑到底。

🧠 一份状态，随时接力

state/decision_log.json 记录每个决定、依据、评分与回退。换队员、换对话、从 Codex 换到 Claude Code，都从同一个检查点继续，不靠聊天记忆。

⚖️ 脚本裁决，不靠自评

Critic 打分之后，由 score_artifact.py 重新计算 verdict。任何关键维度低于门槛都会单独暴露，不会被加权均分“平均掉”。

🎯 哪里错，只修哪里

Stage 5 按子问保存状态：refine_partial 只返工没通过的 Qi，其余结果保持不动；论文按 section patch 定向修补，不推倒重来。

🛡️ 提交前 fail-closed

占位符、缺失章节、模板 marker 错位会直接失败；当届规则、匿名、页数、AI 披露、支撑材料五道终审门不过，就不能标记 submission_ready。

📊 一眼看进度 v6.2 新

status.py 汇总 10 个阶段的 verdict、子问状态、合规门和截止倒计时，按剩余时间给出模式建议，并只给出一条明确的下一步。

它专门对付这些“翻车现场”

😵 比赛中的常见情况	✅ mathmodel-skill 的处理方式
对话越来越长，早期决定难以追溯	所有阶段共用 state/decision_log.json，统一保存选择、依据、评分与回退记录
总体表现尚可，但某个关键维度明显不足	Verdict 同时检查最低分和加权均分；高严重度问题不能被平均数掩盖
只有 Q2 需要返工，却牵连全部结果	Stage 5 按 Qi 保存状态，refine_partial 只修改受影响的子问
三类竞赛要求不同，维护成本不断增加	一条主流程 + competition pack、权重 overlay 和模板表达差异
Markdown 章节写好了，主 TeX 却没引用到	模板使用显式 section marker；缺失、重复或未知 marker 直接失败
封面或摘要仍含占位符，却被当成正式稿	正式渲染 fail-closed；占位符只能用于显式 dry-run
临近提交才发现页数、匿名或 AI 披露问题	Stage 0、8、9 重新打开规则入口；合规门不过不能进入 submission_ready
Pandoc、TeX 或依赖问题直到最后才暴露	doctor.py 一次性检查结构、竞赛包、Python、Pandoc、TeX 与可选依赖
忙了一整天，说不清现在到底卡在哪	status.py 只读汇总进度、阻断项与下一步，不改动任何状态

🎬 30 秒看懂

① 开口说一句 —— Agent 只询问还缺的启动信息（竞赛、题号、队伍、截止时间、题面），然后用 init_workspace.py 建好工作区。

② 关键决策点，只需回答数字 —— 没有原生选择 UI 的环境会退化为编号列表，语义完全一致：

【Stage 3 · Q1 用哪个候选模型？】

  1) 混合整数规划 (MILP) — 目标与约束线性，求解器可给出最优性证明
  2) 遗传算法 — 适合非凸、高维离散搜索
  3) 禁忌搜索 — 中等规模组合优化，易实现
  4) 让我决定（推荐 1：Stage 2 已标记目标为线性）

回复数字即可。

③ 任何时候说“看进度” —— 下面是 status.py 对一份示例状态的真实输出：Stage 5 中只有 Q2 没过，所以下一步只精修 Q2。

示例数据，仅用于展示看板格式

🧭 工作流全景

Stage	任务	关键产物	主要检查
0	团队启动与资料预扫	竞赛、角色、时限、环境、规则基线	可执行性与合规入口
1	多题比较与选题	选择理由、放弃项、题型判断	资源匹配与失败风险
2	问题拆解	子问、变量、约束、依赖图	逻辑完整性
3	模型选型	候选模型、证据、反事实与淘汰理由	模型与问题的匹配程度
4	Foundation	假设、符号、术语表	一致性与可解释性
5	递归求解 Q1…Qn	formulation、代码、结果、图表	per-Qi 评分与定向回修
6	稳健性分析	风险匹配的验证、稳健区间、失败边界	灵敏度与结论可靠性
7	模型评价	优点、局限、改进、迁移条件	边界是否诚实、结论能否推广
8	论文装配	paper_workspace/*.md、TeX/PDF、AI 台账	跨阶段一致性与格式合规
9	提交前终审	最终 PDF、支持材料、Panel 记录	合规门、证据链与视觉检查

每一轮评审如何收敛

评分工具输出的是流程状态，而不是奖项预测。Critic 给分之后，verdict 一律由脚本重新计算：