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` 中的“论文写作”“图表与可视化”和“非数据图工具选择”小节。该文件只作为规范知识库，论文结构仍按比赛模板和当前赛题内容决定。

## 模板族

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

```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/*`。不得编造、估算或使用不同的四舍五入方式。


## 工作流

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

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

使用 AskUserQuestion 工具向用户询问："撰写论文使用哪种排版引擎？"

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

询问前先读取 `plan.md` 的"用户偏好 → 排版引擎"字段作为预选项：
- 若 plan.md 已记录引擎选择，向用户确认："检测到之前选择的引擎是 <LaTeX/Typst>，是否沿用？"
- 若 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"
```

- **文件存在（OK）**：将 `templates/zh/<竞赛>-latex/` 整目录复制到 `paper/`。
- **文件不存在（MISSING）**：说明 skill 未完整安装或在沙箱中，此时依照本 SKILL.md 步骤 3 列出的对应节文件结构，从零重建最小可编译 LaTeX 框架，并在 `paper/` 内注明"重建自 default-latex 结构"。


### 步骤 3：构建图表规划

在写正文各节之前，根据 `figures/*.pdf`、`reports/RESULTS_REPORT.md`，以及 `reports/DRAWIO_REPORT.md`（如果存在）构建图表规划：

```text
图表规划
fig_roadmap.pdf -> 引言/问题重述
fig_flow_q1.pdf -> 问题一模型构建

From hongdotien10-hash/mathmodel-toolkit, MIT.

More from hongdotien10-hash/mathmodel-toolkit