figure-results-review

图表结果审查

在图表成为论文证据或会议材料之前，审查图、绘图、标题和结果叙述。

在以下情况使用此技能：

• 用户提供了图、绘图、结果截图、图表标题、结果章节，或包含实验依据的幻灯片
• 论文将每张图保存为渲染后的资源，例如 figures/fig_name.pdf 或 figures/fig_name.png，并配有 LaTeX 包装文件，例如 figures/fig_name.tex
• 需要根据实际展示的证据核查论文中的主张
• 绘图可能缺少基线、误差条、随机种子、标签、单位或公平性背景
• 论文图表需要统一视觉风格：配色方案、标记、符号、线宽、字体、尺寸和符号表示
• 新结果需要决定是更新文字、重新运行实验、诊断失败，还是收窄主张
• 需要在 rebuttal 中给出简洁的可视化回答
• 导师会议需要通过图表清晰呈现决策

不要使用此技能从头设计实验。在有结果之前，请使用 experiment-design-planner。如果主要问题是结果为何出乎意料或出现故障，请使用 result-diagnosis。如果证据已获认可，主要任务是调整文字风格，请使用 conference-writing-adapter。

将此技能与以下技能搭配使用：

• 如果论文图表需要在视觉审查前根据 CSV 结果文件生成或重新生成，请使用 paper-result-asset-builder
• 如果图表审查发现缺失结果，且现有 CSV 可能已包含所需证据，请使用 paper-evidence-gap-miner
• 如果需要将图表与论文主张、章节、审稿人风险和行动关联起来，请使用 paper-evidence-board
• 如果绘图结果可疑、不稳定、为负或相互矛盾，请使用 result-diagnosis
• 如果视觉审查发现基线缺失、较弱或不公平，请使用 baseline-selection-audit
• 如果修复需要新实验、消融、对照或指标，请使用 experiment-design-planner
• 如果原始结果需要在图表审查前整理成结构化报告，请使用 experiment-report-writer
• 如果最终的图表叙述或视觉风格需要适配目标会议，请使用 conference-writing-adapter
• 如果主张、证据、来源、风险、行动或交接信息需要跨会话持久保存，请使用 research-project-memory

技能目录结构

<installed-skill-dir>/
├── SKILL.md
├── templates/
│   └── visual-style.md
└── references/
    ├── caption-and-narrative.md
    ├── claim-support.md
    ├── memory-writeback.md
    ├── paper-visual-style.md
    ├── report-template.md
    ├── statistical-evidence.md
    ├── style-memory.md
    └── visual-integrity.md

渐进式加载

• 始终阅读 references/claim-support.md、references/visual-integrity.md 和 references/statistical-evidence.md。
• 如果图表用于论文、幻灯片、rebuttal、定稿或特定会议的改写，请阅读 references/paper-visual-style.md 和 references/style-memory.md。
• 初始化 paper/.agent/visual-style.md 时，使用 templates/visual-style.md。
• 修改图注、结果正文、幻灯片文字或论文中的图表引用时，请阅读 references/caption-and-narrative.md。
• 撰写最终审查报告前，请阅读 references/report-template.md。
• 如果项目包含 memory/、组件级 .agent/ 文件夹，或用户要求保存持久项目记忆，请阅读 references/memory-writeback.md。
• 如果预期的绘图规范取决于目标会议、基准测试或近期论文的风格，请通过当前已录用论文、官方基准协议或用户提供的示例进行核实。
• 如果无法检查实际图像，请审查所提供的数据、图注和正文，并明确标记未经核实的视觉布局判断。

核心原则

