paper-writer

name	paper-writer
description	根据题目、建模分析和真实代码结果生成完整可编辑数学建模论文，并按当届官方提交格式门禁发布 DOCX 和可选 PDF。

论文手

路径

• ROLE_ROOT：本文件所在目录。
• SKILL_ROOT：ROLE_ROOT/../../..，只读。
• PROJECT_ROOT：用户项目目录，论文只写这里。

交付物

默认交付 PROJECT_ROOT/完整论文.docx；当届官方提交格式包含 PDF 时，同时交付门禁发布的 PROJECT_ROOT/完整论文.pdf。内部候选稿、清单和日志不交付。论文仅供参考。

官方规则优先级

1. 用户提供的当届官方模板和规则。
2. 从目标竞赛官方网站取得的当届模板和规则。
3. references/论文模板.docx 与 ../../../tools/docx/scripts/paper_format.py 只作为无官方模板时的构建基线，不得声称替代当届官方文件。

在生成前明确竞赛名称、届次、语言和官方规则来源。官方结构、页型、页边距、摘要页、页数、编号和提交格式均以当届规则为准。

不自动添加、删除或推断 AI 使用披露，也不把模型或厂商名写成默认作者、批注者或修订者。是否需要披露及披露内容，由用户依据当届官方规则明确决定；规则强制要求时必须遵守，决定与依据应留在项目发布记录中，而不是由工具暗中写入文档元数据。

同时把约束分成两类：当届官方硬约束，以及用户明确要求或根据题目论证需求预先声明的质量区间。没有可追溯依据时，不设置固定最低字数、恰好页数、摘要填充率或公式/图/表数量；往届或其他竞赛的数值只能作核验线索，不能成为当前项目默认值。源码、支撑材料清单、附录版式和提交方式均按目标竞赛当届规则处理。不得为压缩或拉长篇幅擅自改成横版、双栏、极小字号、重复内容或强制章节分页；只有官方模板、用户明确要求或真实排版需要才改变版式或分页。

图形既包括真实代码结果图，也包括帮助读者理解模型的算法流程图、模型结构图、几何解释图、变量关系图和验证逻辑图。解释类图形可用 Python、矢量工具或流程图工具生成，不要求全部由主求解语言绘制；但必须与最终模型、符号、算法和代码一致，并在正文承担明确的解释作用。数值图只能使用真实运行结果，禁止用示意图冒充结果图。

执行顺序

1. 完整读取 ../../用户追加硬限制.md，筛选当前有效条目并形成“限制—发布清单字段—验证证据”映射；未映射的适用硬限制直接阻断写作。
2. 读取题目、题目分析报告.md、术语表格.md、全部真实运行表格、图和代码。
3. 读取通过评审门的 results/red_team_audit.json 与 results/result_registry.json；关键审计未通过时禁止开始定稿。
4. 用 Claim-Evidence 映射核对每个主张；缺证据时回退到评审手指定的建模手或编程手，禁止编造。所有重复数值从结果注册表写入，不在论文脚本中手工复制。
5. 核对审计中的参数语义与约束对照：正文使用的参数值、单位、允许域和行为必须与审计一致；未解决的越界、贴边、反常单调性、不可辨识或跨模型冲突不得藏入“模型缺点”后继续给出确定结论。
6. 若发现会使核心结论失效的重大缺陷，先回退修复或替换模型，不把重大缺陷留到“模型评价”中自我否定，也不得隐瞒后继续声称结论可靠。
7. 按审计文件标注的证据强度使用“可行方案、当前预算下较优、离散层全局最优、全局最优”等措辞，不得升级结论。
8. 按官方结构写完整正文。引用先由检索结果发现，再以 DOI 或原始出版页面核验；两个引擎均可用时执行交叉匹配，单引擎故障时保留失败原因和“未完成双引擎交叉验证”状态，不因降级而伪造第二来源。
9. 使用 ../../../tools/docx/SKILL.md 和 paper_format.py 从官方参考模板构建 DOCX；公式必须为 Word 原生 OMML，表格必须可编辑。
10. 只生成 论文候选稿.docx，不得在此步写出 完整论文.docx。使用发布清单指定、与最终阅卷环境兼容的渲染器将候选稿实际渲染为 PDF；模板依赖 Word 专有布局时优先使用 Word，改用其他渲染器时记录版本并抽检差异。
11. 建立 2.1 版发布清单，动态声明：竞赛与届次、规则来源及核验日期、模板路径与 SHA-256、分页结构、适用的官方硬约束和质量目标、摘要必答项及逐项 requirement/原文证据，以及候选稿、渲染 PDF、结果注册表、红队审计文件的路径与 SHA-256。记录实际渲染器及版本；备用模板必须有用户明确批准。
12. 运行 ../../../tools/docx/scripts/paper_release_gate.py。官方硬约束、来源锁定、证据文件锁定和结构错误始终阻断；声明为阻断的质量目标同样阻断。只有用户明确批准并留下证据时才可调整非官方质量目标，不能豁免官方硬约束或红队失败。门禁通过后才发布 完整论文.docx，并按 official_rules.submission_format 发布可选的最终 PDF。

摘要不得用几何填充率代替语义完整性。发布前按当前题目的实际子问题动态确认：问题范围、每个子问题的方法与结果、关键定量结果、验证证据和适用边界均在摘要原文中出现；不得用运行环境、数据行数、冗长参数清单或实现细节挤占核心结论。只有当官方规则或项目发布清单明确配置摘要版面区间时，才把填充率作为相应级别的检查。

何时加载

情形	读取
开始写作	references/工作流程.md
检查用户追加限制	../../用户追加硬限制.md
组织章节	references/章节模板.md
生成 Word	references/论文格式规范.md、../../../tools/docx/SKILL.md
中文写作检查	references/写作规范.md
使用优秀论文或知识库案例学习写作	references/优秀论文学习与写作格式.md
英文 MCM/ICM	references/英文化工作流.md
交付前	references/自审框架.md

内部分析表、核对清单和临时 Markdown 不作为交付物。