进展汇报写作技能

适用场景

• 用户要求把某个项目的进展写成汇报/报告（读者是领导，不是同行评审）
• 手头有素材（记忆文件、日志、聊天记录、代码库、交付文档），需要成文
• 输出通常是一份 Word（.docx）文档

写作规范（逐条遵守）

结构

1. 标题：××进展汇报（起止日期）
2. 总览：3~4 句。一句话项目定位 ＋ 现在的关键数字 ＋ 本期做了什么 ＋ 当前状态
3. 按时间分节。每节两行小标题，都加粗：
   • 第一行：日期（如 10月2日、10月3日、6日）
   • 第二行：版本号或阶段主题（如 Model-v12/v13、程序化自动采集）
4. 每节骨架（顺序固定）：
   • 问题：（或 上一版本问题：）——大白话，一眼切中，附关键数字
   • 做法——编号列出（1. 2.，不要用 ①）；每项 = 专业术语标签 ＋ 白话解释
   • 结果：——关键数字 ＋ 诚实短板（泄露就说泄露、不可接受就说不可接受、点破根本原因）
5. 新旧对比一律用左右对照表：引导语 新旧数据对比： 新旧模型对比： 新旧方法对比： 加粗，左边旧、右边新
6. 关键决策要点破动机和本质（为什么做、解决什么根本问题），方法可以专业、目的要简单
7. 删繁就简：砍掉操作细节和次要事故，全文控制在一到两页；结尾一句话收尾：后续，……。（加粗）
8. 块与块之间空一行：总览之后、每个日期/主题标题之前、每张表之后、图（含题注）前后、结尾句之前。同一块内部（问题/做法/结果连着写、标签行与紧随其后的表）不空

语言

• 问题、效果用大白话；方法可以用专业术语（术语当标签，后面跟白话解释）
• 不写“为便于”“如下所示”“综上所述”这类汇报套话
• 不粉饰：失败、泄露、不达标的数字如实写进结果

图表规则（什么时候上图）

1. 结果必须配图——凡"结果/效果"类内容，优先用图说话，比数字直观：
   • 轨迹/路径类结果 → 轨迹对比图（预测 vs 真实，标注关键分歧时刻）
   • 模型训练 → 训练过程图（loss 或关键指标随轮次的变化曲线）
   • 仿真/演示类 → 仿真截图或渲染图（有则上）
   • 数据类 → 数据分布 / 覆盖统计图
2. 对比选最顺的载体：数字对比用左右对照表；结构/流程对比用并列框图（左旧右新）
3. 没有现成数据就自己画（每个汇报至少值得配一张图）：
   • 模型/系统结构 → 框架图（模块方框＋箭头）
   • 方法本质讲不清 → 示意图（例：把"旧分格 vs 新分段"画成同一条速度曲线，上图颜色乱跳、下图切出干净几段）
   • 画图优先用真实数据；没有真实数据就用示意数据，图注必须标注"示意图"，不许拿假数据冒充真实结果
4. 位置与格式：图紧跟它所说明的那一小节（"做法"或"结果"段之后）；图独占一块（前后空行）；居中；下方一行图注 图N　说明
5. 图要能独立读懂：坐标轴带单位、有图例、标关键数字；中文标注；黑白打印也能分辨（实线/虚线/不同灰度）
6. 生成方式：用 matplotlib 脚本画（模板见 scripts/figure_examples.py），保存到工作目录的 汇报图/ 文件夹再插入

排版规范（没有原始模板时）

• 中文只宋体、西文只 Times New Roman；全部五号（10.5pt）
• 单倍行距、首行缩进（两字符 = 21pt）、两端对齐
• 颜色只用黑色
• 只有标题行（大标题/日期行/主题行/表格引导语/结尾句）加粗，正文不加粗
• 表格用最简网格（Table Grid），表头加粗
• 图居中，下方一行图注

生成方式

用附带脚本 scripts/make_report_docx.py（基于 python-docx）：

1. 把脚本复制到工作目录，编辑文件顶部的输出路径和结尾"内容区"（按上面的结构填内容）
2. 运行 python make_report_docx.py，生成 .docx

脚本内置 set_font / fmt / para / heading / table / figure / blank 助手，排版已按上面的规范预设好。

交付前检查清单

• 每节是否都是 问题 → 做法 → 结果？
• 结果/效果处有没有配图？没有真实数据时有没有补结构图/示意图（并标注"示意图"）？
• 对比处是否用了左右对照表（左旧右新）？
• 结果里有没有省掉短板和坏消息？
• 空行位置是否符合"块与块之间空一行"？
• 字体/字号/行距/缩进/对齐/颜色是否与排版规范一致？
• 全文是否控制在一到两页？

依赖

• Python 3.9+，pip install python-docx
• 中文字体：宋体、Times New Roman（Windows 自带；macOS/Linux 需替换为等效字体名）