comp-paper-zh git:20261025.6e5886cA

Immutable. This exact content never changes and is served at /api/v1/blob/5dc848592a8f526f.

---

name: comp-paper-zh

description: "数学建模竞赛/统计建模中文论文撰写。按竞赛规范结构生成完整 LaTeX 论文。Use when user says \"写竞赛论文\", \"competition paper\", \"建模论文\"."

argument-hint: [competition-type]

allowed-tools: Bash(*), Read, Write, Edit, Grep, Glob, Agent, WebSearch, WebFetch

---

# Competition Paper Writing (Chinese)

使用当前执行会话完成本步；路径按步骤合同，运行清单和证据由程序生成，模型负责实质成果。

Write a competition paper based on modeling results: **$ARGUMENTS**

## ⚡ 快速模式检测（开头先跑）

```bash

FAST_MODE=0

grep -q 'MH_FAST_MODE=1' AGENTS.md 2>/dev/null && FAST_MODE=1

echo "FAST_MODE=$FAST_MODE"

```

**若 `FAST_MODE=1`（速度优先）：** 仍必须产出完整论文（各章齐全、子问题全覆盖、图表按 manifest 嵌入、正文页数不超过下发上限、引用真实数据不编造、通过产出验证），但**跳过**：图文数值一致性逐句核对、AUDIT_OK 溯源反查、发现小瑕疵后的反复润色重写。一次写成、结构与内容齐全即可。**若 `FAST_MODE=0`（默认）：** 后文所有一致性检查照常执行。

## Constants（全部逐字转录自下发的 `contest_profile`，禁止转换与猜测）

执行会话上下文带有 `contest_profile` JSON（引擎按 `comp_rules.json` 下发；`contest_profile: null` = 本工作流无赛事身份）。把下列字段**逐字**转录进 shell 变量后只消费，不自己加前缀、转换名字、或从 AGENTS.md / 文件名 / 自由文本 / shell 默认值猜：

> 注入通道已落地（B-CLOSE-01）：引擎 `workflow_runner` 在步骤启动时把 bound 快照的赛事 ID/页限/范围/性质/届次写入 `workspace/.engine/contest_env` 并注入实际命令环境。下述模型侧逐字转录保留作一致性冗余；两边不一致时以引擎注入值为准并上报待核实。

- **CONTEST_ID** ← `contest_profile.contest_id` — 档案规范 `comp_*` 键（如 `comp_cumcm`、`comp_huawei`）。仅在 `contest_profile.status == "bound"` 时转录；`pending_binding` 或缺失 ⇒ 无有效赛事身份——停下报待核实，不是猜测，无默认，不回退国赛。

- **PAGE_CAP** ← `contest_profile.gate_page_cap` — 本任务 operative 页数门禁口径。只准不超，**没有页数下限、没有默认值**；具体数值以档案下发为准，本技能不写死。缺席 ⇒ 该赛事无 operative 页数合同（或历史裁决不继承）：页数上限未知 → 报待核实。

- **PAGE_SCOPE** ← `contest_profile.gate_page_scope` — `body`（只计正文，附录/参考文献另计）或 `total`（整本 PDF 计）。两个计数分开统计，不混用。

- **PAGE_CAP_STATUS** ← `contest_profile.page_cap_status` — `official_verified` / `task_override` / `unverified`。`unverified`（来源未核验）**不产生默认硬页限**，也不得当作已证官方规则——未知只阻塞对应合规结论（既不放行也不编出限制）。仅 `official_verified` 或单独标识的显式任务授权（`task_override`/显式任务口径）才按硬上限执行；禁止把未知官方规则包装成任务覆盖。

- **EDITION** ← `contest_profile.edition` — 可缺席；缺席经 `missing_fields` 上报，不反向推断。

- **CUSTOM_REQUIREMENTS**

## Inputs

1. PROBLEM_ANALYSIS.md, MODELING_REPORT.md, RESULTS.md

