# Mm Paper Build

> 数学建模竞赛 V2 论文构建阶段。用于根据实验结果、图表、模型报告和高分论文标准撰写 LaTeX/Typst 论文，插入图表，维护结论追踪并避免纯文字稿。

- Skill: `zklzzklzkl/mm-paper-build` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zklzzklzkl/mm-paper-build`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zklzzklzkl/mm-paper-build/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zklzzklzkl (https://skillmd.com/u/zklzzklzkl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zklzzklzkl/mm-paper-build

---


# Paper Build

> 文件关系全貌请见 [[FILE_RELATIONSHIP_MAP]] · 上游: [[skills/mm-data-experiment/SKILL|Phase 3 Experiment]] · 下游: [[skills/mm-contest-review/SKILL|Phase 5 Review]] · 共享规范: [[skills/_references/SKILL|_references]]

## Load First

Read:

- `../_references/v2_pipeline_contract.md`
- `../_references/rag_usage_contract.md`
- `../_references/source_quality_policy.md`
- `../_references/paper_benchmark_profile.md`
- `../_references/figure_evidence_map.md`
- `../_references/evaluator_optimizer_protocol.md`
- `../_references/figure_quality_standard.md`
- `../_references/nature_figure_integration_guide.md` when optional `nature-figure` scientific plotting integration is available
- `../_references/ars_v2_integration_guide.md` when optional ARS writing audit is available

## Inputs

Require:

- `reports/ANALYSIS_MODELING_REPORT.md`
- `reports/MODELING_DECISION.md`
- `reports/RESULTS_REPORT.md`
- `reports/FIGURE_PLAN.md`
- `reports/TEMPLATE_ADAPTATION_LOG.md` if code templates were used
- `results/RESULTS_MANIFEST.json`
- `figures/`

## Required Outputs

- `paper/`
- `reports/CLAIM_TRACE.md`
- `reports/METHOD_IMPLEMENTATION_MATRIX.md`
- `reports/PAPER_BUILD_REPORT.md`
- `reports/REFINEMENT_LOG.md`
- updated `WORKFLOW_STATE.md`

## Hard Rules

- Do not produce a text-only paper.
- For formal contest submission, default to LaTeX or Typst. ReportLab/Markdown PDF is a preview artifact unless the user explicitly requested short-report mode.
- Do not invent numbers, tables, or figure conclusions.
- Insert figures near the section where they support reasoning.
- Every inserted figure must have a caption and surrounding explanation.
- Every key claim must map to a manifest metric, table, figure, or modeling decision.
- Do not mention workflow internals such as `reports/`, `WORKFLOW_STATE.md`, or agent names in the final paper.
- Do not claim a stronger method than the code/results actually implemented.
- For non-trivial contests, include one non-data figure such as a technical route, modeling framework, mechanism diagram, or algorithm flowchart unless `PAPER_BUILD_REPORT.md` gives a contest-specific exception.
- If an approved high-score method is downgraded during implementation, update the paper wording and `METHOD_IMPLEMENTATION_MATRIX.md`; do not leave the old method promise implicit.
- Generated figures should use CJK-compatible fonts; matplotlib default DejaVu Sans can produce square boxes for Chinese labels. Check labels before inserting.
- For a formal contest with four or more subproblems, a paper under 8 pages is a `HIGH` compression risk unless appendices and dense evidence justify it; 5 pages or fewer with limited formulas/figures is a `BLOCKER` unless the user explicitly requested short-report mode.
- Each major subproblem must include method definition, formula or algorithm explanation, result table or figure, validation/sensitivity when applicable, and limitations. Missing any element prevents a high score for paper structure, rigor, or validation.

## Writing Flow

1. Confirm engine from `plan.md`; default to LaTeX if missing. Use Typst when the plan or contest template prefers Typst.
2. Choose the closest existing template from legacy `5writing/templates/` when available.
3. If local RAG is available, query `paper_expression`, `excellent_papers`, and `figure_templates` for sourced expression patterns, structure cues, and caption standards. Core paper claims may only rely on current results or `S/A` sources from `../_references/source_quality_policy.md`; expression and figure templates are `B` auxiliary sources. Record source quality in `reports/PAPER_BUILD_REPORT.md`; do not expose RAG, reports, or skill names in the final paper text.
4. Build a section outline from the contest type and number of subproblems.
5. Build `reports/METHOD_IMPLEMENTATION_MATRIX.md` by comparing `MODELING_DECISION.md`, code scripts, result files, `RESULTS_MANIFEST.json`, and planned paper claims.
5a. Optional ARS argument-chain check: if ARS is available, load `<ARS_ROOT>/academic-paper/agents/argument_builder_agent.md` as a role prompt. Use only for Claim-Evidence-Reasoning review. For each planned core claim, verify the chain `claim -> evidence (manifest/table/figure/model decision) -> reasoning`. If reasoning is missing or implicit, add an explicit reasoning sentence or downgrade the claim wording before drafting.
6. Draft each problem section only after its result entries exist.
7. Insert figures and tables according to `reports/FIGURE_PLAN.md`. Insert every core figure needed for the argument; list any unused paper-intended figure with a reason in `PAPER_BUILD_REPORT.md`. A core figure must bind to a claim and evidence-map entry from `../_references/figure_evidence_map.md`, including required data, metrics, axes/units, and caption points.
7a. When `nature-figure` is enabled, use only figures with a completed figure contract, selected-backend script, traceable source data, SVG/PDF export, and a conclusion-forward caption for core paper claims. A PNG-only core data figure or `Pillow` data figure must create a `HIGH`/`BLOCKER` revision item instead of being silently inserted.
8. Add a technical route or modeling framework figure for non-trivial contests.
9. Write abstract last, using final methods and numeric results.
9a. Optional ARS bilingual abstract: if ARS is available and the contest template allows an English abstract, the paper language is English, the contest is MCM/ICM-style, or the user explicitly requested bilingual output, load `<ARS_ROOT>/academic-paper/agents/abstract_bilingual_agent.md` as a role prompt. Generate a non-mechanical bilingual abstract using Background, Purpose, Method, Findings, and Implications. For Chinese national-style templates, do not add an English abstract by default.
10. Fill `reports/CLAIM_TRACE.md` with claim strength, not only source existence.
11. Run the paper draft evaluator-optimizer loop from `../_references/evaluator_optimizer_protocol.md` for at most 3 rounds. Check scorecard risks, judge skim, claim trace, figure evidence, method implementation, and wording strength. Record all rounds in `reports/REFINEMENT_LOG.md`; route residual `HIGH/BLOCKER` items to `REVISION_ACTIONS.md`.
12. Write `reports/PAPER_BUILD_REPORT.md` summarizing files created, figures inserted, figure omissions, method downgrades, local RAG evidence used, source quality, refinement loop result, and unresolved issues.

## Method Implementation Matrix

Write:

```markdown
# Method Implementation Matrix

