Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/handsomezr-netizen--mathmodel-skill/badge.svg)](/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

i

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)

  1. ---
  2. name: mathmodel-skill
  3. 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.
  4. ---
  5. # mathmodel-skill — 数学建模三竞赛工作流 (v6.2)
  6. 10 阶段把 72–96 小时的竞赛协作变成可恢复、可检查的流程。用户回答关键问题,agent 维护状态与脚本。每阶段产出经过 rubric 自评、定向精修与跨阶段一致性回检;Stage 8–9 先遵守当届官方规则,再做多视角终审。CUMCM 包含 91 份来源文档,其中 59 份进入文本统计;MCM/电工杯经验统计明确为 `n=0`,不提供合成分位。
  7. **v6.2 更新**: 新增 `scripts/init_workspace.py`(只创建、不覆盖的工作区初始化)与 `scripts/status.py`(只读进度看板:阶段 verdict、per-Qi、合规门、截止倒计时、模式建议与下一步);启动与“看进度”改由脚本确定性完成。v6.1 的规则基线、AI 披露链路、fail-closed 模板与 doctor 预检保持不变。
  8. ---
  9. ## Codex 原生入口
  10. Codex 优先按 skill 目录发现本文件:
  11. - 用户级安装: `$HOME/.agents/skills/mathmodel-skill/`
  12. - 项目级安装: `<repo>/.agents/skills/mathmodel-skill/`
  13. - UI 元数据: `agents/openai.yaml`
  14. - 插件分发元数据: `.codex-plugin/plugin.json` + `skills/mathmodel-skill/SKILL.md` shim
  15. - 项目指导: `AGENTS.md` 仍可作为 repo / workspace 级 instructions, 但不是唯一入口
  16. 当 skill 已安装后, 用户可直接说"开始建模"或显式说"使用 `$mathmodel-skill` 开始建模"。
  17. ---
  18. ## Harness 兼容 (Claude Code / Codex)
  19. 本 skill v6.2 以 Codex Skills 为一等入口, 同时保持 harness-agnostic 设计:
  20. | harness | 入口文件 | 用户交互工具 | 状态文件 |
  21. |---------|---------|-------------|---------|
  22. | Claude Code | `SKILL.md` (本文件) | `AskUserQuestion` 工具 | `<cwd>/state/decision_log.json` |
  23. | Codex CLI / Codex app | skill 目录中的 `SKILL.md` + 可选 `AGENTS.md` | markdown 编号列表 | 同上 (**互通**) |
  24. 跨 harness 互通: day 1 用 Codex 跑 stage 0-2, day 2 切回 Claude Code 接着 stage 3+, 状态完全保留。详见 `references/harness_compat.md`。
  25. ---
  26. ## 问答式优先 (Friendly Mode)
  27. **核心原则**: 用户只需回答**编号问题**, 不应被要求手敲 bash / python / json。
  28. - 离散选项 (选竞赛 / 选题 / 选模型 / verdict 决策) → **必须**用问答式
  29. - 自由文本 (PDF 路径 / 截止时间) → 单行回复
  30. - 状态读写 (decision_log.json) → agent 自动完成
  31. - 每个 stage 的关键决策点都有 "让我决定 (推荐 X)" 兜底选项
  32. 优先使用当前 harness 可用的原生选择 UI;没有时回退到 markdown 编号列表。两者语义等价,见 `references/harness_compat.md` §1。
  33. ---
  34. ## 路径解析协议 (任何阶段必读)
  35. | 类型 | 位置 | 例 |
  36. |------|------|-----|
  37. | skill 内通用 | skill 根目录的相对路径 | `references/stage_05_subproblem_loop.md`, `templates/shared/decision_log.json` |
  38. | **竞赛特化** | `competitions/<comp>/...` 按 decision_log.competition dispatch | `competitions/cumcm/winning_patterns.md`, `competitions/mcm/abstract_template.md` |
  39. | **LaTeX 模板** | `templates/latex/<comp>/main.tex` | `templates/latex/cumcm/main.tex`, `templates/latex/mcm/main.tex` |
  40. | 用户产物 | 用户工作目录的相对路径 | `<cwd>/state/`, `<cwd>/results/`, `<cwd>/figures/`, `<cwd>/paper_workspace/` |
  41. | state 持久化 | `<cwd>/state/decision_log.json` | 各 stage 必读必写 |
  42. | 环境变量 | `MATHMODEL_STATE_DIR` (兼容 `CUMCM_STATE_DIR`) / `MATHMODEL_COMPETITION` 可覆盖 | scripts 用此变量 |
  43. 约定: `<skill>/` = skill 安装目录, `<cwd>/` = 用户 cwd, `<comp>/` = 当前竞赛 (cumcm | mcm | diangong)。
  44. ---
  45. ## Quick Start (用户首次说"开始建模")
  46. ```
  47. 1. 一段话介绍 (≤50 字): "启动数学建模工作流, 10 阶段 + 三竞赛, 全程问答式."
  48. 2. 收集下列 5 个启动字段;用户已经提供或 state 已记录的字段不再询问,只把尚缺字段合并成一轮问答 (Claude Code: AskUserQuestion; Codex: 编号列表):
  49. - 竞赛 (cumcm 国赛 / mcm 美赛 / diangong 电工杯, 默认 cumcm)
  50. - 题号 (依竞赛: cumcm A-E / mcm A-F / diangong A-B; "未公布"亦可)
  51. - 队员数 + 各人擅长 (建模/编程/写作)
  52. - 截止时间 (ISO 字符串或 "距现在 X 小时")
  53. - 题目 PDF 路径 ("未公布"亦可)
  54. 3. 自动初始化 (agent 自动完成, 不要让用户编辑 json):
  55. - 运行 `python <skill>/scripts/init_workspace.py --competition <comp> --workspace <cwd>`,按已知答案追加 `--problem <题号|未公布>`、`--team-size N`、`--deadline <ISO>` 或 `--hours-left H`、`--problem-pdf <path>`
  56. - 脚本创建 `state/ results/ figures/ paper_workspace/ paper_output/ support_materials/`,从模板生成 state 并写入 competition 与 problem_meta
  57. - state 已存在时脚本**不修改**任何内容,只报告 competition 与 current_stage;竞赛不一致时失败,按“切到 <comp>”处理
  58. - 脚本输出的模式建议只是建议;与用户确认后才改 mode 并写入 events
  59. - 无法运行 Python 时,才手动复制 `<skill>/templates/shared/decision_log.json` 并写入 competition
  60. 4. 加载 `competitions/<comp>/current_rules.md`(若存在),打开其中官方链接核对当届规则并写入 compliance;再按需加载 winning patterns
  61. 5. 进入 Stage 0 (`references/stage_00_kickoff.md`), 不重复问已知字段;若题面未公布,完成环境与协作准备后保持 `qi_count=null` 并等待题面,不进入 Stage 1
  62. ```
  63. **已有 state 触发** (用户中途回到 skill):
  64. ```
  65. 1. 运行 `python <skill>/scripts/status.py --workspace <cwd> --json` 取得 competition、current_stage、最新 verdict 与下一步;需要细节时再读 `<cwd>/state/decision_log.json`
  66. 2. 加载对应 stage_NN.md (按需结合 competitions/<comp>/* 内容)
  67. 3. 不重复读 winning_patterns
  68. ```
  69. ---
  70. ## 三竞赛 × 三模式 矩阵
  71. 时长 / 语言 / 模板 / 数据状态 由 competition 决定; token 预算 / 反馈深度由 mode 决定。两者**正交组合**。
  72. | Competition | 时长 | 语言 | LaTeX | 规则基线 | 经验数据状态 |
  73. |---|---|---|---|---|---|
  74. | cumcm | 72h | 中文 | xelatex / 原创 ctexart | CUMCM 2026 | 91 来源文档 / 59 可提取样本 |
  75. | mcm | 96h | English | pdflatex / article | COMAP 2027 | `n=0`,无论文分位 |
  76. | diangong | 72h | 中文 | xelatex / ctex | 官网 2026-03-21 页面 | `n=0`,无论文分位 |
  77. | Mode | 上下文策略 | 反馈层 | 用途 |
  78. |---|---|---|---|
  79. | fast | 只保留当前阻断项与最小证据 | L1 单次 | 选题试跑 / sanity check |
  80. | standard | 按阶段加载并保留决策摘要 | L1+L2 | 默认主流程 |
  81. | championship | 在终审阶段扩展证据与独立视角 | L1+L2+L3+L4 + red-team | 提交前最后冲刺 |
  82. 模式自动推荐 (按距 deadline 剩余;`scripts/status.py` 按同一规则计算,仅作建议):
  83. - > 60h: standard (最后 6h 升 championship)
  84. - 24-60h: standard
  85. - 6-24h: fast 关键阶段 + championship 终审
  86. - < 6h: 直接进 stage 9 (championship)
  87. ---
  88. ## 10 阶段索引
  89. | # | 阶段 | reference | 时长 | 反馈 | 竞赛差异点 |
  90. |---|------|-----------|------|------|-----------|
  91. | 0 | 团队启动 + 资料预扫 | `stage_00_kickoff.md` | 1h | L1 | 时长 / 语言 / 编译器 / 题号体系 |
  92. | 1 | 选题 (多题对比 → 1) | `stage_01_problem_selection.md` | 2-4h | L1 | 题号体系 (A-E/A-F/A-B) + task_type 写入 |
  93. | 2 | 问题深度解析与分解 | `stage_02_analysis.md` | 2-3h | L1 | 通用 |
  94. | 3 | 模型选型 (证据驱动的候选比较) | `stage_03_model_selection.md` | 2-4h | L1 + 反事实 | 通用 |
  95. | 4 | Foundation (假设+符号+术语) | `stage_04_foundation.md` | 1h | L1 | 通用 |
  96. | 5 | **递归子问题循环** Q1..Qn + per-Qi 加权聚合 | `stage_05_subproblem_loop.md` | 按题目分配 | L1 + 子检查点 | 从题面提取实际子问数;per-Qi 加权 |
  97. | 6 | 全局灵敏度 / 稳健性 | `stage_06_robustness.md` | 2-3h | L1 + L2 | 工程参数 (diangong) vs 数学参数 (cumcm/mcm) |
  98. | 7 | 模型评价 + 推广 | `stage_07_evaluation.md` | 1-2h | L1 | 通用 |
  99. | 8 | 论文写作 + 合规装配 | `stage_08_writing.md` | 12-30h | L1 + L2 | 当届规则、AI 披露、摘要类型与 LaTeX 模板 |
  100. | 9 | 提交合规 + Panel | `stage_09_review.md` | 2-6h | L1 + L3 panel | 页数/匿名/披露 + anti-patterns + personas |
  101. ---
  102. ## 加载协议 (节省 token 的关键)
  103. **只在进入阶段 N 时加载** `references/stage_NN_*.md`。**切勿**一次性全读。
  104. 各阶段额外加载 (按需 + 按 competition 切换):
  105. - 每阶段开头: `<cwd>/state/decision_log.json` 必读
  106. - 每阶段结尾: `<cwd>/state/decision_log.json` 必写 (核心决策 + 5 维评分)
  107. - stage 1-9: `references/rubrics.md` 对应章节 (L1 评分用)
  108. - **stage 1**: `competitions/<comp>/topic_specs.json` (题号 → task_type 映射)
  109. - stage 3, 5: `references/model_catalog.md` (跨竞赛通用)
  110. - **stage 5**: per-Qi 评分跑完后调 `scripts/score_artifact.py --mode aggregate_qi` 聚合
  111. - **stage 0 / 8 / 9**: `competitions/<comp>/current_rules.md` 存在时读取,并核对其中官方链接
  112. - **stage 8**: `competitions/<comp>/{winning_patterns, phrase_bank, abstract_template, paper_skeleton}.md`
  113. - **stage 8 经验锚点**: `competitions/<comp>/empirical.json` 只作评分前参考;CUMCM 为 59 份可提取样本的观察分位,MCM/电工杯为 `n=0` 占位且不得推断数值门槛
  114. - **stage 9**: 先做规则合规门,再用 `anti_patterns.md` 与 `rubric_overlay.json` 的 panel personas
  115. - 触发反馈时: 对应 `references/feedback_layer*.md`
  116. - harness 适配差异 (Codex 用户必读): `references/harness_compat.md`
  117. ---
  118. ## 收敛准则 (统一定义, 三处一致)
  119. **verdict 优先级 (从高到低)**:
  120. | verdict | 触发 | 行为 |
  121. |---------|------|------|
  122. | `block` | issues 含 ≥1 high-severity | 暂停 skill, 用户介入 |
  123. | `pass_early` | raw_min ≥ 9 AND weighted_mean ≥ 9 | iter-1 早退 |
  124. | `pass` | raw_min ≥ 7 AND weighted_mean ≥ 8 | 进下一阶段 |
  125. | `pass_with_review` *(stage 5)* | 任 Qi mark_for_review 但加权阈值满足 | 进 stage 6, L2 必读 review_qis |
  126. | `refine` | 其他 | section-patch 精修, iter+=1 (cap 3) |
  127. | `refine_partial` *(stage 5)* | 任 Qi.min < 7, 其他 Qi 已 pass | 仅 refine 该 Qi, 不动其他 |
  128. | `carryover` | iter == 3 仍 refine | 进下一阶段, 标记由 L2 处理 |
  129. `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 等价老逻辑。
  130. 此定义在 `feedback_layer1_critic.md` / `rubrics.md` / `scripts/score_artifact.py` 三处必须**完全一致**。
  131. ---
  132. ## 状态持久化
  133. 每阶段:
  134. - 开头: 读取 `<cwd>/state/decision_log.json`, 核对 current_stage 与上下文
  135. - 结尾: 更新 stage 节点 (核心决策 + 摒弃方案 + 评分), `current_stage += 1`
  136. `decision_log.json` v3.1 schema 关键字段 (与 `templates/shared/decision_log.json` 对齐):
  137. - root: `competition`, `task_type`, `mode`, `current_stage`, `budget`, `events`, `compliance`
  138. - stage_5 扩展: `qi_count`, `qi_weights`, `qi_status`
  139. - scores 扩展: 含 `weighted_mean`, `review_qis`, `refine_qis` (stage 5 加权聚合用)
  140. L2 跨阶段回检 (stage 5/6/8 末尾) 读这个文件主动找冲突, 触发**定向回滚**: 不重做整阶段, 只针对冲突点。
  141. ---
  142. ## 上下文预算纪律
  143. - L1 Critic 强制 JSON 输出, ~500 token/次
  144. - 精修策略: section-level patch (`scripts/extract_diff.py`), 优先只传相关 section
  145. - references/ 与 competitions/ 文件**懒加载**, 本 SKILL.md 主体 ≤ 6k tokens
  146. - 阶段完成后, artifact 摘要 + 关键数据 + 路径写入 decision_log, 不在上下文保留全文
  147. - 只有当前 harness / API 提供可靠 usage 时才记录 token 消耗;不可观测时保留为 `null`,不得估算成已用额度
  148. - 上下文压力或剩余时间不足时,向用户建议从 championship → standard → fast 降级,并把确认后的 mode change 写入 events;不要声称已自动计量或静默切换
  149. ---
  150. ## 用户指令快捷
  151. - "进入 stage N" / "重做 stage N" → 跳转
  152. - "切到 mcm" / "切到 cumcm" / "切到 diangong" → 改 decision_log.competition (注意已有 state 兼容性)
  153. - "升级到 championship" → 启用 L3 + L4 + red-team
  154. - "切到 fast" → 关闭迭代
  155. - "回退到 stage M" → 读 decision_log, 回退 current_stage 并清理 ≥M 节点
  156. - "做 L2 回检" → 立即触发 cross-stage backtrack
  157. - "看进度" → 运行 `python <skill>/scripts/status.py --workspace <cwd> --markdown`,原样展示看板与下一步 (只读,不改 state)
  158. ---
  159. ## 数据来源声明
  160. - `competitions/cumcm/`: 91 份来源文档,59 份成功文本提取并进入观察分位;现有提取有局限,不能解释为官方阈值或获奖预测
  161. - `competitions/mcm/`: 规则基线已按 COMAP 2027 核对;经验模式是维护者启发,empirical 为 `n=0`
  162. - `competitions/diangong/`: 官网参赛规则与论文规范已于 2026-07-22 核对;经验模式是维护者启发,empirical 为 `n=0`
  163. - 通用模型清单 `references/model_catalog.md` 跨竞赛复用
  164. 当前 `scripts/ingest_papers.py` 是维护期归档工具,不能直接重建三个竞赛包的 `empirical.json`。新增语料前先补来源 provenance、提取 QA 与分组样本量。
  165. ---
  166. ## 与外部资源的关系
  167. 核心工作流可离线运行;当届规则与问题要求必须从官方来源重新核对。下列资源可作人工补充:
  168. - 国赛: `personqianduixue/Math_Model`, `datawhalechina/intro-mathmodel`, `dxs.moe.gov.cn` 优秀论文展廊
  169. - 美赛: COMAP 官网 `comap.com`, `MCM Tutorial` (Frank Giordano)
  170. - 电工杯: 中国电机工程学会论文集
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)

  1. <div align="center">
  2. <img src="./assets/banner.svg" alt="mathmodel-skill:数学建模竞赛的 Agent 工作流,支持 CUMCM、MCM/ICM 与电工杯" width="100%">
  3. <h3>把 72–96 小时的数学建模竞赛,变成一条可恢复、可检查、可交付的 Agent 工作流</h3>
  4. <p>
  5. <a href="./.codex-plugin/plugin.json"><img src="https://img.shields.io/badge/version-v6.2.0-8B5CF6" alt="Version"></a>
  6. <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>
  7. <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>
  8. <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>
  9. <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-22C55E" alt="License"></a>
  10. </p>
  11. <p>
  12. <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>
  13. <a href="#-快速开始"><img src="https://img.shields.io/badge/Codex%20%7C%20Claude%20Code-ready-0EA5E9" alt="Codex and Claude Code"></a>
  14. <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>
  15. </p>
  16. <p>
  17. <a href="#-快速开始"><b>快速开始</b></a> ·
  18. <a href="#-为什么是-mathmodel-skill"><b>核心亮点</b></a> ·
  19. <a href="#-30-秒看懂"><b>30 秒看懂</b></a> ·
  20. <a href="#-工作流全景"><b>工作流</b></a> ·
  21. <a href="#-竞赛支持"><b>竞赛支持</b></a> ·
  22. <a href="#-常见问题"><b>常见问题</b></a> ·
  23. <a href="#-star-history"><b>Star History</b></a>
  24. </p>
  25. </div>
  26. ---
  27. 数学建模比赛很少因为“缺少一个更聪明的回答”而失败。更常见的是:**模型换了,摘要没改;第二问重算了,第三问还在引用旧结果;关键假设只活在聊天记录里;直到提交前,才发现匿名、页数或 AI 披露不合规。**
  28. mathmodel-skill 不是一个试图一口气生成整篇论文的 Prompt,也不是替团队做决定的黑盒 Agent。它是一套**可执行的建模工作流**:把选题、拆题、模型选择、求解、稳健性分析、论文装配和终审组织成 10 个阶段,用一份共享决策日志保存整个项目的状态。团队只回答关键的编号问题,Agent 负责维护状态、调用脚本、整理产物。
  29. > [!TIP]
  30. > **一句话上手**:安装后在 Codex 里输入 `使用 $mathmodel-skill,开始 CUMCM 建模。`,或在 Claude Code 里说 `开始建模`。之后随时说 **“看进度”**,就能看到当前阶段、评分、合规门和下一步。
  31. ## ✨ 为什么是 mathmodel-skill
  32. <table>
  33. <tr>
  34. <td width="33%" valign="top">
  35. **🧭 10 阶段,一条主线**
  36. 选题 → 拆题 → 选型 → 求解 → 稳健性 → 写作 → 终审。每个阶段都有进入条件、退出条件和回退路径,Agent 在可检查的位置停下来,而不是一口气跑到底。
  37. </td>
  38. <td width="33%" valign="top">
  39. **🧠 一份状态,随时接力**
  40. `state/decision_log.json` 记录每个决定、依据、评分与回退。换队员、换对话、从 Codex 换到 Claude Code,都从同一个检查点继续,不靠聊天记忆。
  41. </td>
  42. <td width="33%" valign="top">
  43. **⚖️ 脚本裁决,不靠自评**
  44. Critic 打分之后,由 `score_artifact.py` 重新计算 verdict。任何关键维度低于门槛都会单独暴露,不会被加权均分“平均掉”。
  45. </td>
  46. </tr>
  47. <tr>
  48. <td width="33%" valign="top">
  49. **🎯 哪里错,只修哪里**
  50. Stage 5 按子问保存状态:`refine_partial` 只返工没通过的 Qi,其余结果保持不动;论文按 section patch 定向修补,不推倒重来。
  51. </td>
  52. <td width="33%" valign="top">
  53. **🛡️ 提交前 fail-closed**
  54. 占位符、缺失章节、模板 marker 错位会直接失败;当届规则、匿名、页数、AI 披露、支撑材料五道终审门不过,就不能标记 `submission_ready`。
  55. </td>
  56. <td width="33%" valign="top">
  57. **📊 一眼看进度** <sup>`v6.2 新`</sup>
  58. `status.py` 汇总 10 个阶段的 verdict、子问状态、合规门和截止倒计时,按剩余时间给出模式建议,并只给出**一条**明确的下一步。
  59. </td>
  60. </tr>
  61. </table>
  62. ### 它专门对付这些“翻车现场”
  63. | 😵 比赛中的常见情况 | ✅ mathmodel-skill 的处理方式 |
  64. | --- | --- |
  65. | 对话越来越长,早期决定难以追溯 | 所有阶段共用 `state/decision_log.json`,统一保存选择、依据、评分与回退记录 |
  66. | 总体表现尚可,但某个关键维度明显不足 | Verdict 同时检查最低分和加权均分;高严重度问题不能被平均数掩盖 |
  67. | 只有 Q2 需要返工,却牵连全部结果 | Stage 5 按 Qi 保存状态,`refine_partial` 只修改受影响的子问 |
  68. | 三类竞赛要求不同,维护成本不断增加 | 一条主流程 + competition pack、权重 overlay 和模板表达差异 |
  69. | Markdown 章节写好了,主 TeX 却没引用到 | 模板使用显式 section marker;缺失、重复或未知 marker 直接失败 |
  70. | 封面或摘要仍含占位符,却被当成正式稿 | 正式渲染 fail-closed;占位符只能用于显式 dry-run |
  71. | 临近提交才发现页数、匿名或 AI 披露问题 | Stage 0、8、9 重新打开规则入口;合规门不过不能进入 `submission_ready` |
  72. | Pandoc、TeX 或依赖问题直到最后才暴露 | `doctor.py` 一次性检查结构、竞赛包、Python、Pandoc、TeX 与可选依赖 |
  73. | 忙了一整天,说不清现在到底卡在哪 | `status.py` 只读汇总进度、阻断项与下一步,不改动任何状态 |
  74. ## 🎬 30 秒看懂
  75. **① 开口说一句** —— Agent 只询问还缺的启动信息(竞赛、题号、队伍、截止时间、题面),然后用 `init_workspace.py` 建好工作区。
  76. **② 关键决策点,只需回答数字** —— 没有原生选择 UI 的环境会退化为编号列表,语义完全一致:
  77. ```text
  78. 【Stage 3 · Q1 用哪个候选模型?】
  79. 1) 混合整数规划 (MILP) — 目标与约束线性,求解器可给出最优性证明
  80. 2) 遗传算法 — 适合非凸、高维离散搜索
  81. 3) 禁忌搜索 — 中等规模组合优化,易实现
  82. 4) 让我决定(推荐 1:Stage 2 已标记目标为线性)
  83. 回复数字即可。
  84. ```
  85. **③ 任何时候说“看进度”** —— 下面是 `status.py` 对一份示例状态的真实输出:Stage 5 中只有 Q2 没过,所以下一步只精修 Q2。
  86. <div align="center">
  87. <img src="./assets/status-demo.svg" alt="status.py 进度看板示例:CUMCM 2026 A 题进行到 Stage 5,下一步只精修 Q2" width="88%">
  88. <br><sub>示例数据,仅用于展示看板格式</sub>
  89. </div>
  90. ## 🧭 工作流全景
  91. <div align="center">
  92. <img src="./assets/workflow.svg" alt="10 阶段主流程:Stage 0 团队启动到 Stage 9 提交终审,每阶段读写 decision_log.json" width="100%">
  93. </div>
  94. <br>
  95. | Stage | 任务 | 关键产物 | 主要检查 |
  96. | ----: | --- | --- | --- |
  97. | 0 | 团队启动与资料预扫 | 竞赛、角色、时限、环境、规则基线 | 可执行性与合规入口 |
  98. | 1 | 多题比较与选题 | 选择理由、放弃项、题型判断 | 资源匹配与失败风险 |
  99. | 2 | 问题拆解 | 子问、变量、约束、依赖图 | 逻辑完整性 |
  100. | 3 | 模型选型 | 候选模型、证据、反事实与淘汰理由 | 模型与问题的匹配程度 |
  101. | 4 | Foundation | 假设、符号、术语表 | 一致性与可解释性 |
  102. | 5 | 递归求解 Q1…Qn | formulation、代码、结果、图表 | per-Qi 评分与定向回修 |
  103. | 6 | 稳健性分析 | 风险匹配的验证、稳健区间、失败边界 | 灵敏度与结论可靠性 |
  104. | 7 | 模型评价 | 优点、局限、改进、迁移条件 | 边界是否诚实、结论能否推广 |
  105. | 8 | 论文装配 | `paper_workspace/*.md`、TeX/PDF、AI 台账 | 跨阶段一致性与格式合规 |
  106. | 9 | 提交前终审 | 最终 PDF、支持材料、Panel 记录 | 合规门、证据链与视觉检查 |
  107. ### 每一轮评审如何收敛
  108. 评分工具输出的是**流程状态**,而不是奖项预测。Critic 给分之后,verdict 一律由脚本重新计算:
  109. ```mermaid
  110. stateDiagram-v2
  111. direction LR
  112. state "L1 Critic 打分" as critic
  113. state "脚本重算 verdict" as verdict
  114. state "进入下一阶段" as next
  115. state "定向修补" as patch
  116. state "团队介入" as human
  117. [*] --> critic
  118. critic --> verdict
  119. verdict --> next: pass / pass_early
  120. verdict --> next: carryover
  121. verdict --> patch: refine / refine_partial
  122. patch --> critic: 迭代 +1
  123. verdict --> human: block
  124. human --> critic: 处理后重评
  125. ```
  126. | Verdict | 触发条件 | 行为 |
  127. | --- | --- | --- |
  128. | `block` | 存在至少 1 个高严重度问题 | 暂停流程,由团队介入 |
  129. | `pass_early` | 最低分 ≥ 9 且加权均分 ≥ 9 | 首轮即可提前通过 |
  130. | `pass` | 最低分 ≥ 7 且加权均分 ≥ 8 | 进入下一阶段 |
  131. | `pass_with_review` <sub>Stage 5</sub> | 个别 Qi 需复核,但加权阈值满足 | 进入 Stage 6,L2 必读复核项 |
  132. | `refine` | 其他情况 | section patch 精修,最多 3 轮 |
  133. | `refine_partial` <sub>Stage 5</sub> | 部分 Qi 最低分 < 7,其余已通过 | 只精修这些 Qi |
  134. | `carryover` | 达到迭代上限仍需精修 | 进入下一阶段,遗留问题交给 L2 回检 |
  135. ### 三种反馈模式
  136. 同一条主流程,只调整反馈预算和评审深度:
  137. | Mode | 反馈层 | 适用场景 |
  138. | --- | --- | --- |
  139. | `fast` | L1 单轮 | 选题试跑、快速 sanity check、时间紧张时的关键阶段 |
  140. | `standard` | L1 + L2 | 默认比赛流程 |
  141. | `championship` | L1 + L2 + L3 + L4 + red-team | 终稿前的深度评审 |
  142. `status.py` 会按剩余时间给出建议(< 6h 直接进 Stage 9 终审;6–24h 关键阶段用 `fast`;其余用 `standard`),但**切换模式始终需要团队确认**。
  143. ## 🏆 竞赛支持
  144. | 竞赛包 | 语言与模板 | 当前材料 | 可信度说明 |
  145. | --- | --- | --- | --- |
  146. | **🇨🇳 CUMCM 国赛** | 中文;XeLaTeX / 原创 `ctexart` 电子论文模板 | 91 份公开论文来源,其中 59 份成功提取文本进入统计;42 项维护者反模式检查 | 材料最完整;观察分位不是官方门槛,规则以当届通知为准 |
  147. | **🌍 MCM/ICM 美赛** | English;pdfLaTeX / `article` | 16 项维护者检查;已记录 COMAP 2027 页数、字号与 AI 披露基线 | 经验层 `n=0`,不提供论文分位;提交前必须重新核对 COMAP 要求 |
  148. | **⚡ 电工杯** | 中文;XeLaTeX / `ctexart` | 12 项工程导向检查;已记录官网页序、25 页正文、支撑材料与匿名基线 | 经验层 `n=0`;当前官网未提供专门 AI 格式,仍需检查当届通知 |
  149. <details>
  150. <summary><b>截至 2026-07-22 已核对的官方规则入口</b></summary>
  151. - [CUMCM 2026 竞赛规则](https://www.mcm.edu.cn/html_cn/node/9d8e511fe7a1447b35f53a82c908e2e0.html)
  152. - [CUMCM 2026 论文格式规范](https://www.mcm.edu.cn/html_cn/node/4cd596519c9eb9fbd866398f6df0caa3.html)
  153. - [COMAP 2027 Instructions](https://www.contest.comap.com/undergraduate/contests/mcm/instructions.php)
  154. - [电工杯参赛规则](https://shumo.neepu.edu.cn/jszz/csgz.htm)
  155. - [电工杯论文规范](https://shumo.neepu.edu.cn/jszz/lwgf.htm)
  156. 这些链接构成仓库当前的规则基线,但不能替代参赛当年的官方文件。
  157. </details>
  158. ## 🚀 快速开始
  159. ### 1. 安装
  160. **Codex(macOS / Linux)**
  161. ```bash
  162. git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \
  163. ~/.agents/skills/mathmodel-skill
  164. python ~/.agents/skills/mathmodel-skill/scripts/doctor.py --competition cumcm
  165. mkdir -p my-modeling-project && cd my-modeling-project
  166. codex
  167. ```
  168. <details>
  169. <summary><b>Codex(Windows PowerShell)</b></summary>
  170. ```powershell
  171. git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git `
  172. "$HOME\.agents\skills\mathmodel-skill"
  173. python "$HOME\.agents\skills\mathmodel-skill\scripts\doctor.py" `
  174. --competition cumcm
  175. New-Item -ItemType Directory -Force my-modeling-project | Out-Null
  176. Set-Location my-modeling-project
  177. codex
  178. ```
  179. </details>
  180. <details>
  181. <summary><b>只安装到当前项目(项目级 skill)</b></summary>
  182. ```bash
  183. mkdir -p .agents/skills
  184. git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \
  185. .agents/skills/mathmodel-skill
  186. ```
  187. </details>
  188. **Claude Code**
  189. ```bash
  190. git clone https://github.com/handsomeZR-netizen/mathmodel-skill.git \
  191. ~/.claude/skills/mathmodel-skill
  192. mkdir -p my-modeling-project && cd my-modeling-project
  193. claude
  194. ```
  195. ### 2. 开口说一句
  196. | 环境 | 输入 |
  197. | --- | --- |
  198. | Codex | `使用 $mathmodel-skill,开始 CUMCM 建模。` |
  199. | Claude Code | `开始建模`,或 `使用 mathmodel-skill 开始 MCM 建模` |
  200. 首次启动时,Agent 只询问还缺的竞赛、题号、队伍能力、截止时间和题面位置,然后初始化工作区并进入 Stage 0;工作区已有状态时,则从最近的检查点继续。
  201. ### 3. 之后只需要回答问题
  202. Agent 会在需要判断的节点停下来问你;状态写入、文件组织和脚本调用都由它完成。任何时候都可以说:
  203. `看进度` · `进入 stage N` · `回退到 stage M` · `做 L2 回检` · `升级到 championship` · `切到 mcm`
  204. > [!NOTE]
  205. > 想先手动体验看板?两条命令即可(`init_workspace.py` 只创建、不覆盖已有状态):
  206. >
  207. > ```bash
  208. > python ~/.agents/skills/mathmodel-skill/scripts/init_workspace.py \
  209. > --competition cumcm --workspace . --problem 未公布 --hours-left 72
  210. > python ~/.agents/skills/mathmodel-skill/scripts/status.py --workspace .
  211. > ```
  212. <details>
  213. <summary><b>可选:完整数值环境与论文编译</b></summary>
  214. 核心工作流和 `doctor.py --skip-tools` 不依赖完整的科学计算栈。只有需要运行仓库中的建模起步代码时,才需要安装额外依赖:
  215. ```bash
  216. python -m pip install -r \
  217. ~/.agents/skills/mathmodel-skill/templates/shared/requirements.txt
  218. ```
  219. 正式进行论文转换与编译时,还需要安装 [Pandoc](https://pandoc.org/installing.html) 和 TeX Live 或 MiKTeX:CUMCM 与电工杯使用 XeLaTeX,MCM/ICM 使用 pdfLaTeX。内置简化转换器仅用于 `--no-compile` 结构预检,不应作为正式论文的编译方式。
  220. </details>
  221. ## 📦 工作区产物
  222. ```text
  223. my-modeling-project/ # 由 init_workspace.py 创建
  224. ├── state/
  225. │ └── decision_log.json # 决策、评分、回退、规则与 AI 使用台账
  226. ├── results/ # 结构化结果与可复现实验输出
  227. ├── figures/ # 最终图表
  228. ├── paper_workspace/ # 01_abstract.md … 10_appendix.md,以及按需披露片段
  229. ├── paper_output/ # TeX 中间文件与最终 PDF
  230. └── support_materials/ # 代码、数据清单与竞赛要求的披露材料
  231. ```
  232. Codex 与 Claude Code 可以在同一目录中接力。`decision_log.json` 负责保存流程状态,但不会自动同步工作区之外的文件。
  233. ## 🧰 工具箱
  234. 模型负责需要判断的工作,脚本负责可以确定的工作,团队保留最终决定权。
  235. | 工具 | 用途 | 典型调用 |
  236. | --- | --- | --- |
  237. | `scripts/init_workspace.py` <sup>新</sup> | 创建工作区与初始状态;已有状态时只报告恢复点,从不覆盖 | `python <skill>/scripts/init_workspace.py --competition mcm --problem C --hours-left 96` |
  238. | `scripts/status.py` <sup>新</sup> | 只读进度看板:阶段 verdict、per-Qi、合规门、倒计时、模式建议与下一步 | `python <skill>/scripts/status.py --workspace . --markdown` |
  239. | `scripts/doctor.py` | 检查 skill 结构、竞赛包、环境与工作区 | `python <skill>/scripts/doctor.py --competition mcm` |
  240. | `scripts/score_artifact.py` | 校验 critic JSON、重算加权分数与 verdict、聚合 per-Qi | `python <skill>/scripts/score_artifact.py --stage 5 --critique ...` |
  241. | `scripts/extract_diff.py` | 生成并应用 section-level patch | `python <skill>/scripts/extract_diff.py --apply ...` |
  242. | `scripts/render_paper.py` | 将 Markdown 工作区装配为三类竞赛的 TeX/PDF | `python <skill>/scripts/render_paper.py --competition cumcm --workspace paper_workspace` |
  243. | `scripts/render_ai_usage.py` | 根据台账生成 CUMCM/MCM AI 使用披露材料 | `python <skill>/scripts/render_ai_usage.py --competition mcm ...` |
  244. | `scripts/ingest_papers.py` | 供维护者离线更新经验统计 | 见 [`scripts/README.md`](./scripts/README.md) |
  245. 完整 CLI 参数与依赖边界见 [`scripts/README.md`](./scripts/README.md)。
  246. ## 🧠 设计原则
  247. ```mermaid
  248. flowchart LR
  249. A["题目与团队约束"] --> B["10 阶段主流程"]
  250. C["竞赛特化包"] --> B
  251. D[("decision_log.json")] <--> B
  252. B --> E["模型 · 结果 · 图表 · 论文"]
  253. E --> F["L1 / L2 / L3 / L4 反馈"]
  254. F -->|"定向修补"| B
  255. D -.-> G["status.py 进度看板"]
  256. ```
  257. 系统由三部分组成:**主流程**定义阶段顺序、进入/退出条件和回退路径;**共享决策日志**是项目的连续记忆;**确定性工具**承担评分重算、模板装配、环境诊断、差分应用、AI 披露生成和合规检查。
  258. <details>
  259. <summary><b>工作流优先于超长 Prompt</b></summary>
  260. 更长的 Prompt 可以增加背景信息,却不能天然维护状态、依赖与回退路径。这里仍然使用模型完成各阶段任务,但“项目现在在哪里”“上一阶段决定了什么”“什么条件下可以继续”由工作流显式维护。上下文可以变化,项目结构不需要随之消失。
  261. </details>
  262. <details>
  263. <summary><b>检索提供证据,不管理流程</b></summary>
  264. RAG 很适合寻找竞赛规则、领域论文、真实数据和方法依据,但它并不负责决定下一阶段,也不会自动判断新结果是否推翻旧假设。因此,仓库内材料采用版本可控、按阶段加载的竞赛包;外部检索负责提供证据,主流程负责组织行动。
  265. </details>
  266. <details>
  267. <summary><b>Multi-Agent 只用于适合并行比较的环节</b></summary>
  268. 多个 Agent 在选题比较、模型攻击和终稿评审中很有价值,但如果每一步都依赖多方协商,协调成本和符号漂移会迅速增加。主流程始终围绕一份共享日志推进;终稿 Panel 可以并行执行,也可以在单 Agent 环境中顺序降级。
  269. </details>
  270. <details>
  271. <summary><b>自动化停在可以检查的位置</b></summary>
  272. `fast` 和 `standard` 模式都可以由一个 Agent 完成,但每个阶段仍然留下明确产物,关键选择仍然需要确认,评分仍然由脚本重算,问题仍然可以按 section 或 Qi 局部修补。团队可以随时查看进度、接管项目、切换模型,或回到某个具体决定,而不必从头重做。
  273. </details>
  274. <details>
  275. <summary><b>更多小而重要的设计</b></summary>
  276. - **只加载当前阶段需要的材料**:根目录 `SKILL.md` 只承担调度职责,阶段细则、rubric、竞赛规则和模板按需加载。
  277. - **一条流程服务三类竞赛**:差异被限制在 `competitions/<comp>/`、题型与阶段权重、LaTeX 模板、提交与披露规则。
  278. - **最低分不会被均分覆盖**:题型权重被限制在 `[0.7, 1.5]`,避免局部偏好过度放大。
  279. - **经验数据只作为参照**:CUMCM 分位描述的是公开样本中的观察位置,不是官方评分线;MCM/ICM 与电工杯的经验层明确记录为 `n=0`。
  280. - **规则记录日期,但不假装永久有效**:`current_rules.md` 保存最近核对日期和官方入口,Stage 0、8、9 仍要求重新查看当届通知。
  281. - **AI 使用从过程开始记录**:台账记录工具、版本、阶段、用途、采用内容和人工复核;`null` 永远不等于“未使用”。
  282. - **看板只读**:`status.py` 从不修改状态;模式建议只是建议,切换需要团队确认并写入 events。
  283. - **能自动验证的内容不依赖“记得检查”**:YAML/JSON、竞赛包、反模式计数、评分边界、模板 marker、渲染 dry-run、工作区初始化与看板均有自动测试覆盖。
  284. </details>
  285. ## ❓ 常见问题
  286. <details>
  287. <summary><b>它会替我们写完整篇论文吗?</b></summary>
  288. 不会一口气生成。它按阶段推进、在关键节点让团队决策,并把论文拆成可单独修补的章节。公式、代码、数据、事实、引用和最终署名仍由团队负责。
  289. </details>
  290. <details>
  291. <summary><b>能保证获奖,或者预测我们能拿几等奖吗?</b></summary>
  292. 不能。`pass`、`refine` 等 verdict 描述的是流程状态,不是奖项预测;CUMCM 经验分位只是公开样本中的观察位置,不是官方评分线。
  293. </details>
  294. <details>
  295. <summary><b>队友用 Codex,我用 Claude Code,能一起用吗?</b></summary>
  296. 可以接力。两个环境读写同一份 `state/decision_log.json` 和相同的 schema。共享来自项目目录而不是云同步,所以请用 git 或网盘同步整个工作区。
  297. </details>
  298. <details>
  299. <summary><b>没装 LaTeX / Pandoc 能用吗?</b></summary>
  300. 可以。核心工作流、`init_workspace.py`、`status.py` 和 `doctor.py --skip-tools` 都不依赖它们;只有正式编译 PDF 时才需要。`render_paper.py --no-compile` 可以先做结构预检。
  301. </details>
  302. <details>
  303. <summary><b>比赛规则每年都在变,怎么办?</b></summary>
  304. `competitions/<comp>/current_rules.md` 记录核对日期和官方入口,Stage 0、8、9 会要求重新核对当届通知。仓库保存的只是基线,**官方文件永远优先**。
  305. </details>
  306. <details>
  307. <summary><b>比赛中用了 AI,要怎么披露?</b></summary>
  308. 从第一天开始记录 AI 使用台账。`render_ai_usage.py` 会为 CUMCM 生成支撑材料 PDF 或正文声明,为 MCM 生成接入主模板的 AI 使用报告。台账为 `null` 时会被视为“尚未核对”,而不是“未使用”。
  309. </details>
  310. <details>
  311. <summary><b>离截止只剩几个小时了,还有用吗?</b></summary>
  312. 有。说“看进度”,`status.py` 会按剩余时间给出建议:不足 6 小时建议直接进入 Stage 9 的 championship 终审,优先保证合规门。是否切换由团队决定。
  313. </details>
  314. <details>
  315. <summary><b>普通数据分析、课程论文能用它吗?</b></summary>
  316. 不建议。触发边界刻意限定在 CUMCM、MCM/ICM 和电工杯的竞赛工作;通用的模型选择或非竞赛写作不会、也不应该触发它。
  317. </details>
  318. ## 📜 版本演进
  319. ```mermaid
  320. timeline
  321. title mathmodel-skill 演进
  322. V3 : CUMCM 单赛工作流 : 10 阶段 + rubric 自评
  323. v4 : 三竞赛通用化 : per-Qi 加权与题型权重
  324. v5 : Codex 平行兼容 : 全程问答式 Friendly Mode
  325. v6.0 : Codex 原生 Skill 与 Plugin 打包
  326. v6.1 : doctor 预检 : fail-closed 模板 : AI 使用披露
  327. v6.2 : 工作区初始化 : 进度看板与下一步
  328. ```
  329. ### v6.2 · 看得见的进度
  330. - 新增 `scripts/init_workspace.py`:按 Stage 0 已知答案一次性创建 `state/`、`results/`、`figures/`、`paper_workspace/`、`paper_output/`、`support_materials/` 与初始状态。它只创建、不覆盖:已有状态时只报告恢复点,竞赛不一致或文件损坏时明确失败。
  331. - 新增 `scripts/status.py`:只读汇总 10 个阶段的最新 verdict 与分数、Stage 5 子问状态、规则基线 / AI 台账 / 五道终审门、截止倒计时和模式建议,并给出唯一的下一步;支持终端、Markdown 与 JSON 输出。
  332. - “开始建模”和“看进度”改为调用上述脚本,Codex 与 Claude Code 得到同样的结果;`doctor.py` 与 CI 同步覆盖新脚本。
  333. - README 全面改版:动态横幅、10 阶段流程图、看板示例、verdict 状态机、FAQ 与自动更新的 Star History。
  334. <details>
  335. <summary><b>v6.1 · 可靠性与合规</b></summary>
  336. - 新增 `doctor.py`,统一检查包结构、竞赛包、反模式计数、模板 marker 和工具链状态。
  337. - 三类竞赛生成的 section 会自动接入 `main.tex`;缺失章节、空章节、未知 marker 或重复 marker 都会明确失败,正式编译不会静默降级。
  338. - CUMCM 改用仓库原创、MIT 授权的 `ctexart` 电子论文模板;模板不包含身份字段,并对摘要页、正文页数和最终提交元数据执行 fail-closed 检查。
  339. - 评分器改为由脚本重新计算 verdict,同时校验 stage、iteration、最低分、均分和题型权重。
  340. - `extract_diff.py --apply` 不再要求与应用差分无关的 critique 输入。
  341. - 新增 AI 使用台账与披露生成器:CUMCM 根据“已使用 / 明确未使用”生成支撑材料 PDF 或正文声明;MCM 报告自动进入主模板。
  342. - 补充电工杯官网规则基线,将封面、摘要起始页码、无目录、正文与附录顺序纳入模板和终审门。
  343. - 修复分类交叉验证中的标准化泄漏、优化示例中的不可行贪心基线、熵权法常数列、GM(1,1) 极限和 MAPE 零值边界。
  344. - 将 CUMCM 样本口径校准为“91 份来源、59 份可提取文本”;Stage 9 按当前竞赛动态加载反模式清单。
  345. </details>
  346. ## 🔒 边界与可信度
  347. > [!IMPORTANT]
  348. > mathmodel-skill 是协作与质量控制工具,**不是自动获奖系统**。它不会消除建模本身的不确定性,也不能替代团队对公式、代码、数据、事实、引用和最终署名的责任。
  349. - CUMCM 统计来自公开样本中成功提取文本的 59 份论文,可能受到年份、题型、来源和 PDF 可提取性的影响。
  350. - `winning_patterns.md`、经验分位和反模式清单属于维护者总结,不是官方 rubric。
  351. - MCM/ICM 与电工杯的经验统计目前均为 `n=0`,相关写作模式只能作为启发,不能解释为实测获奖规律。
  352. - 竞赛规则会变化。仓库保存的是最近一次核对的基线,正式提交前必须以当届官方通知和题目要求为准。
  353. - AI 生成的公式、代码、事实和引用必须由团队复核。台账和披露生成器帮助完整记录,但不代替合规判断。
  354. ## 🧪 开发与验证
  355. ```bash
  356. python -m compileall -q scripts templates/shared/code_starter
  357. python -m unittest discover -s tests -p 'test_*.py' -v
  358. python scripts/doctor.py --competition cumcm --skip-tools
  359. python scripts/doctor.py --competition mcm --skip-tools
  360. python scripts/doctor.py --competition diangong --skip-tools
  361. git diff --check
  362. ```
  363. 当工作流、模板或竞赛包发生变化时,请同步更新测试、版本号和规则核对日期。
  364. <details>
  365. <summary><b>仓库结构</b></summary>
  366. ```text
  367. SKILL.md # 工作流主入口与调度协议
  368. agents/openai.yaml # Codex UI 元数据
  369. .codex-plugin/plugin.json # Codex Plugin manifest
  370. skills/mathmodel-skill/SKILL.md # Plugin 发现 shim
  371. AGENTS.md # 仓库维护约定
  372. assets/ # README 使用的原创 SVG 图示
  373. competitions/
  374. cumcm/ # 规则、59 份样本统计、写作启发、评分覆盖与模板骨架
  375. mcm/ # COMAP 规则基线;经验统计 n=0
  376. diangong/ # 官网规则基线;经验统计 n=0
  377. references/
  378. stage_00_* ... stage_09_* # 按阶段加载的执行细则
  379. feedback_layer1_* ... layer4_* # 阶段评分、回检、Panel 与校准
  380. model_catalog.md # 模型候选目录
  381. templates/
  382. latex/{cumcm,mcm,diangong}/ # 三类竞赛 LaTeX 模板
  383. shared/ # 状态、AI 台账、表格与 Python 起步代码
  384. config/dim_weights.json # 竞赛 × 题型 × 阶段的评分权重
  385. scripts/ # 初始化、看板、环境检查、评分、差分、装配、披露与维护工具
  386. tests/ # 回归测试与 fixture
  387. ```
  388. </details>
  389. ## ⭐ Star History
  390. <div align="center">
  391. <a href="https://star-history.com/#handsomezr-netizen/mathmodel-skill&Date">
  392. <picture>
  393. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=handsomezr-netizen/mathmodel-skill&type=Date&theme=dark">
  394. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=handsomezr-netizen/mathmodel-skill&type=Date">
  395. <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=handsomezr-netizen/mathmodel-skill&type=Date" width="720">
  396. </picture>
  397. </a>
  398. <br>
  399. <sub>图表由 <a href="https://star-history.com">star-history.com</a> 实时生成,随 Star 数自动更新,并跟随 GitHub 的深色 / 浅色主题。</sub>
  400. </div>
  401. ## 🤝 参与贡献
  402. 参与贡献前请先阅读 [`AGENTS.md`](./AGENTS.md)。Bug、规则更新与改进建议都可以通过 [Issue](https://github.com/handsomeZR-netizen/mathmodel-skill/issues) 提交;如果你核对过新一届的官方规则,也非常欢迎直接提 PR 更新 `competitions/<comp>/current_rules.md`。
  403. ## 📄 License
  404. 仓库原创代码、文档、README 图示以及三类竞赛装配模板采用 [MIT License](./LICENSE)。运行时依赖和外部资料链接仍遵循各自的许可条款,详细边界见 [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md)。
  405. ---
  406. <div align="center">
  407. **mathmodel-skill 不替团队完成思考。**<br>
  408. 它让每一次判断都留下依据,让每一次修改都知道影响范围,也让一场漫长的建模协作最终能够被完整地交付。
  409. <sub>如果它对你的队伍有帮助,欢迎点一个 ⭐ Star,让更多参赛同学看到它。</sub>
  410. <a href="#top">⬆ 回到顶部</a>
  411. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.