2. figures/, code/

## Load shared rules（按需读，禁止整篇下发）

`writing_rules.md` 是共享写作规则的唯一真源（`skills/_utils/writing_rules.md`，与 `skills/shared-scripts/writing_rules.md` 同源），**不在这里复制正文**。整篇 65KB 一次 cat 会把注意力预算从论证上挤走：先取 tag 目录，再只读本章实际需要的 1-2 节。

```bash
RULES=skills/_utils/writing_rules.md
[ -f "$RULES" ] || RULES=academic-toolkit/skills/_utils/writing_rules.md
[ -f "$RULES" ] || RULES=../../skills/_utils/writing_rules.md
awk '/^<[a-z_]+>$/ {print NR": "$0}' "$RULES"   # tag 目录；行号随改版漂移，以实跑输出为准
```

| tag | 何时读 |
|---|---|
| `<figure_text_interleaving>` | 写含图表的章节（图前后文字、图注长度、"图表是论据"） |
| `<figure_embedding>` | 嵌图 / TikZ / 多面板 / 防遮挡 |
| `<latex_constraints>` | 本步第一次写公式、表格、浮动体 |
| `<page_filling>` | 页数明显偏少、需要补版面时 |
| `<abstract_requirements>` | Step 5.6 写摘要（Step 2 只落占位，不读正文规格） |
| `<resume_strategy>` | 断点续写 |
| `<chapter_context_card>` | 每章收尾的要点卡、写下一章前 |
| `<de_ai_polish>` | Step 5.5 去 AI 味 |
| `<references_workflow>` | Step 5 参考文献 |
| `<output_conventions>` | 产出命名与落盘 |

**只取需要的 tag**（例：本章要嵌图）：

```bash
for t in figure_text_interleaving figure_embedding; do
  awk -v s="<$t>" -v e="</$t>" '$0==s{f=1} $0==e{f=0} f' "$RULES"
done
```

例外：Step 5.5 的 `<de_ai_polish>` 一节全读（那节本身就是终稿改写清单）；其余未命中本章任务的 tag 不读。

## 赛事结构 → `skills/comp-paper-zh/references/format-playbook.md` §1

只有两族结构，按 `CONTEST_ID` 读对应那一段（不要两段都读）：

| 赛事族 | 结构类型 | 读法（playbook §1） |
|---|---|---|
| 数模族：`comp_cumcm` / `comp_huawei` / `comp_mathorcup` / `comp_huazhong` / `comp_wuyi` / `comp_apmcm_zh` / `comp_csf` / 其余 `comp_*` | 固定骨架：摘要 → 问题重述 → 模型假设 → 符号说明 → 各子问题章 → 灵敏度与检验 → 模型评价与推广 → 参考文献 → 附录 | `awk '/^### 数模竞赛/{f=1} /^### 统计建模/{f=0} f' skills/comp-paper-zh/references/format-playbook.md` |
| `comp_stats` | 内容驱动骨架：表格清单 → 插图清单 → 中英文摘要 → 绪论 → 2-4 个内容章 → 结论与建议 → 参考文献 → 致谢 → 附录 | `awk '/^### 统计建模/{f=1} f' skills/comp-paper-zh/references/format-playbook.md` |

**硬门禁（不读 playbook 也必须守）：** ① 章序与文件名必须和模板 `\input{sections/...}` 一致；② 模型假设在符号说明之前；③ 每个子问题独立成章、独立给结果；④ `comp_stats` 固定保留表格清单/插图清单/中英文摘要/绪论/结论/参考文献/致谢。

## 赛事合规硬门禁（写稿前必读；不随结构细则进 playbook）

**⛔ 国赛提交文件命名（仅 `comp_cumcm`；其他赛事按各自官方要求，不套用）**：

