paper-figure-pipelinelisted
Install: claude install-skill wyzz973/paper-figure-pipeline
# 论文插图全流程
把一个项目的数据和结果变成一整套论文插图:
- 图型从题目和数据里来;
- 风格全篇统一;
- 每张图单独成文件,可以随数据重画;
- 每张图都配有可直接写进论文的说明。
本 skill 整理自一次完整的建模竞赛论文作图实践(三个子问题、一百六十余张图),当时用户的纠正都写进了下面的原则。下文 `<skill>` 指本 skill 所在目录(加载时给出的 Base directory)。
## 核心原则
1. **从题目和数据出发。**
- 图型由两件事决定:这一问要论证什么,数据长什么样。
- 不参考项目里已有的图,已有图会框住思路。
- 不为了新颖而用不合适的图。
2. **原始数据必须看。**
- 原始附件(音视频、原始特征、原始表格)能揭示处理后结果里看不到的问题。
- 原始数据也常常就是题目要求展示的对象。
3. **数值全部由代码从数据实时计算。**
- 代码和文档里都不手抄结果数字,数据变了重跑即可。
- 关键数值随图写进 `stats.json`,说明文档从那里取数。
4. **一图一文件,候选全画。**
- 每张图单独导出 PNG(300 dpi)和 PDF(矢量,嵌入字体),不拼子图,由用户自己拼版。
- 所有候选图型都画出来供用户挑选。
5. **每种视觉编码都能在图上读懂。**
- 需要说明的编码:颜色、标记、线型、纹理、高亮带、参考线、区间符号。
- 说明方式三选一:图例、直接标注、坐标轴刻度标签。
- 色条要写量名和单位。
6. **必须逐张看图。**
- 自动检查只能抓到一部分问题。
- 实际项目中,用户发现的缺图例和间距瑕疵,当时的自动检查一条都没报。
7. **口径如实。**
- 区间跨 0、选择偏差、没有真值、估计值而非测量值,这些都要写进说明和图注。
- 不夸大结论。
## 按需求选入口
| 用户要的 | 从哪里开始 |
|---|---|
| 给论文成套画图(全部或某几问) | 第 1 步起走完整流程 |
| 指定了要画哪几张图 | 第 1 步看数据,跳过候选清单;配色还没定时按第 2 步的配色部分定稿;没有工程就从第 3 步搭,已有工程直接第 5 步;第 4 步的确认照做 |
| 检查、修复已有的图(排版、间距、图例) | 第 6 步和第 8 步,按 `references/qa-checklist.md` 查 |
| 换配色或字体 | 第 2 步的配色部分 → 改 `style/` → 全量重画 → 第 6 步 |
| 数据更新后重画 | 见文末“数据变了怎么办” |
## 流程总览
🔸 表示在这一步停下来,等用户回复后再继续。其他步骤直接做,长任务中途用一句话报进度。
| 步骤 | 做什么 | 产出 | 确认 |
|---|---|---|---|
| 1 | 读题、看数据、定口径 | 每问“数据特征要点” | 🔸 有多版结果时,确认正式版本 |
| 2 | 候选图清单、配色方案与样张 | `候选图清单.md`、配色样张 | 🔸 定稿 |
| 3 | 搭绘图工程 | `绘图/` 工程,环境检查通过 | |
| 4 | 每问先画 3–5 张代表图 | 代表图 | 🔸 确认风格 |
| 5 | 按顺序画全部候选图 | 全部图与 stats.json | |
| 6 | 自动检查,逐张看图 | 零告警,看图通过 | |
| 7 | 写图表说明 | 总索引、分问逐图说明