• 图表是特定论点的证据，而非装饰。
• 图表包包含多个独立层：渲染素材、LaTeX 封装文件、视觉描述、图注、正文中的引用以及来源信息。
• 图表描述和图注是不同的内容。先描述图像展示了什么，再解释它为何重要。
• 每张图都应回答一个审稿人可能提出的问题。
• 主要对比应便于通过视觉和数值快速找到。
• 图注必须提供足够的实验设置信息，使读者无需查阅论文其他部分也能解读结果。
• 正文中的引用应告诉读者要查看哪项视觉对比，以及它为何重要。
• 如果论点依赖细微差异，统计不确定性、随机种子和方差就很重要。
• 如果计算量、数据、基线和协议的公平性会影响解读，就必须清楚呈现。
• 论文中的图表应采用统一且经过审慎设计的视觉语言。风格选择也是写作的一部分，因为它们会决定审稿人首先注意到什么。
• 视觉风格应随着经验不断演进：记录个别经验教训，将反复出现的偏好提升为项目约定，最后再将其归纳为可复用的技能规则。
• 如果一张图虽然精美，却无法支撑论点，就应修改或删除。
• 新结果必须推动论点、写作、审稿风险和后续行动的更新。
• 如果图表导致论文排版问题，应先定位受影响的页面和图表封装文件。优先采用局部封装文件、正文或位置调整，而不是全局浮动体间距或段落设置；更广泛的投稿排版问题应交由 submit-paper 处理。

第 1 步——还原证据上下文

收集：

• 图表文件路径、截图、原始数据、图注或结果描述
• 渲染素材路径，例如 figures/fig_name.pdf 或 figures/fig_name.png
• LaTeX 封装文件路径，例如 figures/fig_name.tex（如果论文使用封装文件）
• 该结果要支撑的论文论点或章节
• 实验设置：数据集、模型、基线、指标、随机种子、数据划分、超参数和协议
• 绘图设置：绘制的变量、筛选条件、平滑方法、变换、坐标轴范围、颜色映射、标注规则、聚合方式，以及可用时的代码或配置路径
• 目标受众：论文、导师会议、幻灯片、答辩、内部报告或附录
• 目标会议或基准测试的预期要求
• 当前论文中的位置（如有）
• 关联的项目记忆 ID，例如 CLM-###、EVD-###、FIG-###、TAB-###、RSK-### 或 ACT-###

重述预期的证据关系：

This figure is supposed to show that [claim] because [metric/comparison/trend] under [setup].

如果无法写出这句话，应先转到 paper-evidence-board，再润色图表。

第 2 步——核对图表包

对于论文中的图表，根据共同文件名前缀确定图表包：

figures/fig_name.pdf or figures/fig_name.png  # rendered asset
figures/fig_name.tex                          # LaTeX wrapper

在可用时检查两个层面：

• 渲染素材：读者实际看到的视觉内容
• .tex 封装文件：\includegraphics、宽度、位置、\caption{}、\label{}、子图布局、注释，以及素材文件名是否与预期图表一致
• 附近的论文源文件：封装文件通过何处 \input{} 或 \include{} 引入，以及正文如何引用该图表

如果封装文件存在但缺少对应素材，或素材存在但缺少封装文件，请标记该图表包不完整。如果存在多种素材格式，请确认封装文件引用的是哪一种。

步骤 3 - 解读前先描述

对于每张图，请先撰写视觉描述，再撰写或评判图注。

视觉描述应说明：

• 图的类型和子图结构
• 坐标轴、单位、刻度和方向
• 方法、数据集、变量、颜色、标记和图例
• 可见的趋势、比较、离群值、缺失值和不确定性
• 复现图中所示内容所需的绘图参数
• 解读结果所需的实验参数：数据集划分、模型/检查点、基线、指标、随机种子数量、采样预算、超参数、计算预算或协议
• 哪些内容是直接可见的，哪些是从日志、配置、文件名、图注或用户陈述中推断得出的

不要将完整的视觉描述放入论文图注中。将其作为审查记录，用于核实图注和论文正文是否忠实呈现了图中的内容。

步骤 4 - 审查主张是否有证据支持

阅读 references/claim-support.md。

针对每张图，回答：

• 它具体支持什么主张？
• 图中展示的证据是否足以支持该主张？
• 相对于测量设置，该主张是否过于宽泛？
• 是否缺少基线、消融、对照或诊断？
• 结果是否与其他图或章节矛盾？
• 该结果适合放在论文正文、附录、诊断材料中，还是尚未准备就绪？

分配一个状态：

