5writing

Files (200)

• SKILL.md
• main.tex · templates/en/apmcm-latex/
• references.tex · templates/en/apmcm-latex/
• 1_introduction.tex · templates/en/apmcm-latex/sections/
• 2_assumptions.tex · templates/en/apmcm-latex/sections/
• 3_model_design.tex · templates/en/apmcm-latex/sections/
• 4_solution.tex · templates/en/apmcm-latex/sections/
• 5_sensitivity.tex · templates/en/apmcm-latex/sections/
• 6_strengths_weaknesses.tex · templates/en/apmcm-latex/sections/
• 7_conclusions.tex · templates/en/apmcm-latex/sections/
• A_code.tex · templates/en/apmcm-latex/sections/
• main.typ · templates/en/apmcm/
• references.typ · templates/en/apmcm/
• 1_introduction.typ · templates/en/apmcm/sections/
• 2_assumptions.typ · templates/en/apmcm/sections/
• 3_model_design.typ · templates/en/apmcm/sections/
• 4_solution.typ · templates/en/apmcm/sections/
• 5_sensitivity.typ · templates/en/apmcm/sections/
• 6_strengths_weaknesses.typ · templates/en/apmcm/sections/
• 7_conclusions.typ · templates/en/apmcm/sections/
• A_code.typ · templates/en/apmcm/sections/
• main.tex · templates/en/default-latex/
• references.tex · templates/en/default-latex/
• 1_introduction.tex · templates/en/default-latex/sections/
• 2_assumptions.tex · templates/en/default-latex/sections/
• 3_notations.tex · templates/en/default-latex/sections/
• 4_model.tex · templates/en/default-latex/sections/
• 5_results.tex · templates/en/default-latex/sections/
• 6_sensitivity.tex · templates/en/default-latex/sections/
• 7_evaluation.tex · templates/en/default-latex/sections/
• 8_conclusions.tex · templates/en/default-latex/sections/
• A_code.tex · templates/en/default-latex/sections/
• main.typ · templates/en/default/
• references.typ · templates/en/default/
• 1_introduction.typ · templates/en/default/sections/
• 2_assumptions.typ · templates/en/default/sections/
• 3_notations.typ · templates/en/default/sections/
• 4_model.typ · templates/en/default/sections/
• 5_results.typ · templates/en/default/sections/
• 6_sensitivity.typ · templates/en/default/sections/
• 7_evaluation.typ · templates/en/default/sections/
• 8_conclusions.typ · templates/en/default/sections/
• A_code.typ · templates/en/default/sections/
• main.tex · templates/en/mcm-latex/
• references.tex · templates/en/mcm-latex/
• 1_introduction.tex · templates/en/mcm-latex/sections/
• 2_assumptions.tex · templates/en/mcm-latex/sections/
• 3_model_design.tex · templates/en/mcm-latex/sections/
• 4_solution.tex · templates/en/mcm-latex/sections/
• 5_sensitivity.tex · templates/en/mcm-latex/sections/
• 6_strengths_weaknesses.tex · templates/en/mcm-latex/sections/
• 7_conclusions.tex · templates/en/mcm-latex/sections/
• A_code.tex · templates/en/mcm-latex/sections/
• main.typ · templates/en/mcm/
• references.typ · templates/en/mcm/
• 1_introduction.typ · templates/en/mcm/sections/
• 2_assumptions.typ · templates/en/mcm/sections/
• 3_model_design.typ · templates/en/mcm/sections/
• 4_solution.typ · templates/en/mcm/sections/
• 5_sensitivity.typ · templates/en/mcm/sections/
• …and 140 more

SKILL.md (first lines)

# 竞赛论文撰写（Typst / LaTeX）

本 skill 承接 `3coding-visual` 和 `4drawio`。前序阶段只提供真实数据、图表 PDF 和记录文件；本阶段负责选择比赛模板和排版引擎、组织论文结构，并决定每张图表放入哪个章节。

**Typst 引擎**下可调用 typst-author skill 学习 typst 写法；**LaTeX 引擎**参考本文件末尾的"LaTeX 写作要点"小节。

## 数学建模规范参考

如需领域判断，读取 `../_references/math_modeling_norms.md` 中的“论文写作”“图表与可视化”和“非数据图工具选择”小节。CUMCM 2026 模式还必须读取 `../_references/CUMCM_2026_RULES.md`；比赛专项规则优先于通用经验和历史模板。

## 模板族

本技能内捆绑的模板位于：

```text
templates/zh/<竞赛>/main.typ         # Typst 模板
templates/zh/<竞赛>-latex/main.tex   # LaTeX 模板
templates/en/<竞赛>/main.typ         # Typst 模板
templates/en/<竞赛>-latex/main.tex   # LaTeX 模板
```

**LaTeX 模板覆盖范围**：所有中文模板和英文模板均已提供 LaTeX 版本（`-latex` 后缀），使用 xelatex 编译。

支持的中文模板（Typst + LaTeX 双版本）：

