paper-formal-writer - SKILL.md Agent Skill

name: "paper-formal-writer" description: "国赛数学建模正式论文范式、outline、Word 排版和格式门禁 skill。Invoke when 证据门禁通过后需要生成 CUMCM 风格正式论文、规范标题编号、扩写正文、插入图表表格、导出 Word 或检查论文格式。"

本 skill 不得作为孤立入口。用户要求完整论文、生成 Word、继续流程或不确定阶段时，先回到 paper-workflow-orchestrator 判断当前 S0-S8 阶段。

启动或继续本 skill 的正式任务前，必须运行：

python .trae/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --skill paper-formal-writer

如果输出 [WORKFLOW FAIL] 或报告 status != "PASS"，停止本 skill，按 paper_output/qa/workflow_guard_report.json 的失败项回补前置阶段，不得凭记忆继续。
本 skill 只写入自己契约范围内的 paper_output/ 产物；完成后必须回到 paper-workflow-orchestrator 判断下一步，并用 context-memory-keeper 记录已完成产物、阻塞项和下一步。
长对话中如果上下文变长、阶段不确定或用户分开调用 skill，先运行：
```
python .trae/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --status
```
再读取 paper_output/qa/workflow_guard_report.json、paper_output/preflight_report.json、paper_output/input_manifest.json、paper_output/results/run_manifest.json 和本 skill 的上游 JSON 契约，按报告里的 recommended_skill 与 next_action 继续。
继续流程前，必须把 paper_output/context/workflow_memory.json 视为长期断点记录；若其中的 current_step、next_step、recommended_skill 与 workflow_guard.py --status 不一致，以 guard 报告为准。
每次完成本 skill 的产物后，先回到 paper-workflow-orchestrator 或运行 workflow_guard.py --status，再更新 workflow memory：
```
python .trae/skills/context-memory-keeper/scripts/update_workflow_memory.py
```
更新后读取 paper_output/context/workflow_memory.json / .md，确认下一步和推荐 skill 已记录。

上游输入：必须优先读取 paper_output/plan/model_route.json、paper_output/results/、paper_output/tables/table_index.json、paper_output/figure_index.json 和证据门禁报告。
核心输出：paper_output/plan/paper_outline.json、paper_output/final_paper_source.md、paper_output/final_paper.docx、paper_output/format_check_report.md。
下游交接：格式检查通过后，回到 quality-assurance-auditor 做最终一致性检查；未通过时继续补正文、图表解释或证据引用。
失败回退：证据门禁未通过时，不得把 Word 称为最终稿；可以只生成 outline 和待写作清单。

scripts/build_paper_outline.py
- 读取题意、模型路线、结果、指标、结论、图表和表格索引。
- 输出 paper_output/plan/paper_outline.json。
scripts/format_formal_docx.py
- 输入 paper_output/final_paper_source.md。
- 输出 paper_output/final_paper.docx 和 paper_output/format_check_report.md。
- 使用 python-docx，不依赖 LibreOffice。
scripts/check_paper_format.py
- 检查字数、章节、三级标题、图表引用、参考文献、附录、占位符、证据覆盖和 Word 视觉结构。
- Word 视觉 QA 至少检查 docx 能否打开、段落数、标题样式数量、图片数量和表格数量是否与索引大体匹配。
- 输出 paper_output/format_check_report.md 与 paper_output/format_check_report.json。

运行：

python .trae/skills/paper-formal-writer/scripts/build_paper_outline.py

Agent 读取 paper_outline.json 和 references，基于完整证据链全局撰写：
```
paper_output/final_paper_source.md
```

运行：

python .trae/skills/paper-formal-writer/scripts/format_formal_docx.py
python .trae/skills/paper-formal-writer/scripts/check_paper_format.py

摘要按子问题展开，包含方法、模型、算法和关键结果。
1 问题重述、2 问题分析、3 模型假设、4 符号说明、5 模型的建立与求解、6 模型检验与灵敏度分析、7 模型评价与推广、8 参考文献、附录 结构完整。
每问在第 5 章中至少包含 5.x.1 建模思路、5.x.2 变量定义与公式推导、5.x.3 求解算法、5.x.4 结果分析、5.x.5 模型检验或灵敏度分析。
每张图表必须在正文中引用并解释；图表不能只插入不分析。
每个公式必须先定义变量、再给公式、再解释公式含义和用途。
算法必须用 Step 1、Step 2 等形式说明。