| Problem | Approved Method | Implemented In Code/Results | Paper Wording | Status | Action |
| --- | --- | --- | --- | --- | --- |
```

`Status` must be:

- `implemented`: approved route is implemented and paper wording matches it
- `downgraded_with_disclosure`: a simpler method was used and the paper/decision files honestly disclose it
- `not_implemented`: approved method is missing and not honestly downgraded
- `not_applicable`: approved method no longer applies with a stated reason

No paper may be treated as final while any core row is `not_implemented`.

## Claim Trace Format

```markdown
# Claim Trace

| Claim | Paper Section | Evidence Type | Evidence ID/File | Strength | Paper Wording Check |
| --- | --- | --- | --- | --- | --- |
```

`Strength` must be `strong`, `acceptable`, `weak`, or `missing`.

- `strong`: directly supported by code/result/table/figure and validation
- `acceptable`: supported, but with limited data, assumptions, or modest validation
- `weak`: traceable source exists, but evidence is too limited for a strong conclusion
- `missing`: no reliable source

For `weak` core claims, the paper wording must be cautious (`exploratory`, `limited sample`, `conditional`, or equivalent). No final paper may pass with `missing` core claims or strongly worded `weak` core claims.

## Minimum Paper Evidence

The paper must contain:

- data preprocessing evidence
- model construction evidence
- result table or numeric summary
- at least one figure per major subproblem or a documented exception
- at least one non-data method/process figure for non-trivial contests
- validation, sensitivity, or robustness analysis
- model strengths, weaknesses, and improvement discussion
- for core paper-intended figures, a traceable contract linking conclusion, panel evidence, source data, script, caption, and claim

For formal multi-question contest papers, `reports/PAPER_BUILD_REPORT.md` must also state:

- final engine: LaTeX / Typst / preview-only
- page count or expected page count
- number of inserted figures and tables
- whether any core figure is PNG-only or lacks SVG/PDF export
- whether the output is formal submission or short-report mode