```text
apmcm, changsanjiao, cumcm, default, diangongbei, dongsansheng,
huashubei, huaweibei, huazhongbei, mathorcup, mcm, shuweibei, stats, wuyibei
```

华为杯、华中杯、五一杯统一使用 `huaweibei`、`huazhongbei`、`wuyibei` 作为模板。

支持的英文模板（Typst + LaTeX 双版本）：

```text
apmcm, default, mcm
```

论文中的所有数值图表结论必须来自 `reports/RESULTS_REPORT.md` 或 `figures/*`。不得编造、估算或使用不同的四舍五入方式。

## CUMCM 2026 硬约束

选择 `zh/cumcm` 或 `zh/cumcm-latex` 时：

- 电子版第 1 页是含标题、摘要和关键词的摘要专用页；该页页码为 1，之后用阿拉伯数字在页脚中部连续编号。
- 摘要原则上不超过 1 页，无需英文摘要。最后撰写摘要，压缩背景和过程描述，覆盖每问的方法、关键数值与总体结论，关键词通常 3–5 个。
- 正文从摘要下一页开始，不生成目录。源文件不得含 `\tableofcontents`、`\tocpage`、`#outline` 或 `#toc-page`。
- A4，四边距至少 2.5 cm；正文不超过 30 页，附录页数不限；论文电子文件不超过 20 MB。
- 摘要、正文和附录不得出现姓名、学校、赛区或其他身份信息。
- 参考文献之前必须设置“AI工具使用声明”，且只能据实使用官方规定的两种声明之一；不得把声明放在参考文献之后。
- 附录先列支撑材料文件列表，再给出建模使用的全部完整、可运行源程序代码和必要交互命令；若确实没有程序或支撑材料，使用官方要求的明确说明。

准备 CUMCM 模板后立即扫描并移除任何目录实现。不要只隐藏目录页或依赖用户手动关闭。


## 工作流

### 步骤 0：确定排版引擎

**撰写论文前必须确定排版引擎。** 引擎决定后续所有步骤（模板路径、章节文件扩展名、图片插入语法、编译命令），选错会导致整篇论文格式错误。

若 `plan.md` 和用户上下文都无法确定，再询问“撰写论文使用哪种排版引擎？”

- 选项 1：LaTeX（xelatex 编译，数学建模竞赛主流，模板已全部就绪）— 推荐选项放第一位
- 选项 2：Typst（typst 编译，调用 typst-author skill 辅助写作）

先读取 `plan.md` 的“用户偏好 → 排版引擎”字段：
- 若 `plan.md` 已记录且用户没有提出变更，直接沿用，不重复确认。
- 若 `plan.md` 不存在或未记录，再询问用户选择。
- 若用户未明确指定或跳过，**默认使用 LaTeX**。

根据确定的引擎选择对应模板族：

- **Typst 引擎**：使用 `templates/<lang>/<竞赛>/main.typ`，调用 typst-author skill。编译命令 `typst compile main.typ`。
- **LaTeX 引擎**：使用 `templates/<lang>/<竞赛>-latex/main.tex`，xelatex 编译（中文和英文均需跑两遍解决交叉引用）。编译命令 `xelatex -interaction=nonstopmode main.tex`（执行两次）。

**后续步骤中的所有代码示例、文件扩展名、图片插入语法都必须按所选引擎选择对应版本，不要混用。**

### 步骤 1：选择语言和模板


除非用户明确要求中文，否则 MCM/ICM/COMAP 一律使用英文。所有中文竞赛名称使用中文。

模板键示例（Typst 引擎）：

```text
长三角 -> zh/changsanjiao
APMCM 英文版 -> en/apmcm
全国赛/国赛/CUMCM -> zh/cumcm
统计建模 -> zh/stats
MCM/ICM/COMAP -> en/mcm
```

模板键示例（LaTeX 引擎）：

```text
全国赛/国赛/CUMCM -> zh/cumcm-latex
MCM/ICM/COMAP -> en/mcm-latex
```

### 步骤 2：准备模板

用以下命令检查捆绑模板是否可访问（`SKILL_DIR` 为本 skill 所在目录）：

**Typst 模板**：

```bash
ls "$SKILL_DIR/templates/zh/<竞赛>/main.typ" 2>/dev/null && echo "OK" || echo "MISSING"
```

- **文件存在（OK）**：直接将 `templates/zh/<竞赛>/` 整目录复制到 `paper/`。这些模板是自包含入口文件，不依赖额外共享样式文件。
- **文件不存在（MISSING）**：说明 skill 未完整安装或在沙箱中，此时依照本 SKILL.md 步骤 3 列出的对应节文件结构，从零重建最小可编译 Typst 框架，并在 `paper/` 内注明"重建自 default 结构"。

存在匹配模板时，绝不从零开始写论文。

**LaTeX 模板**：

```bash
ls "$SKILL_DIR/templates/zh/<竞赛>-latex/main.tex" 2>/dev/null && echo "OK" || echo "MISSING"
```

From miaodemimi/mathmodel-skills, MIT.

More from miaodemimi/mathmodel-skills