Figure Forge

---
name: figure-forge
description: 投稿级图表生产规范。当用户要求把分析结果画成论文/投稿用图、按期刊规格调整图（尺寸/分辨率/字体）、或把探索性草稿图升级为投稿质量时使用。先立一句话论点契约，再按数据形态选图型、按期刊规格出图。全部图由可复现脚本生成，禁止手工改图。
outputs: [figures/]
provides: [figure-forge]
---

# 投稿级图表生产（figure-forge）

本技能规定「数据 → 可复现脚本 → 投稿规格图表」的生产规范：先立论点再选图型，把图画到目标期刊能收的规格。规则分两层：数据忠实类是 correctness，不可被风格理由推翻；其余是风格默认，用户可显式覆盖。

## 何时使用

- 用户要求把 results/analysis 的数字画成论文用图，或把 EDA 草稿图升级为投稿质量
- 用户给出目标期刊/会议的图表要求，要求逐条适配
- 科研论文/毕业论文流水线中「结果分析」「实验与结果」步骤的出图环节
- 示意图/机制图不在本技能射程：可产 TikZ 骨架，但必须标 [MANUAL] 由人工在 draw.io/Illustrator 完成，不冒充投稿级产出

## 操作规范

### 1. 画图先立约（每张图动手前）

- 先写一句话论点（这张图要让读者相信什么）；写不出就停下来问/报，不动笔；
- 每个 panel 对应一个论证问题；重复旁证的 panel 删掉或合并；
- 能用一句话说清的数据（1-2 个数字）不画图；简单排名优先考虑表格；
- 按科学论点规划图，不按来源表格一表一图。

### 2. 数字出处先行（correctness）

- 画图用的数据必须来自项目内的结果文件（`results/summary.md`、`analysis/` 或产物目录），脚本从文件读数，**不把数字手抄进代码**，更不得为美观调整数据；
- 数据文件缺失时停止并说明，不虚构示例数据冒充结果；
- 摘要统计量与 CI 定义以 stats-check 记录为准，图中误差棒定义与正文一致；
- 任何数据排除都记录前后条数、规则、原因；被排除的行要么消失，要么空心/斜纹标记并在图例点名，绝不进汇总统计；
- 配对设计画配对差值，不只叠边际分布；大点云用 hexbin 或带声明规则的聚合，不为好画减数据。

### 3. 选图型（数据形态 → 图型）

- 时序 → 折线；N 方法 × M 基准 → 分组柱；单指标多方法排名 → 横向条；两连续变量 → 散点；方阵 → 热图（≤200 格逐格印数）；占比 → 堆叠条（避免饼图）；
- 分布对比按 n：小 n 抖动散点+中位线，大 n box/violin，均值即信息时 bar+原始点；
- 反模式三条：对数轴禁实心柱（用点+中位线）；空槽标 n.d./—，不得看似 0；误差棒与原始点叠加二选一。

### 4. 期刊规格适配

目标期刊有图表要求（作者指南）时逐条核对；无明确要求时按通用投稿规格：

- **物理尺寸**：单栏图宽约 8-9 cm、双栏约 17-18 cm，按目标版式设 figsize，不靠缩放凑；
- **分辨率**：位图元素 ≥ 300 dpi（照片/热图类 600 dpi 更稳）；
- **字体字号**：成稿字号下限 5 pt、常规 7-9 pt，全图统一字族；默认嵌入字体，目标期刊要求可编辑文字（如 Nature 系）时不转曲；
- **线宽与标记**：坐标轴/数据线 ≥ 0.5 pt，标记点在成稿尺寸下可分辨；
- **格式**：主交付写入 `figures/` 的 SVG 或 PNG（要进 git，下一步初稿才能读到）；投稿用 PDF/EPS 副本写入本工作区 `output/figures/`（`*.pdf` 被 git 忽略，评审合并后自动进项目根同名目录）。含连续色调的位图部分用 PNG；
- **高频规格速查**：Nature 系单栏 89 mm/双栏 183 mm/高 ≤170 mm、面板字母 8 pt 粗体小写；ML 会议 ICML 3.25/6.75 in、NeurIPS/ICLR 5.5 in。速查与目标期刊当年作者指南冲突时，以指南为准。

### 5. 可读性与一致性

- 配色色盲友好（避免红绿对比，可用 Okabe-Ito 调色板）；黑白打印下仍可区分（辅以线型/标记差异）；
- 坐标轴标物理量与单位；图例不遮数据；投稿场景标注用英文；数值有效数字与正文表格一致；
- **颜色 threading**：同一实体（方法/条件）在全图所有 panel 同色；红绿只作涨跌方向注释，不作系列身份色；
- **hero 原则**：本文方法/主结果视觉显著（饱和色/粗线），基线退为灰；多 panel 图一主多从，不做等大阵列；
- **论断式标题**：默认进图注不进图内；图注中的论断必须对每行数据成立，否则加限定语（"3/4 基准上"）或降级为描述；
- 图注自含：n=、误差棒定义、排除理由写进图注，不堆在图上；专有名词保持原始大小写（XGBoost 等），禁自动 title-case。

### 6. 脚本与文件组织

- 出图脚本放 `figures/`（或 `analysis/figures/`），一图一函数，设 `main()` 入口，从 `main` 重跑产出相同图片；
- 路径集中为模块顶部常量；风格参数（字号/配色/线宽）集中定义，全部图共享；
- 输出文件命名与正文引用一一对应（如 `fig2-ablation.pdf`）；临时中间稿可清理；已接受/发布图按版本留存，新版本不静默覆盖旧证据；
- 输出文件名与 TASK.md/提货单登记的引用名逐一对账，对不上即报。

## 交付前复查（两层）

- **机械层**：脚本自检无文本重叠、不出图框、字号达标（bbox 两两重叠检测可写 10 行内），不通过则修到通过；
- **感知层**：agent 读图不可靠，导出最终物理尺寸 PNG 供人工过目；复查结论逐图一行写进 `figures/README.md`，视觉项标注「待人工确认」，不假装已目验。

## 完成标准

每张图可由脚本一键重出；规格符合目标期刊要求（或通用规格）；机械层检查全过，感知层已提交人工评审；数据未经任何手工改动。

- 写作约定：不使用彩色 emoji；强调标记用「注意：」或单色 ⚠（U+26A0 U+FE0E）。

---

理念参考：figure-style/figure-composer（Anthropic Claude Science，Apache-2.0，经 TTTPOB 提取镜像与 wanshuiyin 转述交叉验证）、Yuan1z0825/nature-skills（Apache-2.0）、Orchestra-Research/AI-Research-SKILLs（MIT）、caylent/tufte-data-viz（MIT）；内容为按 Ccode 科研工作流重写。

## 证据与版本约束

一句话论点只能总结已验收证据，不是先定故事再挑数据。描述性/探索图可直接说明现象和不确定性，无需强凑正向结论。图表须能追溯到数据/规则/代码版本与生成命令，正文、误差、样本单位、颜色和轴范围不夸大差异；最优值不等于显著或重要。上游数据/分析改变后重生成并核验，禁止复用失效图。