1. 所有提交文件与压缩包内文件一律中文命名（`论文.pdf`、`代码说明.txt`、`支撑材料.pdf`、`AI工具使用详情.pdf`），禁止 `paper.pdf` / `code_description.txt` 类英文名
2. 程序说明只用 TXT（`代码说明.txt`），不用 Markdown 或其他格式
3. 压缩包命名 `参赛编号+队号.zip`（如 `20260001_A01.zip`）

**⛔ AI 工具使用声明（双件套：正文声明 + 独立支撑材料《AI工具使用详情.pdf》；按赛事档案裁决，不静默跳过）**：

- **`comp_cumcm`（2026 国赛强制，档案已入库规定）**：
  1. 位置：**参考文献之前**，不得放附录
  2. 内容：用途逐项**如实**取自用户确认的使用记录（`.mh/ai_disclosure.json`，存在时）——实际用了哪些环节（资料查询/语言润色/代码调试/图表制作/建模求解等）就声明哪些；隐瞒实际用途或虚构未发生用途均按当届规程可取消评奖资格
  3. 唯一生成通道：`comp-cumcm-disclosure` 技能 / `skills/_utils/build_ai_disclosure.py` 程序化生成（规范见 `skills/_utils/ai_disclosure_rules.md`，双副本同 `skills/shared-scripts/`）；禁止手写声明正文、禁止事后手工改写产物；正文声明与详情 PDF 口径必须一致（`--check-only` 反查）。**未使用 AI 时同样用脚本生成"未使用"声明并清理旧详情文件。**
  4. 骨架（程序生成的示意，勿照抄终稿）：

```latex
\section*{AI工具使用声明}
（由 build_ai_disclosure.py 依 .mh/ai_disclosure.json 如实生成）
```

- **其他赛事**：档案（`contest_profile.compliance`）无当届 AI 声明规定 ⇒ 不得静默不生成、也不得套用国赛格式冒充合规——在交付/交接说明显式上报 `AI_USE_REPORT: 待核实（comp_<x> 当届 AI 声明规定未入库，提交前对照当届官方规程核实）`。内容只依据用户确认的记录（`.mh/ai_disclosure.json`，存在时），不虚构工具、日期、用途；关闭 AI_DISCLOSURE 开关只影响是否生成声明，不免除待核实上报。

## ⛔⛔⛔ 完成铁律（最高优先级）

`params.output_format` 定：PDF（默认）= `paper/main.tex`（≥5KB）+ `paper/sections/*.tex` + `paper/references.bib`；docx = `paper/main.md`（单文件 ≥5KB，**禁止产 paper/main.tex**）。结构/存在性/完整性由 `finish` 按 `output_contract` 核验（`output_spec` / `min_size`），按 diagnostics 逐项修、不复制验证脚本；章节命名与落盘细则见 Step 7。


## 引用命令（全技能单一真源）

正文引用命令按模板定，步骤文件不再另行判断：

| 模板族（`CONTEST_ID` → `_templates/<dir>`） | 正文命令 | 依据 |
|---|---|---|
| `comp_huawei`(huawei) / `comp_stats`(stats) / `comp_mathorcup`(mathorcup) / `comp_apmcm_zh`(apmcm_zh) / `comp_huashu`(huashubei) / `comp_liaoning`(dongsansheng)：natbib + `super` | `\cite{key}`（自动上标） | `huawei/main.tex`、`mathorcup/MathorCupmodeling.cls`、`apmcm_zh/MathorCupmodeling.cls`、`huashubei/JXUSTmodeling.cls`、`stats/main.tex`、`dongsansheng/main.tex` |
| `comp_cumcm` / `comp_huazhong`（cumcmthesis，无 natbib；cls 定义 `\upcite`） | `\upcite{key}`（上标）；`\cite` 是行内 `[1]` | `cumcm/cumcmthesis.cls` |
| `comp_wuyi`（cumcmthesis + natbib `[numbers]`；cls 定义 `\upcite`） | `\upcite{key}` | `wuyi/main.tex`、`wuyi/cumcmthesis.cls` |
| `comp_shuwei`(shuweibei)：`main.tex` 内置上标 hack，无 `\upcite` | `\cite{key}`（上标） | `shuweibei/main.tex` |
| 其余（`comp_yangtze` / `comp_diangong` / `comp_csf`、`default` 族）：手写 `thebibliography` 或 `plainnat`，未配上标 | `\cite{key}`；赛事要求上标时用 `\textsuperscript{\cite{key}}` | 模板实况 |