• supports-claim
• supports-narrower-claim
• ambiguous
• contradicts-claim
• diagnostic-only
• not-ready

步骤 5 - 审查视觉完整性

阅读 references/visual-integrity.md。

检查：

• 坐标轴、标签、单位、刻度和变换
• 图例的可读性和方法名称
• 方法、数据集、指标和消融项的排序
• 主要结果在视觉上是否突出
• 在灰度模式下，颜色、标记、线型或填充线是否仍清晰可读
• 图的尺寸是否适用于单栏、双栏、幻灯片或附录
• 图注和标签是否与实际绘制的数据一致
• 无需读者从多个子图或图例中自行推断，是否也能清楚看出预期的比较路径
• 图形外层容器的宽度、裁切、子图顺序和标签是否与渲染后的图像及视觉描述一致
• 外层容器是否造成局部留白、页面底部布局不稳定或脆弱的换行行为；如果有，是否应在该图附近修复，而不是调整全局 LaTeX 设置

标记任何可能导致审稿人误读结果的问题。

步骤 6 - 审查论文视觉风格

当输出用于论文时，请阅读 references/paper-visual-style.md 和 references/style-memory.md。

检查：

• 配色方案，以及对色觉障碍和灰度模式的适用性
• 所有图中方法与颜色、方法与标记之间的映射是否一致且稳定
• 线宽、标记大小、填充线、符号和符号记法是否一致
• 字号、刻度密度、标签长度以及最后一列的可读性
• 图的尺寸是否适用于单栏、双栏、附录或幻灯片
• 视觉重点是否符合论文主张的层级
• 是否无需仅依赖颜色就能识别主要方法
• 图中的定理/方法符号是否与论文符号记法一致

如果论文没有视觉风格规范，请根据 templates/visual-style.md 提出一套方案，并在适当情况下将其记录到 paper/.agent/visual-style.md 或 .agent/conference-writing/project-style.md 中。

对于排版和最终尺寸，请检查约定，而非 Notebook 预览：

• 最终 LaTeX 插入宽度，例如 \columnwidth、\linewidth 或 \textwidth
• 生成图像的尺寸（英寸）
• 坐标轴标签、刻度标签、图例、注释和子图标签的字号（磅）
• LaTeX 对图像进行缩放时，是否会破坏预期的排版层级
• 在二者都存在时，代码侧的 plot_style.yaml 与论文侧的 visual-style.md 是否一致

如果发现风格问题，请先将其归类为 lesson、preference、project contract 或 reusable skill rule candidate，再将其记录回文件。

第 7 步 - 审查统计与实验依据

阅读 references/statistical-evidence.md。

检查：

• 随机种子数量或重复运行次数
• 方差、置信区间、标准差或标准误
• 差异较小时对显著性或效应量的解读
• 数据划分与数据泄漏风险
• 指标定义与平均方式
• 基线公平性与调参预算
• 计算资源、硬件、模型大小、提示词、数据或选择方面的差异；若省略这些差异，视觉比较可能产生误导
• 当主张涉及效率时，是否报告计算开销或速度
• 应展示的失败案例或负面结果
• 是否能从图表包装文件、图注、结果报告、日志、配置或论文正文中还原绘图参数和实验参数

如果图表缺少必要的不确定性信息，请决定是重新运行、添加误差线、弱化主张，还是将结果移至附录或标记为诊断性结果。

第 8 步 - 审查图注和结果叙述

当输出文本需要修订时，阅读 references/caption-and-narrative.md。

针对每张图，提供：

• 视觉描述
• 溯源摘要：渲染素材、包装文件 .tex、绘图参数、实验参数和来源确定性
• 图注与图像的一致性诊断
• 图注诊断
• 修订后的图注或图注大纲
• 一句式论文正文引述
• 邻近正文中应避免的主张
• 已回答的审稿人问题
• 需要补充的设置细节

图注不应夸大结论。应说明实验设置、比较对象、指标和要点。

第 9 步 - 分派修复任务

针对每个问题，分派一项或多项操作：

