progress-report

---
name: progress-report
description: 写"进展汇报"类文档（读者是领导，要求一眼看懂"发现了什么问题→用了什么办法→效果如何"）。当用户要求写汇报、进展报告、阶段总结、把某个项目的进展整理成文、或给出素材要求生成汇报时使用。内置经用户定稿验证的写作规范、配图规则（结果配轨迹图/训练图，没数据就自造结构图/示意图）、Word 排版规范和 python-docx/matplotlib 生成模板。
---

# 进展汇报写作技能

## 适用场景

- 用户要求把某个项目的进展写成汇报/报告（读者是领导，不是同行评审）
- 手头有素材（记忆文件、日志、聊天记录、代码库、交付文档），需要成文
- 输出通常是一份 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 需替换为等效字体名）