⛔ `\upcite` 只在 cumcm / 华中杯 / wuyi / dongsansheng 的 cls 里有定义；对其他模板写 `\upcite` 会 undefined control sequence、整篇编译失败。

## Workflow（分步路由；每步只读自己的细则）

固定顺序 Step 0 → Step 7。**每步动手前整篇读该步的细则文件（`skills/comp-paper-zh/references/step_*.md`，见各步「细则」行）；只读当前步那一份，不要一次读完所有 step 文件。** 判据不全绿不得进入下一步。

### Step 0: 上游校验 + 断点续写判定

**触发**：进入本技能第一步；续写任务先判占位。**细则**：`skills/comp-paper-zh/references/step_0_preflight.md`

- 上游 `PROBLEM_ANALYSIS.md`、`MODELING_REPORT.md`、`RESULTS.md` 存在且非空壳；子问题覆盖 `MODEL_COUNT ≥ PROB_COUNT`，不足回上游补齐再写。
- `paper_claim_check.py` 的 `PCC`：0 或 2 可写；**1 = 有能力项在编码阶段就没通过 → 回 comp-code 做到 PASS 再写论文**。
- 续写口径：`paper/sections/*.tex` <500 字符或含「待补充/placeholder」= 占位章，续写；>2000 字符 = 已完成，跳过；每写完一章立即落盘。

### Step 1: Select template（只认规范 CONTEST_ID；拒绝猜测，无默认）

**触发**：Step 0 通过后，建 `paper/sections` 并落模板。**细则**：`skills/comp-paper-zh/references/step_1_template.md`（复制循环、字体/书目族随迁、落地断言、main.tex 必读、华为杯专项）

```bash
mkdir -p paper/sections

# Select template based on competition type — copy entire folder (tex + cls + fonts)

TMPL_BASE="_templates"

[ -d "$TMPL_BASE" ] || TMPL_BASE="templates"

# ⛔ 模板选择只认执行会话 contest_profile.contest_id 下发的规范 comp_* ID（逐字转录）。
# 禁止从 $ARGUMENTS / AGENTS.md / 文件名 / 子串猜赛事（自由文本与子串曾多次误命中，
# 如 "apmcm" 含 "mcm" 子串）；未指明赛事时报错停下，绝不默认国赛、绝不默认任何赛事。
if [ -z "$CONTEST_ID" ]; then
    echo "⛔ CONTEST_ID 缺失：contest_profile 未下发（contest_profile=null）。本技能只在 comp_* 赛事工作流内运行，拒绝猜测。" >&2
    exit 1
fi
case "$CONTEST_ID" in
    comp_cumcm)      TMPL="cumcm" ;;        # 档案 template_cls: cumcmthesis
    comp_huazhong)   TMPL="cumcm" ;;        # 档案 template_cls: cumcmthesis（withoutpreface，复用 _templates/cumcm/）
    comp_wuyi)       TMPL="wuyi" ;;         # cumcmthesis 同源 cls + 封面
    comp_huawei)     TMPL="huawei" ;;       # gmcmthesis
    comp_mathorcup)  TMPL="mathorcup" ;;    # mathorcup_main.tex（ctexart 基）
    comp_apmcm_zh)   TMPL="apmcm_zh" ;;     # MathorCupmodeling.cls
    comp_stats)      TMPL="stats" ;;
    comp_yangtze)    TMPL="changsanjiao" ;; # 长三角
    comp_huashu)     TMPL="huashubei" ;;
    comp_diangong)   TMPL="diangongbei" ;;
    comp_liaoning)   TMPL="dongsansheng" ;; # 辽宁/东三省联赛
    comp_shuwei)     TMPL="shuweibei" ;;
    comp_csf)        TMPL="csf" ;;          # 仿真建模应用挑战赛（ctexart + csf.sty；官方《论文规范》未取证，版式保持保守默认）
    comp_teddy|comp_certcup|comp_zhongqing|comp_tianfu|comp_shenzhen|comp_huadong)
        # 档案 template_cls: ctexart，暂无专用目录 → 通用 ctexart 骨架（_templates/default/）。
        # 这是档案指定文档类对应的通用骨架，不是跨赛事套用；专用模板入库后改回专属目录。
        TMPL="default" ;;
    *)
        echo "⛔ 未知赛事 ID: '$CONTEST_ID'（须为 comp_rules.json 顶层键的 comp_* 规范 ID）。拒绝猜测、不回退国赛。" >&2
        exit 1 ;;
esac
```

