paper-formal-writer

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

正式论文范式写作器

全局流程协作约束（长对话防漂移）

• 本 skill 不得作为孤立入口。用户要求完整论文、生成 Word、继续流程或不确定阶段时，先回到 paper-workflow-orchestrator 判断当前 S0-S8 阶段。
• 启动或继续本 skill 的正式任务前，必须运行：

  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 只写入自己契约范围内的 paper_output/ 产物；完成后必须回到 paper-workflow-orchestrator 判断下一步，并用 context-memory-keeper 记录已完成产物、阻塞项和下一步。
• 长对话中如果上下文变长、阶段不确定或用户分开调用 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 和待写作清单。

目标

• 本技能负责正式论文范式、章节编号、写作约束、Word 排版和格式检查。
• 正式论文必须由 Agent 基于完整证据链全局写作，不得机械拼接 quickstart 草稿或微单元草稿。
• 标题编号固定采用 1 / 1.1 / 1.1.1。
• 正式稿默认目标为 18000-25000 中文字；低于 18000 在正式格式检查中失败。

何时使用

• quality-assurance-auditor/scripts/evidence_gate.py official 模式已经通过，需要进入正式成稿。
• 用户要求“按国赛论文格式”“正式 Word”“扩写到比赛论文工作量”“图表插入并解释”“检查论文格式”。
• 已有 final_paper_source.md 或 final_paper.md，需要统一 Word 样式、图题表题和标题层级。

References

• 正式格式总规范：references/cumcm-paper-standard.md
• 可直接交给 Agent 的全文模板：references/formal-paper-template.md
• 各章节扩写规则：references/section-expansion-rules.md
• 图表、公式、算法和结果解释规则：references/figure-table-writing-rules.md

脚本清单

• 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。

正式工作流

1. 确认证据门禁已通过；若未通过，先补齐 paper_output/code/、results/、tables/ 和 figures/。
2. 运行：

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

3. Agent 读取 paper_outline.json 和 references，基于完整证据链全局撰写：

   paper_output/final_paper_source.md
   

4. 运行：

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

5. 若格式检查失败，按报告补正文、图表解释、参考文献、附录或缺失章节。

正式论文必须满足

• 摘要按子问题展开，包含方法、模型、算法和关键结果。
• 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：负责证据门禁；本技能负责格式门禁，两者都通过后才可称为正式稿。