用途
Figure Results Review 用于在图表成为论文证据或会议材料之前,审查 ML/AI 结果图、图注、LaTeX 图包装文件与视觉风格。它处理的场景包括:用户提供图、绘图、结果截图、图注、结果段落或带有实验证据的幻灯片;论文将每张图存储为已渲染资源(如 figures/fig_name.pdf 或 figures/fig_name.png)以及 LaTeX 包装文件(如 figures/fig_name.tex);需要对照实际展示的证据检查论文主张;绘图可能缺少基线、误差棒、随机种子、标签、单位或公平性上下文;论文图表需要一致的视觉风格(配色、标记、符号、线宽、字体、尺寸与记号);出现新结果时需要判断更新写作、重跑实验、诊断失败还是收窄主张;rebuttal 需要简短的视觉答复;导师会议需要能让决策一目了然的图表。
该技能不用于从零设计实验(应先用 experiment-design-planner),不用于诊断结果为何异常或失败(应使用 result-diagnosis),也不用于证据已确认后仅做行文风格适配(应使用 conference-writing-adapter)。
主要能力
技能包含一套渐进加载的参考资料:claim-support.md、visual-integrity.md、statistical-evidence.md 始终阅读;paper-visual-style.md 与 style-memory.md 在面向论文、幻灯片、rebuttal、camera-ready 或目标会议改写时阅读;templates/visual-style.md 用于初始化 paper/.agent/visual-style.md;caption-and-narrative.md 用于修订图注、结果行文、幻灯片文字或论文图引用;report-template.md 用于撰写最终审查;memory-writeback.md 用于项目存在 memory/、组件 .agent/ 文件夹或用户要求持久化项目记忆时。
核心原则包括:图是特定主张的证据而非装饰;图包包含已渲染资源、LaTeX 包装文件、视觉描述、图注、正文引用与来源等独立层次;图描述与图注是不同产物,应先描述图像展示了什么,再解读其意义;每张图应回答一个审稿人问题;主要比较应能在视觉与数值上易于发现;图注必须提供足够设定以便脱离正文解读结果;正文引用应告诉读者应查看哪个视觉比较及其重要性;当主张依赖微小差异时,统计不确定性、随机种子与方差很重要;计算、数据、基线以及协议公平性在影响解读时必须可见;论文图应共享有意设计的视觉语言;视觉风格应作为记忆演进;漂亮但不支持主张的图应修改或删除;新结果必须更新主张、写作、审稿人风险与后续动作。
使用方式
技能按步骤执行。第一步恢复证据上下文,收集图文件路径、截图、原始数据、图注或结果行文,已渲染资源路径,LaTeX 包装文件路径,论文主张或章节,实验设定(数据集、模型、基线、指标、随机种子、划分、超参数、协议),绘图设定(变量、过滤、平滑、变换、坐标轴范围、配色、标注规则、聚合、代码/配置路径),目标受众,目标会议或基准预期,当前论文位置,以及关联的项目记忆 ID。并重写预期证据关系:“This figure is supposed to show that [claim] because [metric/comparison/trend] under [setup]。”如果无法写出该句,则先路由到 paper-evidence-board。
第二步解析图包:对论文图,通过共享文件名主干识别图包,检查已渲染资源与包装文件两层,以及附近论文源码中的 \input{} 或 \include{} 与正文引用方式。若包装文件缺少匹配资源或资源缺少包装文件,则标记图包不完整。
第三步先描述后解读:为每张图生成视觉描述,包括图类型与面板结构、坐标轴单位尺度与方向、方法数据集变量颜色标记与图例、可见趋势比较异常值与缺失值和不确定性、复现所需的绘图参数、解读结果所需的实验参数,以及直接可见与从日志、配置、文件名、图注或用户陈述推断的内容。视觉描述不放入论文图注,而作为审计记录。
第四步审计主张支持:对每张图回答其支持什么确切主张、展示证据是否充分、主张是否超出测量设定、是否缺少基线消融对照或诊断、是否与其他图或章节矛盾、结果属于主论文、附录、诊断还是不成熟,并赋予一种状态:supports-claim、supports-narrower-claim、ambiguous、contradicts-claim、diagnostic-only、not-ready。
第五步审计视觉完整性:检查坐标轴、标签、单位、尺度与变换,图例可读性与方法名,方法数据集指标与消融的排序,主要结果是否视觉显著,颜色、标记、线型或阴影在灰度下是否可读,图尺寸是否适合单栏、双栏、幻灯片或附录,图注与标签是否与实际绘图数据匹配,预期比较路径是否无需读者从多面板或图例推断即可显而易见,包装文件宽度、裁剪、子图顺序与标签是否匹配已渲染资源与视觉描述,以及包装文件是否造成局部空白、页底不稳定或脆弱换行。
第六步审计论文视觉风格(面向论文时):检查配色与色盲/灰度稳健性,方法到颜色与方法到标记的跨图稳定映射,线宽、标记大小、阴影、符号与记号一致性,字号、刻度密度、标签长度与最终栏宽可读性,图尺寸,视觉强调是否匹配论文主张层级,主方法是否不仅靠颜色即可识别,图中定理/方法符号是否匹配论文记号。若论文没有视觉风格政策,则从模板提出一份并记录。
第七步审计统计与实验证据:检查随机种子或重复次数、方差、置信区间、标准差或标准误,差异较小时显著性或效应量解释,数据划分与泄漏风险,指标定义与平均方式,基线公平性与调参预算,计算、硬件、模型规模、提示、数据或选择差异,效率主张时的计算或速度报告,应展示的失败案例或负面结果,以及绘图与实验参数是否可从图中恢复。
第八步审阅图注与结果叙述:为每张图产出视觉描述、来源摘要、图注与图像对齐诊断、图注诊断、修订后的图注或图注大纲、一句话论文引用、附近行文中应避免的主张、所回答的审稿人问题、需补充的缺失设定细节。
第九步路由修复:每个问题路由到一个或多个动作,包括 fix-wrapper、edit-figure、rewrite-caption、write-description、rewrite-results-text、define-visual-style、record-style-lesson、restyle-figure、build-result-asset、mine-existing-results、rerun、diagnose-result、baseline-audit、narrow-claim、move-to-appendix、cut,并指明合适的下一个技能。
第十步撰写审查报告:若无给定路径,保存至 docs/results/figure_results_review_YYYY-MM-DD_<short-name>.md,内容包含图清单、图包映射、视觉描述、绘图与实验参数来源、主张支持状态、视觉完整性问题、视觉风格政策与一致性问题、新风格经验或偏好转合同、统计证据问题、图注与叙述修复、审稿人风险预测、路由动作与下一技能、记忆更新部分。
第十一步写回项目记忆:更新最小必要条目集合,涉及 memory/evidence-board.md、memory/claim-board.md、memory/risk-board.md、memory/action-board.md、paper/.agent/ 下的图表映射与视觉风格文件、.agent/conference-writing/project-style.md、worktree .agent/worktree-status.md。使用确定性标签:verified(已对照原始数据、日志或源图核对的值)、user-stated(用户提供的上下文)、inferred(审稿人风险与叙述判断)、unverified(无法检查的视觉或统计主张)。
最后进行最终检查:每张图都有关联主张与审稿人问题,每张论文图在使用 figures/*.tex 的项目中都具有已解析的资源/包装文件图包。
适用场景
适用于论文图表审阅、结果截图检查、图注与结果叙述修订、论文视觉风格统一、rebuttal 视觉答复准备、导师会议图表准备,以及判断新结果应更新写作、重跑实验、诊断失败还是收窄主张。
限制
该技能不用于从零设计实验;不用于诊断结果为何异常、不稳定、负面或矛盾;不用于证据已接受后仅做行文风格适配。若无法检查实际图像,则只能审计提供的数据、图注或行文,并明确将视觉布局判断标记为未验证。若绘图惯例依赖目标会议、基准或近期论文风格,需用当前已接收论文、官方基准协议或用户提供的样例进行核实。