**放行判据**：

- 未知赛事 ID 或 `CONTEST_ID` 缺失 → 立刻停下（不回落国赛、不猜）；模板目录缺失 → 报能力缺口停止，不改用其他赛事模板。
- 复制后 `template_integrity_check.py --fingerprint` 必须通过：`paper/main.tex` 前 20 行 preamble 与模板差异 >10 行 = 骨架被重写，从模板重新复制。
- 只改 `sections/*.tex`，不重写 `main.tex`（骨架纪律见 `skills/comp-paper-zh/references/format-playbook.md` §2）。
- **同文档类复用核对**：复用骨架不携带另一赛事的封面、队号或声明。

### Step 2: Abstract 占位

**触发**：模板就位后。**细则**：`skills/comp-paper-zh/references/step_2_abstract.md`（本步只执行「占位」段；摘要规格到 Step 5.6 才整篇执行）

- **现在不写摘要正文**，只落占位 `[摘要待正文完成后填写]`——摘要必须最后写（数值来自全部章节），先写等于编数。
- 丰满模式判据：`CONTEST_ID = comp_huawei`，或 AGENTS.md 含 `丰满模式`/`rich_mode` 用户开关。
- 字数 / 六要素 / 分段骨架的唯一事实源：`skills/_utils/abstract_writing_contract.md`。

### Step 3: 图表清单与嵌入计划

**触发**：写任何章节之前。**细则**：`skills/comp-paper-zh/references/step_3_figure_plan.md`

- 先产 `FIGURE EMBEDDING PLAN`（每张图 → 章 / caption）；只嵌实际存在的 PDF。
- 每张嵌入图同步写**引用句 + 解读句**；零 `\ref` 引用或零解读的图由 `figure_narrative` 闸拒绝完成——没有解读可写的图不要嵌。
- caption 必须中文、单行、≤20 个汉字（不含「图 N」）；判据 / 参数 / 结论写正文。
- 图用 `[H]` 就地、宽度 ≥0.85\textwidth（不得 <0.8）；两个 `figure` 环境不得直接相邻。
- 子问题流程图分到各自问题章（`2_analysis` 最多放一张整体技术路线图）。
- 每写完一章跑 `figure_layout_check.py paper/`，任何 ❌ 当场修。

### Step 3.5: 文献预检索

**触发**：写任何 `\cite{}` 之前。**细则**：`skills/comp-paper-zh/references/step_3_5_literature.md`

- 先建 `_tmp/_verified_refs.txt`，正文只引用池内已验证文献；需新引用先搜再加池。
- 往届论文页面图 / `academic-toolkit/data/historical_papers.md` 只作写法借鉴，无著录信息，**禁止据此编造 bib 条目**。
- `scholar_fetch.py` 搜不到或 `match_label=low` → WebSearch 核实标题 + 作者 + 年份后再入池。

