用途
本技能负责数学建模国赛（CUMCM）正式论文的范式写作、章节编号、写作约束、Word 排版和格式检查。正式论文必须由 Agent 基于完整证据链全局写作，不得机械拼接 quickstart 草稿或微单元草稿。
主要能力
- 生成正式论文大纲（paper_outline.json）。
- 基于完整证据链全局撰写正式论文源文件（final_paper_source.md）。
- 使用 python-docx 导出 Word 文档（final_paper.docx），不依赖 LibreOffice。
- 格式检查：检查字数、章节、三级标题、图表引用、参考文献、附录、占位符、证据覆盖和 Word 视觉结构，输出格式检查报告（md 与 json）。
- Word 视觉 QA 至少检查 docx 能否打开、段落数、标题样式数量、图片数量和表格数量是否与索引大体匹配。
使用方式
本技能不得作为孤立入口。用户要求完整论文、生成 Word、继续流程或不确定阶段时，先回到 paper-workflow-orchestrator 判断当前 S0-S8 阶段。
启动或继续正式任务前，必须运行：
python .claude/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，先运行：
python .claude/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 .claude/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 和待写作清单。
正式工作流
- 确认证据门禁已通过；若未通过，先补齐 paper_output/code/、results/、tables/ 和 figures/。
- 运行：
python .claude/skills/paper-formal-writer/scripts/build_paper_outline.py
- Agent 读取 paper_outline.json 和 references，基于完整证据链全局撰写 paper_output/final_paper_source.md。
- 运行：
python .claude/skills/paper-formal-writer/scripts/format_formal_docx.py
python .claude/skills/paper-formal-writer/scripts/check_paper_format.py
- 若格式检查失败，按报告补正文、图表解释、参考文献、附录或缺失章节。
脚本清单
- 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 视觉结构，输出 paper_output/format_check_report.md 与 paper_output/format_check_report.json。
References
- 正式格式总规范：references/cumcm-paper-standard.md
- 可直接交给 Agent 的全文模板：references/formal-paper-template.md
- 各章节扩写规则：references/section-expansion-rules.md
- 图表、公式、算法和结果解释规则：references/figure-table-writing-rules.md
适用场景
- quality-assurance-auditor/scripts/evidence_gate.py official 模式已经通过，需要进入正式成稿。
- 用户要求“按国赛论文格式”“正式 Word”“扩写到比赛论文工作量”“图表插入并解释”“检查论文格式”。
- 已有 final_paper_source.md 或 final_paper.md，需要统一 Word 样式、图题表题和标题层级。
正式论文要求
- 标题编号固定采用 1 / 1.1 / 1.1.1。
- 正式稿默认目标为 18000-25000 中文字；低于 18000 在正式格式检查中失败。
- 摘要按子问题展开，包含方法、模型、算法和关键结果。
- 结构完整：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 等形式说明。
与其他 skill 的关系
- paper-workflow-orchestrator：总入口，证据门禁通过后路由到本技能。
- paper-micro-unit-generator：提示词资产库和兜底草稿工具，不再作为正式论文主笔。
- quality-assurance-auditor：负责证据门禁；本技能负责格式门禁，两者都通过后才可称为正式稿。
限制
- 本技能只写入自己契约范围内的 paper_output/ 产物。
- 证据门禁未通过时，不得把 Word 称为最终稿。
- 本技能不得作为孤立入口使用。
- 关于收费、价格、平台支持等信息，资料暂未提供。