mathmodel-skill
三竞赛 (CUMCM/MCM/电工杯) 数学建模 skill — harness-agnostic, 同时支持 Claude Code 与 Codex CLI, 全程问答式 (Friendly Mode), 10 阶段 + 4 反馈层 + per-Qi 加权聚合 + 题型 dim 加权 + empirical 实测分位锚定
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/handsomezr-netizen--mathmodel-skill)HTML
<a href="/listings/handsomezr-netizen--mathmodel-skill"><img src="/api/listings/handsomezr-netizen--mathmodel-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Codex(macOS / Linux)**
git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \ ~/.agents/skills/mathmodel-skill python ~/.agents/skills/mathmodel-skill/scripts/doctor.py --competition cumcm mkdir -p my-modeling-project && cd my-modeling-project codex
<details> <summary><b>Codex(Windows PowerShell)</b></summary>
git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git ` "$HOME\.agents\skills\mathmodel-skill" python "$HOME\.agents\skills\mathmodel-skill\scripts\doctor.py" ` --competition cumcm New-Item -ItemType Directory -Force my-modeling-project | Out-Null Set-Location my-modeling-project codex
</details>
<details> <summary><b>只安装到当前项目(项目级 skill)</b></summary>
mkdir -p .agents/skills git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \ .agents/skills/mathmodel-skill
</details>
**Claude Code**
git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \ ~/.claude/skills/mathmodel-skill mkdir -p my-modeling-project && cd my-modeling-project claude
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 · 237 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: mathmodel-skill
- description: CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling, solving, robustness, writing, compliance, and final submission review. Provides 10 stages, persistent decision state, competition-specific rules/templates, deterministic scoring helpers, numbered decisions, and Codex/Claude Code handoff. Do not trigger for generic model selection, ordinary data analysis, or non-competition paper review.
- ---
- # mathmodel-skill — 数学建模三竞赛工作流 (v6.2)
- 10 阶段把 72–96 小时的竞赛协作变成可恢复、可检查的流程。用户回答关键问题,agent 维护状态与脚本。每阶段产出经过 rubric 自评、定向精修与跨阶段一致性回检;Stage 8–9 先遵守当届官方规则,再做多视角终审。CUMCM 包含 91 份来源文档,其中 59 份进入文本统计;MCM/电工杯经验统计明确为 `n=0`,不提供合成分位。
- **v6.2 更新**: 新增 `scripts/init_workspace.py`(只创建、不覆盖的工作区初始化)与 `scripts/status.py`(只读进度看板:阶段 verdict、per-Qi、合规门、截止倒计时、模式建议与下一步);启动与“看进度”改由脚本确定性完成。v6.1 的规则基线、AI 披露链路、fail-closed 模板与 doctor 预检保持不变。
- ---
- ## Codex 原生入口
- Codex 优先按 skill 目录发现本文件:
- - 用户级安装: `$HOME/.agents/skills/mathmodel-skill/`
- - 项目级安装: `<repo>/.agents/skills/mathmodel-skill/`
- - UI 元数据: `agents/openai.yaml`
- - 插件分发元数据: `.codex-plugin/plugin.json` + `skills/mathmodel-skill/SKILL.md` shim
- - 项目指导: `AGENTS.md` 仍可作为 repo / workspace 级 instructions, 但不是唯一入口
- 当 skill 已安装后, 用户可直接说"开始建模"或显式说"使用 `$mathmodel-skill` 开始建模"。
- ---
- ## Harness 兼容 (Claude Code / Codex)
- 本 skill v6.2 以 Codex Skills 为一等入口, 同时保持 harness-agnostic 设计:
- | harness | 入口文件 | 用户交互工具 | 状态文件 |
- |---------|---------|-------------|---------|
- | Claude Code | `SKILL.md` (本文件) | `AskUserQuestion` 工具 | `<cwd>/state/decision_log.json` |
- | Codex CLI / Codex app | skill 目录中的 `SKILL.md` + 可选 `AGENTS.md` | markdown 编号列表 | 同上 (**互通**) |
- 跨 harness 互通: day 1 用 Codex 跑 stage 0-2, day 2 切回 Claude Code 接着 stage 3+, 状态完全保留。详见 `references/harness_compat.md`。
- ---
- ## 问答式优先 (Friendly Mode)
- **核心原则**: 用户只需回答**编号问题**, 不应被要求手敲 bash / python / json。
- - 离散选项 (选竞赛 / 选题 / 选模型 / verdict 决策) → **必须**用问答式
- - 自由文本 (PDF 路径 / 截止时间) → 单行回复
- - 状态读写 (decision_log.json) → agent 自动完成
- - 每个 stage 的关键决策点都有 "让我决定 (推荐 X)" 兜底选项
- 优先使用当前 harness 可用的原生选择 UI;没有时回退到 markdown 编号列表。两者语义等价,见 `references/harness_compat.md` §1。
- ---
- ## 路径解析协议 (任何阶段必读)
- | 类型 | 位置 | 例 |
- |------|------|-----|
- | skill 内通用 | skill 根目录的相对路径 | `references/stage_05_subproblem_loop.md`, `templates/shared/decision_log.json` |
- | **竞赛特化** | `competitions/<comp>/...` 按 decision_log.competition dispatch | `competitions/cumcm/winning_patterns.md`, `competitions/mcm/abstract_template.md` |
- | **LaTeX 模板** | `templates/latex/<comp>/main.tex` | `templates/latex/cumcm/main.tex`, `templates/latex/mcm/main.tex` |
- | 用户产物 | 用户工作目录的相对路径 | `<cwd>/state/`, `<cwd>/results/`, `<cwd>/figures/`, `<cwd>/paper_workspace/` |
- | state 持久化 | `<cwd>/state/decision_log.json` | 各 stage 必读必写 |
- | 环境变量 | `MATHMODEL_STATE_DIR` (兼容 `CUMCM_STATE_DIR`) / `MATHMODEL_COMPETITION` 可覆盖 | scripts 用此变量 |
- 约定: `<skill>/` = skill 安装目录, `<cwd>/` = 用户 cwd, `<comp>/` = 当前竞赛 (cumcm | mcm | diangong)。
- ---
- ## Quick Start (用户首次说"开始建模")
- ```
- 1. 一段话介绍 (≤50 字): "启动数学建模工作流, 10 阶段 + 三竞赛, 全程问答式."
- 2. 收集下列 5 个启动字段;用户已经提供或 state 已记录的字段不再询问,只把尚缺字段合并成一轮问答 (Claude Code: AskUserQuestion; Codex: 编号列表):
- - 竞赛 (cumcm 国赛 / mcm 美赛 / diangong 电工杯, 默认 cumcm)
- - 题号 (依竞赛: cumcm A-E / mcm A-F / diangong A-B; "未公布"亦可)
- - 队员数 + 各人擅长 (建模/编程/写作)
- - 截止时间 (ISO 字符串或 "距现在 X 小时")
- - 题目 PDF 路径 ("未公布"亦可)
- 3. 自动初始化 (agent 自动完成, 不要让用户编辑 json):
- - 运行 `python <skill>/scripts/init_workspace.py --competition <comp> --workspace <cwd>`,按已知答案追加 `--problem <题号|未公布>`、`--team-size N`、`--deadline <ISO>` 或 `--hours-left H`、`--problem-pdf <path>`
- - 脚本创建 `state/ results/ figures/ paper_workspace/ paper_output/ support_materials/`,从模板生成 state 并写入 competition 与 problem_meta
- - state 已存在时脚本**不修改**任何内容,只报告 competition 与 current_stage;竞赛不一致时失败,按“切到 <comp>”处理
- - 脚本输出的模式建议只是建议;与用户确认后才改 mode 并写入 events
- - 无法运行 Python 时,才手动复制 `<skill>/templates/shared/decision_log.json` 并写入 competition
- 4. 加载 `competitions/<comp>/current_rules.md`(若存在),打开其中官方链接核对当届规则并写入 compliance;再按需加载 winning patterns
- 5. 进入 Stage 0 (`references/stage_00_kickoff.md`), 不重复问已知字段;若题面未公布,完成环境与协作准备后保持 `qi_count=null` 并等待题面,不进入 Stage 1
- ```
- **已有 state 触发** (用户中途回到 skill):
- ```
- 1. 运行 `python <skill>/scripts/status.py --workspace <cwd> --json` 取得 competition、current_stage、最新 verdict 与下一步;需要细节时再读 `<cwd>/state/decision_log.json`
- 2. 加载对应 stage_NN.md (按需结合 competitions/<comp>/* 内容)
- 3. 不重复读 winning_patterns
- ```
- ---
- ## 三竞赛 × 三模式 矩阵
- 时长 / 语言 / 模板 / 数据状态 由 competition 决定; token 预算 / 反馈深度由 mode 决定。两者**正交组合**。
- | 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 剩余;`scripts/status.py` 按同一规则计算,仅作建议):
- - > 60h: standard (最后 6h 升 championship)
- - 24-60h: standard
- - 6-24h: fast 关键阶段 + championship 终审
- - < 6h: 直接进 stage 9 (championship)
- ---
- ## 10 阶段索引
- | # | 阶段 | reference | 时长 | 反馈 | 竞赛差异点 |
- |---|------|-----------|------|------|-----------|
- | 0 | 团队启动 + 资料预扫 | `stage_00_kickoff.md` | 1h | L1 | 时长 / 语言 / 编译器 / 题号体系 |
- | 1 | 选题 (多题对比 → 1) | `stage_01_problem_selection.md` | 2-4h | L1 | 题号体系 (A-E/A-F/A-B) + task_type 写入 |
- | 2 | 问题深度解析与分解 | `stage_02_analysis.md` | 2-3h | L1 | 通用 |
- | 3 | 模型选型 (证据驱动的候选比较) | `stage_03_model_selection.md` | 2-4h | L1 + 反事实 | 通用 |
- | 4 | Foundation (假设+符号+术语) | `stage_04_foundation.md` | 1h | L1 | 通用 |
- | 5 | **递归子问题循环** Q1..Qn + per-Qi 加权聚合 | `stage_05_subproblem_loop.md` | 按题目分配 | L1 + 子检查点 | 从题面提取实际子问数;per-Qi 加权 |
- | 6 | 全局灵敏度 / 稳健性 | `stage_06_robustness.md` | 2-3h | L1 + L2 | 工程参数 (diangong) vs 数学参数 (cumcm/mcm) |
- | 7 | 模型评价 + 推广 | `stage_07_evaluation.md` | 1-2h | L1 | 通用 |
- | 8 | 论文写作 + 合规装配 | `stage_08_writing.md` | 12-30h | L1 + L2 | 当届规则、AI 披露、摘要类型与 LaTeX 模板 |
- | 9 | 提交合规 + Panel | `stage_09_review.md` | 2-6h | L1 + L3 panel | 页数/匿名/披露 + anti-patterns + personas |
- ---
- ## 加载协议 (节省 token 的关键)
- **只在进入阶段 N 时加载** `references/stage_NN_*.md`。**切勿**一次性全读。
- 各阶段额外加载 (按需 + 按 competition 切换):
- - 每阶段开头: `<cwd>/state/decision_log.json` 必读
- - 每阶段结尾: `<cwd>/state/decision_log.json` 必写 (核心决策 + 5 维评分)
- - stage 1-9: `references/rubrics.md` 对应章节 (L1 评分用)
- - **stage 1**: `competitions/<comp>/topic_specs.json` (题号 → task_type 映射)
- - stage 3, 5: `references/model_catalog.md` (跨竞赛通用)
- - **stage 5**: per-Qi 评分跑完后调 `scripts/score_artifact.py --mode aggregate_qi` 聚合
- - **stage 0 / 8 / 9**: `competitions/<comp>/current_rules.md` 存在时读取,并核对其中官方链接
- - **stage 8**: `competitions/<comp>/{winning_patterns, phrase_bank, abstract_template, paper_skeleton}.md`
- - **stage 8 经验锚点**: `competitions/<comp>/empirical.json` 只作评分前参考;CUMCM 为 59 份可提取样本的观察分位,MCM/电工杯为 `n=0` 占位且不得推断数值门槛
- - **stage 9**: 先做规则合规门,再用 `anti_patterns.md` 与 `rubric_overlay.json` 的 panel personas
- - 触发反馈时: 对应 `references/feedback_layer*.md`
- - harness 适配差异 (Codex 用户必读): `references/harness_compat.md`
- ---
- ## 收敛准则 (统一定义, 三处一致)
- **verdict 优先级 (从高到低)**:
- | verdict | 触发 | 行为 |
- |---------|------|------|
- | `block` | issues 含 ≥1 high-severity | 暂停 skill, 用户介入 |
- | `pass_early` | raw_min ≥ 9 AND weighted_mean ≥ 9 | iter-1 早退 |
- | `pass` | raw_min ≥ 7 AND weighted_mean ≥ 8 | 进下一阶段 |
- | `pass_with_review` *(stage 5)* | 任 Qi mark_for_review 但加权阈值满足 | 进 stage 6, L2 必读 review_qis |
- | `refine` | 其他 | section-patch 精修, iter+=1 (cap 3) |
- | `refine_partial` *(stage 5)* | 任 Qi.min < 7, 其他 Qi 已 pass | 仅 refine 该 Qi, 不动其他 |
- | `carryover` | iter == 3 仍 refine | 进下一阶段, 标记由 L2 处理 |
- `weighted_mean` = Σ(s_i × w_i) / Σ(w_i), 权重来自 `config/dim_weights.json[<comp>][<task_type>]` (clamp [0.7, 1.5]); `task_type=default` 全 1.0 等价老逻辑。
- 此定义在 `feedback_layer1_critic.md` / `rubrics.md` / `scripts/score_artifact.py` 三处必须**完全一致**。
- ---
- ## 状态持久化
- 每阶段:
- - 开头: 读取 `<cwd>/state/decision_log.json`, 核对 current_stage 与上下文
- - 结尾: 更新 stage 节点 (核心决策 + 摒弃方案 + 评分), `current_stage += 1`
- `decision_log.json` v3.1 schema 关键字段 (与 `templates/shared/decision_log.json` 对齐):
- - root: `competition`, `task_type`, `mode`, `current_stage`, `budget`, `events`, `compliance`
- - stage_5 扩展: `qi_count`, `qi_weights`, `qi_status`
- - scores 扩展: 含 `weighted_mean`, `review_qis`, `refine_qis` (stage 5 加权聚合用)
- L2 跨阶段回检 (stage 5/6/8 末尾) 读这个文件主动找冲突, 触发**定向回滚**: 不重做整阶段, 只针对冲突点。
- ---
- ## 上下文预算纪律
- - L1 Critic 强制 JSON 输出, ~500 token/次
- - 精修策略: section-level patch (`scripts/extract_diff.py`), 优先只传相关 section
- - references/ 与 competitions/ 文件**懒加载**, 本 SKILL.md 主体 ≤ 6k tokens
- - 阶段完成后, artifact 摘要 + 关键数据 + 路径写入 decision_log, 不在上下文保留全文
- - 只有当前 harness / API 提供可靠 usage 时才记录 token 消耗;不可观测时保留为 `null`,不得估算成已用额度
- - 上下文压力或剩余时间不足时,向用户建议从 championship → standard → fast 降级,并把确认后的 mode change 写入 events;不要声称已自动计量或静默切换
- ---
- ## 用户指令快捷
- - "进入 stage N" / "重做 stage N" → 跳转
- - "切到 mcm" / "切到 cumcm" / "切到 diangong" → 改 decision_log.competition (注意已有 state 兼容性)
- - "升级到 championship" → 启用 L3 + L4 + red-team
- - "切到 fast" → 关闭迭代
- - "回退到 stage M" → 读 decision_log, 回退 current_stage 并清理 ≥M 节点
- - "做 L2 回检" → 立即触发 cross-stage backtrack
- - "看进度" → 运行 `python <skill>/scripts/status.py --workspace <cwd> --markdown`,原样展示看板与下一步 (只读,不改 state)
- ---
- ## 数据来源声明
- - `competitions/cumcm/`: 91 份来源文档,59 份成功文本提取并进入观察分位;现有提取有局限,不能解释为官方阈值或获奖预测
- - `competitions/mcm/`: 规则基线已按 COMAP 2027 核对;经验模式是维护者启发,empirical 为 `n=0`
- - `competitions/diangong/`: 官网参赛规则与论文规范已于 2026-07-22 核对;经验模式是维护者启发,empirical 为 `n=0`
- - 通用模型清单 `references/model_catalog.md` 跨竞赛复用
- 当前 `scripts/ingest_papers.py` 是维护期归档工具,不能直接重建三个竞赛包的 `empirical.json`。新增语料前先补来源 provenance、提取 QA 与分组样本量。
- ---
- ## 与外部资源的关系
- 核心工作流可离线运行;当届规则与问题要求必须从官方来源重新核对。下列资源可作人工补充:
- - 国赛: `personqianduixue/Math_Model`, `datawhalechina/intro-mathmodel`, `dxs.moe.gov.cn` 优秀论文展廊
- - 美赛: COMAP 官网 `comap.com`, `MCM Tutorial` (Frank Giordano)
- - 电工杯: 中国电机工程学会论文集
README.md · README · 575 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="./assets/banner.svg" alt="mathmodel-skill:数学建模竞赛的 Agent 工作流,支持 CUMCM、MCM/ICM 与电工杯" width="100%">
- <h3>把 72–96 小时的数学建模竞赛,变成一条可恢复、可检查、可交付的 Agent 工作流</h3>
- <p>
- <a href="./.codex-plugin/plugin.json"><img src="https://img.shields.io/badge/version-v6.2.0-8B5CF6" alt="Version"></a>
- <a href="https://github.com/handsomeZR-netizen/mathmodel-skill/actions/workflows/ci.yml"><img src="https://github.com/handsomeZR-netizen/mathmodel-skill/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
- <a href="https://github.com/handsomeZR-netizen/mathmodel-skill/stargazers"><img src="https://img.shields.io/github/stars/handsomeZR-netizen/mathmodel-skill?style=flat&logo=github&color=F5B301" alt="GitHub Stars"></a>
- <a href="https://github.com/handsomeZR-netizen/mathmodel-skill/commits"><img src="https://img.shields.io/github/last-commit/handsomeZR-netizen/mathmodel-skill?color=10A37F" alt="Last Commit"></a>
- <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-22C55E" alt="License"></a>
- </p>
- <p>
- <a href="./competitions/"><img src="https://img.shields.io/badge/CUMCM%20%7C%20MCM%2FICM%20%7C%20%E7%94%B5%E5%B7%A5%E6%9D%AF-3%20competitions-F97316" alt="Competitions"></a>
- <a href="#-快速开始"><img src="https://img.shields.io/badge/Codex%20%7C%20Claude%20Code-ready-0EA5E9" alt="Codex and Claude Code"></a>
- <a href="./scripts/doctor.py"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python 3.10+"></a>
- </p>
- <p>
- <a href="#-快速开始"><b>快速开始</b></a> ·
- <a href="#-为什么是-mathmodel-skill"><b>核心亮点</b></a> ·
- <a href="#-30-秒看懂"><b>30 秒看懂</b></a> ·
- <a href="#-工作流全景"><b>工作流</b></a> ·
- <a href="#-竞赛支持"><b>竞赛支持</b></a> ·
- <a href="#-常见问题"><b>常见问题</b></a> ·
- <a href="#-star-history"><b>Star History</b></a>
- </p>
- </div>
- ---
- 数学建模比赛很少因为“缺少一个更聪明的回答”而失败。更常见的是:**模型换了,摘要没改;第二问重算了,第三问还在引用旧结果;关键假设只活在聊天记录里;直到提交前,才发现匿名、页数或 AI 披露不合规。**
- mathmodel-skill 不是一个试图一口气生成整篇论文的 Prompt,也不是替团队做决定的黑盒 Agent。它是一套**可执行的建模工作流**:把选题、拆题、模型选择、求解、稳健性分析、论文装配和终审组织成 10 个阶段,用一份共享决策日志保存整个项目的状态。团队只回答关键的编号问题,Agent 负责维护状态、调用脚本、整理产物。
- > [!TIP]
- > **一句话上手**:安装后在 Codex 里输入 `使用 $mathmodel-skill,开始 CUMCM 建模。`,或在 Claude Code 里说 `开始建模`。之后随时说 **“看进度”**,就能看到当前阶段、评分、合规门和下一步。
- ## ✨ 为什么是 mathmodel-skill
- <table>
- <tr>
- <td width="33%" valign="top">
- **🧭 10 阶段,一条主线**
- 选题 → 拆题 → 选型 → 求解 → 稳健性 → 写作 → 终审。每个阶段都有进入条件、退出条件和回退路径,Agent 在可检查的位置停下来,而不是一口气跑到底。
- </td>
- <td width="33%" valign="top">
- **🧠 一份状态,随时接力**
- `state/decision_log.json` 记录每个决定、依据、评分与回退。换队员、换对话、从 Codex 换到 Claude Code,都从同一个检查点继续,不靠聊天记忆。
- </td>
- <td width="33%" valign="top">
- **⚖️ 脚本裁决,不靠自评**
- Critic 打分之后,由 `score_artifact.py` 重新计算 verdict。任何关键维度低于门槛都会单独暴露,不会被加权均分“平均掉”。
- </td>
- </tr>
- <tr>
- <td width="33%" valign="top">
- **🎯 哪里错,只修哪里**
- Stage 5 按子问保存状态:`refine_partial` 只返工没通过的 Qi,其余结果保持不动;论文按 section patch 定向修补,不推倒重来。
- </td>
- <td width="33%" valign="top">
- **🛡️ 提交前 fail-closed**
- 占位符、缺失章节、模板 marker 错位会直接失败;当届规则、匿名、页数、AI 披露、支撑材料五道终审门不过,就不能标记 `submission_ready`。
- </td>
- <td width="33%" valign="top">
- **📊 一眼看进度** <sup>`v6.2 新`</sup>
- `status.py` 汇总 10 个阶段的 verdict、子问状态、合规门和截止倒计时,按剩余时间给出模式建议,并只给出**一条**明确的下一步。
- </td>
- </tr>
- </table>
- ### 它专门对付这些“翻车现场”
- | 😵 比赛中的常见情况 | ✅ 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 的环境会退化为编号列表,语义完全一致:
- ```text
- 【Stage 3 · Q1 用哪个候选模型?】
- 1) 混合整数规划 (MILP) — 目标与约束线性,求解器可给出最优性证明
- 2) 遗传算法 — 适合非凸、高维离散搜索
- 3) 禁忌搜索 — 中等规模组合优化,易实现
- 4) 让我决定(推荐 1:Stage 2 已标记目标为线性)
- 回复数字即可。
- ```
- **③ 任何时候说“看进度”** —— 下面是 `status.py` 对一份示例状态的真实输出:Stage 5 中只有 Q2 没过,所以下一步只精修 Q2。
- <div align="center">
- <img src="./assets/status-demo.svg" alt="status.py 进度看板示例:CUMCM 2026 A 题进行到 Stage 5,下一步只精修 Q2" width="88%">
- <br><sub>示例数据,仅用于展示看板格式</sub>
- </div>
- ## 🧭 工作流全景
- <div align="center">
- <img src="./assets/workflow.svg" alt="10 阶段主流程:Stage 0 团队启动到 Stage 9 提交终审,每阶段读写 decision_log.json" width="100%">
- </div>
- <br>
- | 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 一律由脚本重新计算:
- ```mermaid
- stateDiagram-v2
- direction LR
- state "L1 Critic 打分" as critic
- state "脚本重算 verdict" as verdict
- state "进入下一阶段" as next
- state "定向修补" as patch
- state "团队介入" as human
- [*] --> critic
- critic --> verdict
- verdict --> next: pass / pass_early
- verdict --> next: carryover
- verdict --> patch: refine / refine_partial
- patch --> critic: 迭代 +1
- verdict --> human: block
- human --> critic: 处理后重评
- ```
- | Verdict | 触发条件 | 行为 |
- | --- | --- | --- |
- | `block` | 存在至少 1 个高严重度问题 | 暂停流程,由团队介入 |
- | `pass_early` | 最低分 ≥ 9 且加权均分 ≥ 9 | 首轮即可提前通过 |
- | `pass` | 最低分 ≥ 7 且加权均分 ≥ 8 | 进入下一阶段 |
- | `pass_with_review` <sub>Stage 5</sub> | 个别 Qi 需复核,但加权阈值满足 | 进入 Stage 6,L2 必读复核项 |
- | `refine` | 其他情况 | section patch 精修,最多 3 轮 |
- | `refine_partial` <sub>Stage 5</sub> | 部分 Qi 最低分 < 7,其余已通过 | 只精修这些 Qi |
- | `carryover` | 达到迭代上限仍需精修 | 进入下一阶段,遗留问题交给 L2 回检 |
- ### 三种反馈模式
- 同一条主流程,只调整反馈预算和评审深度:
- | Mode | 反馈层 | 适用场景 |
- | --- | --- | --- |
- | `fast` | L1 单轮 | 选题试跑、快速 sanity check、时间紧张时的关键阶段 |
- | `standard` | L1 + L2 | 默认比赛流程 |
- | `championship` | L1 + L2 + L3 + L4 + red-team | 终稿前的深度评审 |
- `status.py` 会按剩余时间给出建议(< 6h 直接进 Stage 9 终审;6–24h 关键阶段用 `fast`;其余用 `standard`),但**切换模式始终需要团队确认**。
- ## 🏆 竞赛支持
- | 竞赛包 | 语言与模板 | 当前材料 | 可信度说明 |
- | --- | --- | --- | --- |
- | **🇨🇳 CUMCM 国赛** | 中文;XeLaTeX / 原创 `ctexart` 电子论文模板 | 91 份公开论文来源,其中 59 份成功提取文本进入统计;42 项维护者反模式检查 | 材料最完整;观察分位不是官方门槛,规则以当届通知为准 |
- | **🌍 MCM/ICM 美赛** | English;pdfLaTeX / `article` | 16 项维护者检查;已记录 COMAP 2027 页数、字号与 AI 披露基线 | 经验层 `n=0`,不提供论文分位;提交前必须重新核对 COMAP 要求 |
- | **⚡ 电工杯** | 中文;XeLaTeX / `ctexart` | 12 项工程导向检查;已记录官网页序、25 页正文、支撑材料与匿名基线 | 经验层 `n=0`;当前官网未提供专门 AI 格式,仍需检查当届通知 |
- <details>
- <summary><b>截至 2026-07-22 已核对的官方规则入口</b></summary>
- - [CUMCM 2026 竞赛规则](https://www.mcm.edu.cn/html_cn/node/9d8e511fe7a1447b35f53a82c908e2e0.html)
- - [CUMCM 2026 论文格式规范](https://www.mcm.edu.cn/html_cn/node/4cd596519c9eb9fbd866398f6df0caa3.html)
- - [COMAP 2027 Instructions](https://www.contest.comap.com/undergraduate/contests/mcm/instructions.php)
- - [电工杯参赛规则](https://shumo.neepu.edu.cn/jszz/csgz.htm)
- - [电工杯论文规范](https://shumo.neepu.edu.cn/jszz/lwgf.htm)
- 这些链接构成仓库当前的规则基线,但不能替代参赛当年的官方文件。
- </details>
- ## 🚀 快速开始
- ### 1. 安装
- **Codex(macOS / Linux)**
- ```bash
- git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \
- ~/.agents/skills/mathmodel-skill
- python ~/.agents/skills/mathmodel-skill/scripts/doctor.py --competition cumcm
- mkdir -p my-modeling-project && cd my-modeling-project
- codex
- ```
- <details>
- <summary><b>Codex(Windows PowerShell)</b></summary>
- ```powershell
- git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git `
- "$HOME\.agents\skills\mathmodel-skill"
- python "$HOME\.agents\skills\mathmodel-skill\scripts\doctor.py" `
- --competition cumcm
- New-Item -ItemType Directory -Force my-modeling-project | Out-Null
- Set-Location my-modeling-project
- codex
- ```
- </details>
- <details>
- <summary><b>只安装到当前项目(项目级 skill)</b></summary>
- ```bash
- mkdir -p .agents/skills
- git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \
- .agents/skills/mathmodel-skill
- ```
- </details>
- **Claude Code**
- ```bash
- git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \
- ~/.claude/skills/mathmodel-skill
- mkdir -p my-modeling-project && cd my-modeling-project
- claude
- ```
- ### 2. 开口说一句
- | 环境 | 输入 |
- | --- | --- |
- | Codex | `使用 $mathmodel-skill,开始 CUMCM 建模。` |
- | Claude Code | `开始建模`,或 `使用 mathmodel-skill 开始 MCM 建模` |
- 首次启动时,Agent 只询问还缺的竞赛、题号、队伍能力、截止时间和题面位置,然后初始化工作区并进入 Stage 0;工作区已有状态时,则从最近的检查点继续。
- ### 3. 之后只需要回答问题
- Agent 会在需要判断的节点停下来问你;状态写入、文件组织和脚本调用都由它完成。任何时候都可以说:
- `看进度` · `进入 stage N` · `回退到 stage M` · `做 L2 回检` · `升级到 championship` · `切到 mcm`
- > [!NOTE]
- > 想先手动体验看板?两条命令即可(`init_workspace.py` 只创建、不覆盖已有状态):
- >
- > ```bash
- > python ~/.agents/skills/mathmodel-skill/scripts/init_workspace.py \
- > --competition cumcm --workspace . --problem 未公布 --hours-left 72
- > python ~/.agents/skills/mathmodel-skill/scripts/status.py --workspace .
- > ```
- <details>
- <summary><b>可选:完整数值环境与论文编译</b></summary>
- 核心工作流和 `doctor.py --skip-tools` 不依赖完整的科学计算栈。只有需要运行仓库中的建模起步代码时,才需要安装额外依赖:
- ```bash
- python -m pip install -r \
- ~/.agents/skills/mathmodel-skill/templates/shared/requirements.txt
- ```
- 正式进行论文转换与编译时,还需要安装 [Pandoc](https://pandoc.org/installing.html) 和 TeX Live 或 MiKTeX:CUMCM 与电工杯使用 XeLaTeX,MCM/ICM 使用 pdfLaTeX。内置简化转换器仅用于 `--no-compile` 结构预检,不应作为正式论文的编译方式。
- </details>
- ## 📦 工作区产物
- ```text
- my-modeling-project/ # 由 init_workspace.py 创建
- ├── state/
- │ └── decision_log.json # 决策、评分、回退、规则与 AI 使用台账
- ├── results/ # 结构化结果与可复现实验输出
- ├── figures/ # 最终图表
- ├── paper_workspace/ # 01_abstract.md … 10_appendix.md,以及按需披露片段
- ├── paper_output/ # TeX 中间文件与最终 PDF
- └── support_materials/ # 代码、数据清单与竞赛要求的披露材料
- ```
- Codex 与 Claude Code 可以在同一目录中接力。`decision_log.json` 负责保存流程状态,但不会自动同步工作区之外的文件。
- ## 🧰 工具箱
- 模型负责需要判断的工作,脚本负责可以确定的工作,团队保留最终决定权。
- | 工具 | 用途 | 典型调用 |
- | --- | --- | --- |
- | `scripts/init_workspace.py` <sup>新</sup> | 创建工作区与初始状态;已有状态时只报告恢复点,从不覆盖 | `python <skill>/scripts/init_workspace.py --competition mcm --problem C --hours-left 96` |
- | `scripts/status.py` <sup>新</sup> | 只读进度看板:阶段 verdict、per-Qi、合规门、倒计时、模式建议与下一步 | `python <skill>/scripts/status.py --workspace . --markdown` |
- | `scripts/doctor.py` | 检查 skill 结构、竞赛包、环境与工作区 | `python <skill>/scripts/doctor.py --competition mcm` |
- | `scripts/score_artifact.py` | 校验 critic JSON、重算加权分数与 verdict、聚合 per-Qi | `python <skill>/scripts/score_artifact.py --stage 5 --critique ...` |
- | `scripts/extract_diff.py` | 生成并应用 section-level patch | `python <skill>/scripts/extract_diff.py --apply ...` |
- | `scripts/render_paper.py` | 将 Markdown 工作区装配为三类竞赛的 TeX/PDF | `python <skill>/scripts/render_paper.py --competition cumcm --workspace paper_workspace` |
- | `scripts/render_ai_usage.py` | 根据台账生成 CUMCM/MCM AI 使用披露材料 | `python <skill>/scripts/render_ai_usage.py --competition mcm ...` |
- | `scripts/ingest_papers.py` | 供维护者离线更新经验统计 | 见 [`scripts/README.md`](./scripts/README.md) |
- 完整 CLI 参数与依赖边界见 [`scripts/README.md`](./scripts/README.md)。
- ## 🧠 设计原则
- ```mermaid
- flowchart LR
- A["题目与团队约束"] --> B["10 阶段主流程"]
- C["竞赛特化包"] --> B
- D[("decision_log.json")] <--> B
- B --> E["模型 · 结果 · 图表 · 论文"]
- E --> F["L1 / L2 / L3 / L4 反馈"]
- F -->|"定向修补"| B
- D -.-> G["status.py 进度看板"]
- ```
- 系统由三部分组成:**主流程**定义阶段顺序、进入/退出条件和回退路径;**共享决策日志**是项目的连续记忆;**确定性工具**承担评分重算、模板装配、环境诊断、差分应用、AI 披露生成和合规检查。
- <details>
- <summary><b>工作流优先于超长 Prompt</b></summary>
- 更长的 Prompt 可以增加背景信息,却不能天然维护状态、依赖与回退路径。这里仍然使用模型完成各阶段任务,但“项目现在在哪里”“上一阶段决定了什么”“什么条件下可以继续”由工作流显式维护。上下文可以变化,项目结构不需要随之消失。
- </details>
- <details>
- <summary><b>检索提供证据,不管理流程</b></summary>
- RAG 很适合寻找竞赛规则、领域论文、真实数据和方法依据,但它并不负责决定下一阶段,也不会自动判断新结果是否推翻旧假设。因此,仓库内材料采用版本可控、按阶段加载的竞赛包;外部检索负责提供证据,主流程负责组织行动。
- </details>
- <details>
- <summary><b>Multi-Agent 只用于适合并行比较的环节</b></summary>
- 多个 Agent 在选题比较、模型攻击和终稿评审中很有价值,但如果每一步都依赖多方协商,协调成本和符号漂移会迅速增加。主流程始终围绕一份共享日志推进;终稿 Panel 可以并行执行,也可以在单 Agent 环境中顺序降级。
- </details>
- <details>
- <summary><b>自动化停在可以检查的位置</b></summary>
- `fast` 和 `standard` 模式都可以由一个 Agent 完成,但每个阶段仍然留下明确产物,关键选择仍然需要确认,评分仍然由脚本重算,问题仍然可以按 section 或 Qi 局部修补。团队可以随时查看进度、接管项目、切换模型,或回到某个具体决定,而不必从头重做。
- </details>
- <details>
- <summary><b>更多小而重要的设计</b></summary>
- - **只加载当前阶段需要的材料**:根目录 `SKILL.md` 只承担调度职责,阶段细则、rubric、竞赛规则和模板按需加载。
- - **一条流程服务三类竞赛**:差异被限制在 `competitions/<comp>/`、题型与阶段权重、LaTeX 模板、提交与披露规则。
- - **最低分不会被均分覆盖**:题型权重被限制在 `[0.7, 1.5]`,避免局部偏好过度放大。
- - **经验数据只作为参照**:CUMCM 分位描述的是公开样本中的观察位置,不是官方评分线;MCM/ICM 与电工杯的经验层明确记录为 `n=0`。
- - **规则记录日期,但不假装永久有效**:`current_rules.md` 保存最近核对日期和官方入口,Stage 0、8、9 仍要求重新查看当届通知。
- - **AI 使用从过程开始记录**:台账记录工具、版本、阶段、用途、采用内容和人工复核;`null` 永远不等于“未使用”。
- - **看板只读**:`status.py` 从不修改状态;模式建议只是建议,切换需要团队确认并写入 events。
- - **能自动验证的内容不依赖“记得检查”**:YAML/JSON、竞赛包、反模式计数、评分边界、模板 marker、渲染 dry-run、工作区初始化与看板均有自动测试覆盖。
- </details>
- ## ❓ 常见问题
- <details>
- <summary><b>它会替我们写完整篇论文吗?</b></summary>
- 不会一口气生成。它按阶段推进、在关键节点让团队决策,并把论文拆成可单独修补的章节。公式、代码、数据、事实、引用和最终署名仍由团队负责。
- </details>
- <details>
- <summary><b>能保证获奖,或者预测我们能拿几等奖吗?</b></summary>
- 不能。`pass`、`refine` 等 verdict 描述的是流程状态,不是奖项预测;CUMCM 经验分位只是公开样本中的观察位置,不是官方评分线。
- </details>
- <details>
- <summary><b>队友用 Codex,我用 Claude Code,能一起用吗?</b></summary>
- 可以接力。两个环境读写同一份 `state/decision_log.json` 和相同的 schema。共享来自项目目录而不是云同步,所以请用 git 或网盘同步整个工作区。
- </details>
- <details>
- <summary><b>没装 LaTeX / Pandoc 能用吗?</b></summary>
- 可以。核心工作流、`init_workspace.py`、`status.py` 和 `doctor.py --skip-tools` 都不依赖它们;只有正式编译 PDF 时才需要。`render_paper.py --no-compile` 可以先做结构预检。
- </details>
- <details>
- <summary><b>比赛规则每年都在变,怎么办?</b></summary>
- `competitions/<comp>/current_rules.md` 记录核对日期和官方入口,Stage 0、8、9 会要求重新核对当届通知。仓库保存的只是基线,**官方文件永远优先**。
- </details>
- <details>
- <summary><b>比赛中用了 AI,要怎么披露?</b></summary>
- 从第一天开始记录 AI 使用台账。`render_ai_usage.py` 会为 CUMCM 生成支撑材料 PDF 或正文声明,为 MCM 生成接入主模板的 AI 使用报告。台账为 `null` 时会被视为“尚未核对”,而不是“未使用”。
- </details>
- <details>
- <summary><b>离截止只剩几个小时了,还有用吗?</b></summary>
- 有。说“看进度”,`status.py` 会按剩余时间给出建议:不足 6 小时建议直接进入 Stage 9 的 championship 终审,优先保证合规门。是否切换由团队决定。
- </details>
- <details>
- <summary><b>普通数据分析、课程论文能用它吗?</b></summary>
- 不建议。触发边界刻意限定在 CUMCM、MCM/ICM 和电工杯的竞赛工作;通用的模型选择或非竞赛写作不会、也不应该触发它。
- </details>
- ## 📜 版本演进
- ```mermaid
- timeline
- title mathmodel-skill 演进
- V3 : CUMCM 单赛工作流 : 10 阶段 + rubric 自评
- v4 : 三竞赛通用化 : per-Qi 加权与题型权重
- v5 : Codex 平行兼容 : 全程问答式 Friendly Mode
- v6.0 : Codex 原生 Skill 与 Plugin 打包
- v6.1 : doctor 预检 : fail-closed 模板 : AI 使用披露
- v6.2 : 工作区初始化 : 进度看板与下一步
- ```
- ### v6.2 · 看得见的进度
- - 新增 `scripts/init_workspace.py`:按 Stage 0 已知答案一次性创建 `state/`、`results/`、`figures/`、`paper_workspace/`、`paper_output/`、`support_materials/` 与初始状态。它只创建、不覆盖:已有状态时只报告恢复点,竞赛不一致或文件损坏时明确失败。
- - 新增 `scripts/status.py`:只读汇总 10 个阶段的最新 verdict 与分数、Stage 5 子问状态、规则基线 / AI 台账 / 五道终审门、截止倒计时和模式建议,并给出唯一的下一步;支持终端、Markdown 与 JSON 输出。
- - “开始建模”和“看进度”改为调用上述脚本,Codex 与 Claude Code 得到同样的结果;`doctor.py` 与 CI 同步覆盖新脚本。
- - README 全面改版:动态横幅、10 阶段流程图、看板示例、verdict 状态机、FAQ 与自动更新的 Star History。
- <details>
- <summary><b>v6.1 · 可靠性与合规</b></summary>
- - 新增 `doctor.py`,统一检查包结构、竞赛包、反模式计数、模板 marker 和工具链状态。
- - 三类竞赛生成的 section 会自动接入 `main.tex`;缺失章节、空章节、未知 marker 或重复 marker 都会明确失败,正式编译不会静默降级。
- - CUMCM 改用仓库原创、MIT 授权的 `ctexart` 电子论文模板;模板不包含身份字段,并对摘要页、正文页数和最终提交元数据执行 fail-closed 检查。
- - 评分器改为由脚本重新计算 verdict,同时校验 stage、iteration、最低分、均分和题型权重。
- - `extract_diff.py --apply` 不再要求与应用差分无关的 critique 输入。
- - 新增 AI 使用台账与披露生成器:CUMCM 根据“已使用 / 明确未使用”生成支撑材料 PDF 或正文声明;MCM 报告自动进入主模板。
- - 补充电工杯官网规则基线,将封面、摘要起始页码、无目录、正文与附录顺序纳入模板和终审门。
- - 修复分类交叉验证中的标准化泄漏、优化示例中的不可行贪心基线、熵权法常数列、GM(1,1) 极限和 MAPE 零值边界。
- - 将 CUMCM 样本口径校准为“91 份来源、59 份可提取文本”;Stage 9 按当前竞赛动态加载反模式清单。
- </details>
- ## 🔒 边界与可信度
- > [!IMPORTANT]
- > mathmodel-skill 是协作与质量控制工具,**不是自动获奖系统**。它不会消除建模本身的不确定性,也不能替代团队对公式、代码、数据、事实、引用和最终署名的责任。
- - CUMCM 统计来自公开样本中成功提取文本的 59 份论文,可能受到年份、题型、来源和 PDF 可提取性的影响。
- - `winning_patterns.md`、经验分位和反模式清单属于维护者总结,不是官方 rubric。
- - MCM/ICM 与电工杯的经验统计目前均为 `n=0`,相关写作模式只能作为启发,不能解释为实测获奖规律。
- - 竞赛规则会变化。仓库保存的是最近一次核对的基线,正式提交前必须以当届官方通知和题目要求为准。
- - AI 生成的公式、代码、事实和引用必须由团队复核。台账和披露生成器帮助完整记录,但不代替合规判断。
- ## 🧪 开发与验证
- ```bash
- python -m compileall -q scripts templates/shared/code_starter
- python -m unittest discover -s tests -p 'test_*.py' -v
- python scripts/doctor.py --competition cumcm --skip-tools
- python scripts/doctor.py --competition mcm --skip-tools
- python scripts/doctor.py --competition diangong --skip-tools
- git diff --check
- ```
- 当工作流、模板或竞赛包发生变化时,请同步更新测试、版本号和规则核对日期。
- <details>
- <summary><b>仓库结构</b></summary>
- ```text
- SKILL.md # 工作流主入口与调度协议
- agents/openai.yaml # Codex UI 元数据
- .codex-plugin/plugin.json # Codex Plugin manifest
- skills/mathmodel-skill/SKILL.md # Plugin 发现 shim
- AGENTS.md # 仓库维护约定
- assets/ # README 使用的原创 SVG 图示
- competitions/
- cumcm/ # 规则、59 份样本统计、写作启发、评分覆盖与模板骨架
- mcm/ # COMAP 规则基线;经验统计 n=0
- diangong/ # 官网规则基线;经验统计 n=0
- references/
- stage_00_* ... stage_09_* # 按阶段加载的执行细则
- feedback_layer1_* ... layer4_* # 阶段评分、回检、Panel 与校准
- model_catalog.md # 模型候选目录
- templates/
- latex/{cumcm,mcm,diangong}/ # 三类竞赛 LaTeX 模板
- shared/ # 状态、AI 台账、表格与 Python 起步代码
- config/dim_weights.json # 竞赛 × 题型 × 阶段的评分权重
- scripts/ # 初始化、看板、环境检查、评分、差分、装配、披露与维护工具
- tests/ # 回归测试与 fixture
- ```
- </details>
- ## ⭐ Star History
- <div align="center">
- <a href="https://star-history.com/#handsomezr-netizen/mathmodel-skill&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=handsomezr-netizen/mathmodel-skill&type=Date&theme=dark">
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=handsomezr-netizen/mathmodel-skill&type=Date">
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=handsomezr-netizen/mathmodel-skill&type=Date" width="720">
- </picture>
- </a>
- <br>
- <sub>图表由 <a href="https://star-history.com">star-history.com</a> 实时生成,随 Star 数自动更新,并跟随 GitHub 的深色 / 浅色主题。</sub>
- </div>
- ## 🤝 参与贡献
- 参与贡献前请先阅读 [`AGENTS.md`](./AGENTS.md)。Bug、规则更新与改进建议都可以通过 [Issue](https://github.com/handsomeZR-netizen/mathmodel-skill/issues) 提交;如果你核对过新一届的官方规则,也非常欢迎直接提 PR 更新 `competitions/<comp>/current_rules.md`。
- ## 📄 License
- 仓库原创代码、文档、README 图示以及三类竞赛装配模板采用 [MIT License](./LICENSE)。运行时依赖和外部资料链接仍遵循各自的许可条款,详细边界见 [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md)。
- ---
- <div align="center">
- **mathmodel-skill 不替团队完成思考。**<br>
- 它让每一次判断都留下依据,让每一次修改都知道影响范围,也让一场漫长的建模协作最终能够被完整地交付。
- <sub>如果它对你的队伍有帮助,欢迎点一个 ⭐ Star,让更多参赛同学看到它。</sub>
- <a href="#top">⬆ 回到顶部</a>
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.