### Step 4: 写各章

**触发**：图表计划与文献池就绪后。**细则**：`skills/comp-paper-zh/references/step_4_chapters.md`（整篇读；写作方法展开见 `skills/comp-paper-zh/references/writing-playbook.md`，按节读）

- 数字只来自 `RESULTS.md` / `figures/*.json`；**禁止 `cat figures/*_results.json`**，先跑 `summarize_results.py` 取 KB 级摘要。
- 章序与文件名必须和模板 `\input{sections/...}` 一致；模型假设在符号说明之前；假设 4-5 条（上限 6 条）；符号 15-20 个。
- 正文禁 `itemize` / `enumerate`（假设与附录除外）；符号表用 `longtable`；>12 行数据表正文放缩略、附录放完整。
- 每个 headline number 带「差在哪 / 为什么 / 改变什么决策」，禁止裸数字复述；创新点按 `skills/_utils/innovation_contract.md`。
- 每章收尾把 3-5 行要点卡追加到 `_writing_context.md`，写下一章前先读。
- 本章写完自查体量：`wc -c paper/sections/当前章节.tex`（≈900 字符/页）。

### Step 5: 参考文献

**触发**：正文各章完成、引用 key 稳定后。**细则**：`skills/comp-paper-zh/references/step_5_references.md`

- BibTeX 一律经 `scholar_fetch.py` 获取，**禁止凭记忆编造**；`match_label=low` 换关键词或 WebSearch 核实。
- 引用编号全局严格递增；多引用合并按编号升序。
- citation key 用 `作者姓_年份_主题关键词`；未定项用 `TODO__` 前缀。
- 正文引用命令见上「引用命令」表（唯一真源）。

### Step 5.5: De-AI polish

**触发**：全文写完、编译前。**细则**：`skills/comp-paper-zh/references/step_5_5_deai.md`

- 引擎 `ai_flavor` 闸在 `finish` 时按同一判据核验（`ai_tell_check --strict`，硬伤 + 空话 >3 处即拒绝完成）；单跑修：`python ../../skills/_utils/ai_tell_check.py --strict paper/`。
- 工程 / 质检语汇、中文套话、内部标记（⛔✅❌ / RESULTS.md 等文件名 / HC-01 类编号）清零。

### Step 5.6: 写摘要（现在）

**触发**：全部正文章节完成后（Step 5 之后）。**细则**：`skills/comp-paper-zh/references/step_5_6_abstract_final.md`；摘要格式整篇读 `skills/comp-paper-zh/references/step_2_abstract.md`

- 只写正文已出现的数字，不改精度、不编造。
- 每问独立成段；统计建模写中英文双语摘要。
- 写完跑 `abstract_paragraph_check.py`，直到输出「✓ 摘要按问题分段正确」。

### Step 6: Final verification

**触发**：正文与参考文献定稿后、产出前。**细则**：`skills/comp-paper-zh/references/step_6_final_verification.md`

- `writing_check.sh paper/` 全绿；`paper_claim_check.py` 的 WARN 逐条确认（`PCC≠1`）。
- 论文-题目约束一致性逐条核对：摘要 / 正文 / 结论里同一结果的数字必须相同。
- `page_precheck.py --workspace .` 不超 `PAGE_CAP`，口径按 `PAGE_SCOPE`；cap 缺失 = 待核实，禁止编默认值。
- 代码只进 `paper/appendix/`；`figure_layout_check.py` 与 `template_integrity_check.py --full` 全绿。
- 扩写只往建模深度 / 结果可信度扩，不往算法叙述扩；本轮扩过章节就重跑 `facts_audit.py --stage paper`。

### Step 7: Output

**触发**：Step 6 全绿后。**细则**：`skills/comp-paper-zh/references/step_7_output.md`

