Skip to content

OrinVoss/dsh-math-team / presets/paper/skills/math-paper/references/roles-论文手

论文手

Verified

根据题目、建模分析和真实代码结果生成完整 Word 数学建模论文,用户显式要求时同时生成 LaTeX 论文。

FileKindSize
LaTeX格式规范.mdmarkdown4.3 KB
SKILL.mdskill md10.9 KB
写作规范.mdmarkdown4.2 KB
工作流程.mdmarkdown8.7 KB
章节模板.mdmarkdown1.7 KB
自审框架.mdmarkdown4.2 KB
英文化工作流.mdmarkdown5.2 KB
论文格式规范.mdmarkdown5.2 KB

工作流程.md

View on GitHub


> **⚠️ 工具脚本未随附**:本文档引用到的 `tools/*` 路径(如 `tools/latex`、`tools/docx`、`tools/figure/scripts`、`tools/paper_search` 等)来自参考仓库的**工具脚本**,本预设**仅随附方法论文档,未包含这些脚本**。遇到文档中的此类命令时:按正文描述的方法自行实现等价脚本,或由团队在共享工作区另行接入对应工具;**不要假设这些脚本存在于本机**。方法规范本身仍然有效。

# 论文手工作流程

## 一、锁定官方规则

生成前确认目标竞赛、届次、语言、提交格式和官方规则来源。优先使用用户提供或从官方网站取得的当届官方 Word/LaTeX 模板、摘要页、编号页和格式说明。默认只生成 Word 论文;用户显式要求时同时生成 LaTeX/PDF。当届官方提交要求仍决定实际可提交的版本。把规则来源与届次记录在内部检查中,不把往届经验写成固定规则。

## 二、检查输入

必须具备:

- 题目及附件
- `题目分析报告.md`
- `术语表格.md`
- 可运行代码
- 实际运行结果表格
- 原始数据图、模型运行过程图和最终结果图
- 已核验的文献元数据

关键输入缺失时回退到对应角色补齐,不能推测数值、伪造图表或编造引用。

## 三、内部论证映射

写作前在内存或临时工作区建立主张—证据映射:每个结论对应公式、表格、图、代码输出或文献。映射只用于检查,不作为额外交付物。

同时记录两类篇幅约束:一类是当届官方页数、摘要和文件限制,必须满足;另一类是论文完整度质量目标,可以由用户覆盖。CUMCM 未给出更具体要求时,可按约 15000 字词单位、约 20 页规划,但不得称为官方最低要求。以 2026 年官方规范为例,正文不超过 30 页。

## 四、W1 证据大纲

在长篇正文和双格式排版前,为每个子问题列出拟写核心主张及其公式、结果表行列、图文件、代码输出或已核验 DOI,由独立质检 Subagent 检查:

- 每个必须回答的结论类型都有精确证据路径。
- 摘要拟用关键数值与实际结果一致。
- 公式、图表和引用都有章节落点。
- Word 与 LaTeX 共用同一份正文和证据源。

存在核心证据缺口时返回建模手或编程手补齐;`W1` 未返回 `PASS` 不开始正文。证据大纲仅用于内部验收,不新增固定交付物。

## 五、截止时间与可提交版本保护

真实竞赛或其他有明确截止时间的任务,按 `../../../../references/交付与截止时间协议.md` 读取当前系统时间并核验当届官方截止时间、时区和提交限制。在长篇排版前用最小真实样例走通代码、图表、DOCX/PDF、支撑材料和压缩包链路,把转换、渲染、人工检查、压缩和上传视为正式任务。

首次得到完整且满足已知硬约束的论文和支撑材料时保存 Checkpoint V1,后续优化在副本或新版本上进行;V1 不得被原地覆盖。安全时间允许时形成 Checkpoint V2,随后内容冻结、最终导出并完成完整性与合规检查。临近最迟安全导出时间时,若新修改失败后无法回退并按时提交,默认不执行该修改。

## 六、构建论文

先锁定一份共同的正文、数据、图表、公式和参考文献,再生成两种格式;不得分别改写导致结论或数值不一致。

### Word 分支

1. 从当届官方参考模板创建文档;模板正文示例必须清除,但保留样式、分节、页眉页脚和页面设置。
2. 使用 `../../../../tools/docx/scripts/paper_format.py` 添加标题、段落、公式、表和图片。
3. LaTeX 只作为公式输入,转换成 Word 原生 OMML;不支持的命令必须报错。
4. 表格使用可编辑 Word 表格;图使用编程手实际生成的文件。
5. 每幅图和每个表均设置连续编号与题注,并在正文中至少引用一次;文献编号、正文引用和 DOI 双向核对。

已有完整 LaTeX 主稿且需要同时交付两种格式时,可调用 `docx(action="convert_latex")` 或 `equations.py convert-latex` 生成 Word 初稿,以减少正文漂移;随后仍须按官方 DOCX 模板检查样式、分页、浮动体、交叉引用和参考文献。

