mathmodel-skill (rootkiller6788)

---
name: mathmodel-skill
description: CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流，以及一般数学建模项目。Use when a user works on a modeling competition (cumcm/mcm/icm/diangong/国赛/美赛/电工杯) or asks to run/review a modeling-competition paper from problem selection through modeling, solving, robustness, writing, compliance, and final submission review. 采用 10 阶段项目流程为脊柱、建模手/编程手/论文手三角色为阶段内执行引擎、5 个独立门禁质检，并集成双引擎论文搜索、出版级可视化、LaTeX/PDF 编译与预检、Excel/PDF 等工具。Do not trigger for generic model selection, ordinary data analysis, or non-competition paper review.
---

# mathmodel-skill — 数学建模三竞赛工作流（10 阶段 × 三角色 × 5 门禁）

本 Skill 把 72–96 小时的竞赛协作组织为可恢复、可检查、可交接的流程：**10 阶段项目时间线**（选题→拆题→建模→求解→稳健→写作→终审）为脊柱，**建模手 / 编程手 / 论文手**三角色负责阶段内的实际执行，**5 个独立门禁质检**（`M1/P1/P2/W1/W2`）在每个交付物边界验收，L1–L4 反馈层驱动打分与定向精修。用户回答关键问题，agent 维护状态与脚本。

- **10 阶段**：`references/stage_00..09_*.md`；状态统一存 `<cwd>/state/decision_log.json`。
- **三角色**：`references/roles/{建模手,编程手,论文手}/SKILL.md`，映射见 `references/角色-阶段映射.md`。
- **5 门禁**：`references/Subagent调度.md` 定义固定质检协议。
- **全工具**：`tools/{figure,paper_search,docx,xlsx,pdf,latex}` + `scripts/latex_check/` 预检。
- **生成论文仅供用户参考**，非可直接提交作品；结构格式以当届官方规则为准。

**使用前**：把 `使用指南.md` 复制到工作区 `<cwd>/`。

## 强制执行协议

用户点名本 Skill 或任务命中时，严格执行，不降级为建议：

1. 首次进度更新中回显：已激活本 Skill、`<cwd>`、当前阶段、目标竞赛与届次、计划读取的角色和工具入口。未确认的官方规则标为待核验。
2. 进入每个阶段前**实际读取**该阶段角色 `SKILL.md`；使用 PDF、Excel、论文搜索、DOCX 或 LaTeX 时再读取对应工具 `SKILL.md`。知道路径 ≠ 已执行。
3. 严格调用本 Skill 提供的脚本和模板；已有初始化、转换、编译或校验工具时，禁止手写替代实现。
4. 任何校验预警视为未完成；只有当届官方规则或用户明确要求允许偏离时，记录“规则来源、偏离项、理由”后继续。
5. 环境缺少引擎、搜索源或依赖时，报告阻塞并继续完成仍可验证的部分；禁止静默换工具或用较差产物冒充完成。
6. 按 `references/Subagent调度.md` 在 `M1/P1/P2/W1/W2` 节点立即派发独立质检，禁止等全流程结束后才首次派发；作者自检不能替代独立验收。除固定质检外不主动派发其他 Subagent。
7. 交付前运行当前阶段的全部完成门禁；任一命令未运行、退出码非零、门禁未通过时，不得声称“已完成”。
8. 最终回复列出实际读取的入口、实际运行的关键命令与退出码、门禁状态、核心质量指标和仍存在的阻塞；不得只说“已检查”。

## 三竞赛 × 三模式矩阵

| Competition | 时长 | 语言 | LaTeX 引擎 | 规则基线 | 经验数据 |
|---|---|---|---|---|---|
| cumcm | 72h | 中文 | xelatex / 原创 ctexart | CUMCM 2026 | 91 来源 / 59 可提取样本 |
| mcm | 96h | English | pdflatex / article | COMAP 2027 | `n=0`，无论文分位 |
| diangong | 72h | 中文 | xelatex / ctex | 官网 2026-03-21 | `n=0`，无论文分位 |

| Mode | 反馈层 | 用途 |
|---|---|---|
| fast | L1 单次 | 选题试跑 / sanity check |
| standard | L1 + L2 | 默认主流程 |
| championship | L1+L2+L3+L4 + red-team | 终稿前深度评审 |

模式按距 deadline 自动推荐（>60h standard；<6h 直进 Stage 9 championship）。

## 10 阶段索引

| # | 阶段 | 承担角色 | 门禁 | 时长 | 关键产物 |
|---|------|---------|------|------|---------|
| 0 | 团队启动 + 资料预扫 | — | — | 1h | 启动字段、环境、规则基线 |
| 1 | 选题（多题对比 → 1） | — | — | 2-4h | 选择理由、放弃项、task_type |
| 2 | 问题拆解 | 建模手 | — | 2-3h | 子问、变量、约束、依赖图 |
| 3 | 模型选型 | 建模手 | — | 2-4h | 候选模型、证据、淘汰理由 |
| 4 | Foundation | 建模手 | **M1** | 1h | `题目分析报告.md` + `术语表格.md` |
| 5 | 递归子问题循环 Q1..Qn | 编程手 | **P1 → P2** | 按题分配 | 代码、`results/`、`figures/`、`复现清单.json` |
| 6 | 稳健性 / 灵敏度 | 编程手 | — | 2-3h | 稳健区间、失败边界 |
| 7 | 模型评价 + 推广 | 建模手 | — | 1-2h | 优缺点、改进、迁移条件 |
| 8 | 论文装配与写作 | 论文手 | **W1 → W2** | 12-30h | `paper_workspace/*.md` → LaTeX/PDF |
| 9 | 提交前终审 + Panel | 论文手 | — | 2-6h | 最终 PDF、支持材料、Panel 记录 |