- 章节文件按赛事族命名（数模按子问题编号；统计按学术结构）。
- 主产物按 `params.output_format`：PDF 模式 `paper/main.tex`（≥5KB）+ `paper/sections/*.tex` + `paper/references.bib`；docx 模式 `paper/main.md`（单文件 ≥5KB，禁止产 main.tex）。
- 产出结构 / 最低完整性由 `finish` 按 `output_contract` 核验，不另写验证脚本。

## Key Rules

- ⛔ **AI 申报双件套**：正文「AI 工具使用声明」+《AI工具使用详情.pdf》——位置、如实申报口径与唯一生成通道见上文「赛事合规硬门禁」§AI 工具使用声明（工具/型号/日期/用途只取自 `.mh/ai_disclosure.json`，禁止语言模型自由编写）。
- **AI 痕迹判据口径**（`ai_flavor` 闸的判定内容）：工程/质检语汇（口径/闭环等）从提示词流进正文是实测最高频 AI 痕迹（10 工作区 442 次命中）；中文套话（值得注意的是/综上所述/不难发现/显而易见/在此基础上/随着…的发展）与工程词同级硬拦，`--strict` 下剩余空话（由此可见/换言之等）也计失败。人工风格对照 `skills/_utils/human_competition_paper_style.md`，风格检查 `python ../../skills/_utils/human_paper_style_check.py paper/`。
- **防过度/辩护性写作（修订轮主动推荐）**：修订或压缩页数时调 `anti-defensive-writing` 技能，删不必要的 hedge/免责声明/道歉式框架/过度解释——保留必要的范围、误差与方法学限定，删的是"可能在一定程度上"式空转措辞；深度检测可加跑 `anti-ai-detection` 技能（8 维度 AI 特征分析+改写建议）。与 ai_tell_check 互补：一个删 AI 痕迹语汇、一个删防御性冗余。

- Use templates from `templates/`, do not write main.tex from scratch

- Chinese/English abstracts: manual typesetting, not two `\begin{abstract}` environments

- Citation command: 按模板取，唯一真源见上「引用命令」表。

- No `\hypersetup{colorlinks=true}` — conflicts with hidelinks

- 正文页数不超过引擎下发的赛事档案页数上限（无下限，不为凑页扩写）

- No team info — use placeholders

- Tables: three-line style (booktabs)

- Primary output: `paper/` directory, temp files: `_tmp/`

