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 仅在全自主模式下执行。**
> 在辅助模式下，`1start-mathmodel` 不会调用本 skill。如果用户在辅助模式下要求"生成论文模板"，只复制空模板框架到 `paper/`，不写入任何正文内容。

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

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

**⚠️ 编译注意事项**：生成任何 `.typ` 文件前，先读 `../_references/typst_compile_notes.md`（Typst 编译踩坑实录：表格必须用 `#table` 而非 Markdown `|`、数学模式多字母变量加引号、`//` 是注释符、`#enum` 内容块写法、`table.header` 子元素、图片路径不越界等）；写完必须 `typst compile` 验证通过再进入下一环节。

## 数学建模规范参考

如需领域判断，读取 `../_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/*`。不得编造、估算或使用不同的四舍五入方式。


## 排版硬规则（强制，违反即验收 FAIL）

1. **不设目录页**。竞赛论文不写目录，也不写"表格与插图清单""List of Figures"等前置清单页。本 skill 的 34 套模板（Typst + LaTeX 双引擎）已全部移除目录页——即 Typst 的 `outline()` 与 LaTeX 的 `\tableofcontents` / `\listoffigures` / `\listoftables`——**禁止再把目录加回来**。论文从摘要页直接进入正文。
2. **表上图下**。**表题（表 x  标题）位于表格上方**，**图题（图 x  标题）位于图形下方**：
   - **Typst**：各模板导言区已内置
     ```typ
     #show figure.where(kind: table): set figure.caption(position: top)
     ```
     图题沿用 Typst 默认的"下方"，无需额外设置。表格必须写成 `#figure(table(...), caption: [...])`（Typst 会自动识别 `kind: table`），**不要用裸 `#table(...)` 丢掉表题**。
   - **LaTeX**：`\caption{}` 必须写在 `\begin{tabular}` / `\begin{longtable}` **之前**；图环境中 `\caption{}` 必须写在 `\includegraphics` **之后**。
3. 表题/图题的语言随论文语言（中文论文用"表 x / 图 x"，英文论文用 Table x / Figure x），全文编号连续，并与正文引用一致。
4. **自检**：写完或改完论文后运行版面门禁，出现 FAIL 必须修好再继续：
   ```bash
   python3 "<6verity skill 目录>/scripts/layout_check.py" --paper-dir paper --main paper/main.typ --pdf paper/main.pdf
   ```
## 工作流

### 步骤 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"
```
```powershell
# Windows (PowerShell)
if (Test-Path "$env:SKILL_DIR/templates/zh/<竞赛>/main.typ") { "OK" } else { "MISSING" }
```

From QianXiao233/mathmodel-assistant, MIT.

More from QianXiao233/mathmodel-assistant