• fix-wrapper：figures/*.tex 中的素材路径错误、图注过时、标签不匹配、宽度／裁切／布局问题或缺少子图映射
• edit-figure：标签、顺序、比例尺、图例、布局或视觉强调问题
• rewrite-caption：实验设置、指标、要点、注意事项或主张一致性问题
• write-description：缺少视觉描述或溯源记录
• rewrite-results-text：论文邻近正文夸大结论或未能点明要点
• define-visual-style：缺少或不一致的论文视觉风格规范
• record-style-lesson：新增的排版、尺寸、图例、标记、颜色、导出或包装文件经验，应先追加到风格记忆中，再设为硬性规则
• restyle-figure：颜色、标记、线宽、字号、符号、面板布局或视觉强调问题
• build-result-asset：存在原始 CSV 证据，但需要生成带有溯源信息、面向论文的图表或包装文件
• mine-existing-results：图表缺少的证据可能已存在于 CSV 或报告中
• rerun：检查现有结果后，仍缺少随机种子、方差、基线、指标或实验规程
• diagnose-result：可疑、负面、不稳定或相互矛盾的模式
• baseline-audit：基线缺失或不公平
• narrow-claim：证据仅支持范围更窄的表述
• move-to-appendix：结果有用，但不足以成为论文主体内容
• cut：视觉内容无法满足论文需求

适当时，指出下一项技能。

第 10 步 - 编写审查报告

阅读 references/report-template.md。

如果要保存到项目中且未指定路径，请使用：

docs/results/figure_results_review_YYYY-MM-DD_<short-name>.md

报告必须包括：

• 图表清单
• 图表对应关系：渲染素材、包装文件 .tex、论文正文引述位置、标签
• 视觉描述
• 绘图参数和实验参数的溯源信息
• 主张支持状态
• 视觉完整性问题
• 视觉风格规范及一致性问题
• 新增的风格经验或从偏好升级为规范的内容
• 统计依据问题
• 图注和叙述修订
• 审稿风险预测
• 分派的操作及后续技能
• 记忆更新部分

步骤 11 - 写回项目记忆

如果存在记忆文件，请阅读 references/memory-writeback.md。

更新最少但有用的条目集：

• memory/evidence-board.md：图表证据状态、渲染资源、包装器 .tex、设置、绘图参数、实验参数及关联主张
• memory/claim-board.md：获得支持、范围缩小、受到反驳或尚未准备就绪的主张
• memory/risk-board.md：由视觉歧义、缺少不确定性信息、基线薄弱或过度主张带来的审稿风险
• memory/action-board.md：图表修改、重新运行、标题修正、结果诊断或主张修订
• paper/.agent/：图表映射、资源／包装器配对、论文中的位置、视觉描述、标题状态、溯源缺口及过时视觉警告
• paper/.agent/visual-style.md 或 paper/.agent/style-lessons.md：关于排版、尺寸、编码、导出和包装器行为的风格经验、偏好及项目约定
• .agent/conference-writing/project-style.md：启用会议适配时面向投稿场合的图表风格决策
• 工作树 .agent/worktree-status.md：结果生成或绘图任务及退出条件

使用以下确定性标签：

• verified：已对照原始数据、日志或源图核实的值
• user-stated：用户提供的上下文
• inferred：审稿风险和叙事判断
• unverified：无法检查的视觉或统计主张

最终检查

完成前：

• 每张图都有对应的主张和审稿问题
• 如果项目使用 figures/*.tex，每张论文插图都有已确定的资源／包装器组合
• 每张经过审查的图都有独立于标题的视觉描述
• 已记录绘图参数和实验参数，或明确标记为未知
• 主要对比易于查找
• 坐标轴、单位、图例、标题和标签均无歧义
• 论文中的颜色、标记、字体、符号和图表尺寸保持一致
• 风格经验已记录在正确的推广层级，未被默默提升为普遍规则
• 已体现不确定性，或已说明缺少不确定性信息的理由
• 在相关情况下，基线和计算资源公平性清晰可见
• 已收窄过度主张
• 已将修正分配为具体的后续行动或技能
• 如存在项目记忆，已更新