- ⛔ **本步骤只写论文 .tex 文件，不要重新生成图表 PDF、不要修改 code/*.py、不要重新运行分析代码。** 图表和数据已由前序步骤（paper-figure / comp-code）生成完毕，直接引用即可

- Large files: Bash heredoc

- ⛔ **Bash heredoc 必须用带引号的 `'EOF'`（防止 `\\` 被转义）：**

  - ✅ 正确：`cat << 'EOF' > paper/sections/4_problem1.tex`（引号内 `\\` 原样保留）

  - ❌ 错误：`cat << EOF > paper/sections/4_problem1.tex`（无引号，`\\` 变成 `\`，导致表格 `Misplaced \noalign` 错误）

  - 这是表格编译失败的最常见原因——40+ 处 `\\` 全部变成 `\`，编译器只报第一个错就停了

## ⛔ 数据可追溯性（写稿强制规则）

> 防「图文表面自洽但数据是历史版本」；详见 `skills/_utils/error_prevention.md` 第九章。

正文/图表/附录引用的**每一个具体数字**必须能在当前 `results.json` 或 `figures/all_results.json` 溯源，RESULTS.md 末尾带 `<!-- AUDIT_OK source=results.json rechecked_at=<timestamp> -->` 凭证，且工作区无 `results_v*.json` / `results_old.json` / `*_backup.json` 残留。这三条由引擎 `result_sanity_check` 在 `finish` 核验（另含 NaN/Inf、负误差、R²<0.5、p 值越界），单跑 `cd academic-toolkit && python engine/quality_gates.py gate <工作区> --check result_sanity_check`；数字是否真进了正文由 `paper_consistency` 核验。

对**派生属性**（依赖载体 / 上游变量动态变化的作用范围、时变参数、状态依赖容量、时变转化率等），**禁止**简化成"以静态点为中心的固定区域"或"取均值后当常数"，除非确为静态实体且已显式声明简化条件。

语义终检仍归 `facts_audit`（无语义等价检查器），cwd=工作区根单跑：`(python skills/_utils/facts_audit.py --stage paper 2>/dev/null || python academic-toolkit/skills/_utils/facts_audit.py --stage paper 2>/dev/null || python ../../skills/_utils/facts_audit.py --stage paper) 2>&1 | tee -a AUDIT_REPORT.md`——[13] 正文结论一致性、[14] 事件源归属（"谁做了什么 N 次"须能从 results.json 的 verb_to_sources/events 反推）、[15] 数字溯源（60 采样+容差匹配）。**exit 1 = 有与 results.json 不一致或无法溯源的数字——改回真实值或删除，禁止带病编译。**

## 九维自评评分件（PAPER_SCORING.json，模板声明 paper_scoring: true 时必产）

完成初稿即按 `academic-toolkit/skills/math-modeling-contest-route-selection/references/paper-scoring-framework.md` 的 9 维逐维打 0-5 分，每维必须引用正文/图/表位置，写入 `PAPER_SCORING.json`：

- `scores`：非空对象，键为 9 个维度名，值含 `score` 与证据位置（正文/图/表）；
- `weighted_total`：数值；
- `fatal_dimensions`：数组（无致命维度写 `[]`）；
- `selfcheck_failures`：数组。

引擎 `paper_scoring_contract` 在 `finish` 解析这三个字段（单跑 `cd academic-toolkit && python engine/quality_gates.py gate <工作区> --check paper_scoring_contract`）；空对象、非法 JSON、缺字段均按 blocking 处理，不得只交一个存在但不可用的文件。仅模板显式 `paper_scoring: true`（`comp_cumcm` / `comp_huawei` / `comp_csf`）要求本文件；声明 `false` 的链不产评分件。

## 本步引擎承接的判据

`finish` 自动跑：`result_sanity_check`（见上）、`paper_consistency`（正文引用结果数字）、`ai_flavor`（Step 5.5）、`figure_narrative`（Step 3）、`step_manifest`；`comp_cumcm` / `comp_huawei` 另有 `literature`，模板声明页数复核时 `paper_pages`（`PAGE_CAP` / `PAGE_SCOPE`）。语义判据留在正文规则：章序同模板 `\input`（§赛事结构）、摘要只写正文已有数值（Step 5.6）、扩写只往建模深度（Step 6）。

## 退出判据（Verification）

本步完成前逐项自检（不达标即视为未完成）：

- [ ] 章节结构与模板要求一致（不照抄模板文字）
- [ ] 摘要含结论性数值而非空话
- [ ] 每个数值与图表可在账本中溯源
- [ ] 正文页数在规则上限内（附录另计）

## 常见合理化（Common Rationalizations）

| 合理化 | 现实 |
|---|---|
| "字数够了就行" | 体量不等于质量：本项目真实教训是产物只有目录级厚度的形式合规。 |
| "摘要最后再补" | 摘要是评审第一眼；后补的摘要往往与正文结论脱节。 |
| "页数超一点没关系" | 页数是官方硬性上限，属交付阻断项，不存在超一点的说法。 |

> 本段与 `skills/_utils/anti_rationalization.md`（全局版）配套：本表是本步专属，
> 全局版覆盖跨步骤通用借口。新增借口时优先落到本表（更贴岗位），能泛化再上升。

## 版式参考（paper-layout）

- `references/mml-skills/paper-layout/`：论文版式六件（core/body-density/page-composition/latex-figures/latex-math/docx-figures）——排版与图表密度决策时按需读。（来源 Math-model-skills，MIT，溯源见同目录 UPSTREAM.md）