### LaTeX 分支

1. 先运行 `latex_paper.py doctor` 检查官方模板需要的引擎、参考文献后端、PDF 审计工具和 Pandoc(需要 Word 时)。
2. 用 `latex_paper.py init` 把当届官方 LaTeX 模板整个目录复制到 `PROJECT_ROOT/完整论文-LaTeX/`;保留 `.cls`、`.sty`、`.bst`、字体和模板图片,并记录模板 URL、届次、哈希及嵌套主入口。没有官方模板时才使用内置构建基线。
3. 在复制件中填充正文、公式和已核验的 BibTeX 条目,不修改原始模板或 `SKILL_ROOT`。把 `PROJECT_ROOT` 权威代码和图表复制到 LaTeX 项目后,立即用 `latex_paper.py bind` 建立资源哈希绑定;每个子问题至少安排一幅标签以 `fig:qN-` 开头的正式结果图。
4. 按官方模板要求选择 XeLaTeX、LuaLaTeX 或 pdfLaTeX,优先由可实际执行的 `latexmk` 编译;不可执行且无外部文献时回退为两次所选引擎编译。不启用 shell escape,不自动安装宏包,不在失败后擅自换引擎。
5. 消除编译错误、未解析交叉引用和未解析文献;每个图表都有题注、真实内容与 `label`,并由图表环境外的正文 `ref`。同时检查权威资源—源码—PDF 哈希、PDF 总页数、正文页数、附录边界、空白页、页面尺寸、字体嵌入和图片 DPI。

## 七、验证

Word:

```powershell
python ../../../../tools/docx/scripts/self_check.py
python ../../../../tools/docx/scripts/office/validate.py "<PROJECT_ROOT>/完整论文.docx"
python ../../../../tools/docx/scripts/equations.py verify-conversion "<PROJECT_ROOT>/完整论文.docx"
```

最后一条仅适用于 LaTeX/Markdown 经 Pandoc 转换得到的 DOCX。另需调用 `paper_format.validate_paper_structure()` 检查篇幅、公式/图/表数量、图表正文引用与参考文献对应关系,并把渲染后的实际页数传入 `rendered_pages`。随后抽检分页、公式、图表、页眉页脚和目录,并从实际 DOCX 提取文本,检查 `**`、反引号、标题 `#`、表格竖线、公式定界符 `$`/`$$`、行首列表标记和 `[待补充]` 等 Markdown 格式残留或占位符。命中项须逐条人工判断;非正文所需的残留必须从源文件清除、重新导出并复验。任何错误或无合理覆盖依据的预警都应修复后重新生成。

LaTeX:

```powershell
python ../../../../tools/latex/scripts/latex_paper.py doctor --engine xelatex --bibliography-backend <none|bibtex|biber> --need-pandoc
python ../../../../tools/latex/scripts/latex_paper.py build "<PROJECT_ROOT>/完整论文-LaTeX/main.tex" --engine xelatex --publish "<PROJECT_ROOT>/完整论文.pdf"
python ../../../../tools/latex/scripts/latex_paper.py validate "<PROJECT_ROOT>/完整论文-LaTeX/main.tex" --pdf "<PROJECT_ROOT>/完整论文.pdf" --contest cumcm --quality-checks --questions q1 q2 q3 --min-image-dpi 300 --max-pages <当届官方正文上限> --body-start-page <正文起始页> --appendix-start-page <附录起始页>
```

没有附录时省略 `--appendix-start-page`。构建与转换警告默认阻断发布;只有逐项核对后才能用精确允许正则和具体覆盖理由继续。降低默认质量目标也必须记录官方条款或用户要求。自动校验通过后,再打开实际编译 PDF,抽检摘要页、正文和附录边界、分页、公式、图表、页眉页脚、字体和参考文献。

## 八、W2 论文终检

用户要求的全部格式冻结且各自确定性门禁全部返回 0 后,按 `../../../../references/Subagent调度.md` 派发独立质检 Subagent。质检者核对当届规则、主张—证据、数值与单位、图表编号和正文引用、Markdown 格式残留、支撑材料完整性及实际渲染效果;同时生成两种格式时再检查 Word/LaTeX 一致性。失败回执必须定位到页码、章节、命令或来源,并按根因返回对应角色;`W2` 未返回 `PASS` 不得交付。

## 九、交付

默认交付 `PROJECT_ROOT/完整论文.docx`、对应 `.conversion.json`、`PROJECT_ROOT/完整论文-LaTeX/`、由其实际编译的 `PROJECT_ROOT/完整论文.pdf` 和对应 `.build.json`;用户明确只要一种格式时只交付指定格式。临时 Markdown、内部映射、检查日志和中间文件不作为交付物。最终包须按当届规则核对文件名、扩展名、大小和目录结构,并实际解压或打开验证。Agent 不能代替用户完成登录、上传和提交确认时,必须明确提醒用户执行并留存成功凭证;未经证据确认不得声称已经提交。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall