table-results-review

表格结果审查

在独立论文表格成为论文证据、会议材料或 rebuttal 材料之前，对其进行审计。

在以下情况下使用此技能：

• 论文将表格存储为独立文件，例如 tables/results.tex，并通过 \input{tables/results} 将其插入各个章节
• 用户有基准测试、消融、速度、模型规格、指标定义、oracle、合理性检查或附录表格
• 表格标题可能与表格内容不符
• 行列含义、指标方向、加粗规则、脚注或缺失值不明确
• 表格中的数值需要溯源：结果 CSV、日志、配置、随机种子、聚合方式、舍入或手动编辑
• 论文中的某项主张依赖表格证据

不要将此技能用于渲染后的图形资源或绘图样式。对于 figures/*.pdf、figures/*.png 和 figures/*.tex 图形包，请使用 figure-results-review。当主要任务是将整篇论文中的许多图表与主张关联起来时，请使用 paper-evidence-board。

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

• 当面向论文的表格需要在审查前根据结果 CSV 文件生成或重新生成时，使用 paper-result-asset-builder
• 当表格审查发现缺少比较、切片、方差或基线，且现有 CSV 可能已包含相关数据时，使用 paper-evidence-gap-miner
• 当表格需要与论文主张、章节、审稿风险和行动关联起来时，使用 paper-evidence-board
• 当比较表可能遗漏重要基线或采用不公平设置时，使用 baseline-selection-audit
• 当表格数值异常、不稳定、为负或相互矛盾时，使用 result-diagnosis
• 当表格暴露出缺少对照、随机种子、指标或消融时，使用 experiment-design-planner
• 当原始日志需要在表格审查前整理成结构化报告时，使用 experiment-report-writer
• 当最终表格说明或紧凑程度需要符合目标会议要求时，使用 conference-writing-adapter
• 当主张、证据、溯源、风险、行动或交接信息需要跨会话保留时，使用 research-project-memory

核心原则

• 表格是针对特定主张的证据，而不是数字的堆砌。
• 表格包包含不同层次：独立的 .tex 源文件、表格描述、标题、正文中的引用和溯源信息。
• 表格描述与表格标题是不同的内容。先描述表格报告了什么，再解释其重要性。
• 读者应能清楚看出行列分组所呈现的比较路径。
• 如果比较路径不明显，应优先重复列出关键基线、分组列或添加简短说明，而不是迫使读者自行推断预期的比较方式。
• 加粗、下划线、箭头、缺失值和脚注都必须有明确规则。
• 数值溯源很重要。记录数值的来源、聚合方式、舍入方式，以及是否经过手动编辑。
• 出色的表格标题应说明设置、比较、指标、关键参数和结论，同时避免写成完整的实验报告。
• 当表格导致论文排版问题时，先定位受影响的页面和表格源文件。优先局部调整表格、正文或位置，避免全局修改浮动体间距或段落设置；更广泛的投稿排版问题应交由 submit-paper 处理。
• 右侧环绕表格属于排版对象，不是普通浮动表格。不要在 wraptable 内嵌套常规 table 浮动体；应使用带有局部标题和标签处理的行内区块，然后通过视觉迭代调整环绕行数、宽度、字号、\tabcolsep 和小幅局部 \vspace。

第 1 步 - 恢复表格上下文

收集：

• 独立表格路径，例如 tables/results.tex
• 插入该表格的论文小节，使用 \input{tables/results} 或等效方式
• 当前标题、标签和正文引用
• 预期的论文主张或审稿人问题
• 表格用途：主要结果、消融实验、基线比较、速度／计算、模型规格、指标定义、预言结果、健全性检查或附录细节
• 实验设置：数据集、划分、模型／检查点、基线、指标、随机种子、采样预算、超参数、计算预算、协议
• 表格生成设置：源 CSV／日志／报告、聚合规则、行／列选择、排序、加粗规则、舍入规则、缺失值约定和手动编辑
• 关联的项目记忆 ID，例如 CLM-###、EVD-###、TAB-###、RSK-### 或 ACT-###

重写预期的证据关系：

This table supports [claim] by showing [comparison/ranking/trend/tradeoff] under [setup].

如果无法写出该句子，请先转到 paper-evidence-board，再润色表格。

第 2 步 - 解析表格包

对于论文表格，确定独立源文件：

tables/table_name.tex

检查：

• 表格环境：table 或 table*
• 表格结构：tabular、tabularx、longtable、booktabs、resizebox、small 或自定义宏
• \caption{}、\label{}、脚注、箭头、粗体／下划线、行组、列组和缺失值
• 数值是手动输入、由宏生成，还是从脚本导入
• 附近的论文源文件：表格在哪里被引入，以及正文如何引用它

如果缺少标题、标签、正文引用、来源出处或明确的加粗／舍入／缺失值规则，则标记表格包不完整。

第 3 步 - 先描述，再解读

在评判标题之前，先撰写表格描述。

表格描述应说明：

• 表格用途和论文位置
• 行组、列组、指标、单位和方向性
• 比较路径：读者应先比较哪些行／列
• 突出显示的数值以及加粗／下划线规则
• 缺失值、脚注、注意事项和小数精度
• 可见模式：最佳方法、最强基线、权衡、消融趋势、失败案例或不一致之处
• 解读数值所需的实验参数
• 关键数值的来源（如有），以及哪些内容是手动输入、哪些是自动生成
• 哪些信息可直接看到，哪些是根据日志、配置、文件名、标题或用户陈述推断得出

不要把完整的表格描述写进标题。将其作为审查记录，用来核对标题和论文正文是否忠实反映表格。

第 4 步 - 审查主张的证据支持

对于每个表格，请回答：

• 它支持的确切主张是什么？
• 该表格足以支持该主张吗？
• 相较于实测设置，该主张是否过于宽泛？
• 是否缺少基线、消融实验、控制组、随机种子或指标？
• 该表格是否与其他图、表或章节矛盾？
• 该表格属于论文正文内容、附录内容、诊断材料，还是尚未就绪？

分配以下状态之一：

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

步骤 5 - 审核表格完整性

检查：

• 行和列是否符合读者的比较路径
• 主要方法和核心基线是否易于比较
• 是否通过箭头或文字标明指标方向
• 是否定义了加粗和下划线规则，且不会造成误导
• 小数精度是否符合指标噪声水平
• 缺失值和失败的运行是否有脚注说明
• 是否在相关时列出计算量、参数量、数据或 NFE 列
• 主要结果和消融实验是否混排，造成混淆
• 附录表格是否隐藏了重要比较
• 标题、标签、行列名称和论文中的引用是否与表格来源一致
• 表格位置是否依赖页面边界附近不稳定的换行行为；[H] 仍可能留下垂直间距，因此在更改全局设置前，应先调整表格内部或周围的局部空白
• 对于 wraptable 布局，可选行数 [N]、宽度、标题高度、字号和 \tabcolsep 是否记录为局部布局选择，而非没有解释的魔法常数

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

步骤 6 - 审核统计与实验依据

检查：

• 随机种子或重复运行的数量
• 差异较小时的方差、置信区间、标准差或标准误
• 指标定义和聚合方式
• 数据划分和数据泄漏风险
• 基线的公平性和调参预算
• 可能影响比较解读的计算量、硬件、模型大小、数据、提示词或选择差异
• 效率属于论点一部分时，是否报告计算量或速度
• 表格生成参数：源文件、筛选、聚合、排序、舍入、加粗、缺失值约定和手动编辑

如果表格缺少必要的不确定性信息或来源信息，应判断是重新运行、添加列或脚注、弱化论点，还是将表格移至附录或标记为诊断用途。

步骤 7 - 审查标题和结果叙述

对每个表格，提供：

• 表格描述
• 来源摘要：表格 .tex、源数据/日志/配置/报告、表格生成参数、实验参数以及来源确定性
• 标题与表格是否一致的诊断
• 标题诊断
• 修订后的标题或标题大纲
• 一句式论文引用
• 附近正文中应避免的论点
• 已回答的审稿人问题
• 应补充的设置细节

标题格式：

[What the table reports.] We compare [methods] on [task/dataset] using [metrics; direction] under [key experiment parameters].
[Grouping or fairness detail.] [Takeaway tied to the claim]. Bold marks [bolding rule].

对于模型规格、指标定义或方法比较表格：

[What the table defines or compares.] Columns summarize [fields] used in [paper section or experiment].
[Interpretive note.] [Takeaway tied to the claim or reader task].

不要在标题中列出所有超参数。只需包含解读论点所需的参数。完整来源信息应放在审查报告、附录、制品或 paper/.agent/ 记录中。

步骤 8 - 分派修复任务

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

• fix-table-wrapper：tables/*.tex 中的标题过时、标签不匹配、加粗规则不清、缩放错误、脚注损坏或行列不匹配
• edit-table：分组、小数位数、加粗、脚注、缺失值、行列顺序或指标箭头
• rewrite-caption：设置、指标、结论、注意事项、加粗规则或论点一致性
• write-description：缺少表格描述或来源记录
• rewrite-results-text：附近的论文正文夸大了结论或遗漏了要点
• build-result-asset：已有原始 CSV 证据，但需要通过有文档记录的聚合、舍入和来源信息生成论文用表格
• mine-existing-results：缺失的比较、切片、方差或基线可能已存在于 CSV 或报告中
• rerun：检查现有结果后，仍缺少随机种子、方差、基线、指标或实验协议
• diagnose-result：可疑、负面、不稳定或矛盾的数值
• baseline-audit：缺少基线或基线不公平
• narrow-claim：证据只支持更小范围的表述
• move-to-appendix：内容有用，但不足以列入论文正文
• cut：表格无法满足论文需求

适当时指出下一项技能。

步骤 9 - 编写审查报告

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

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

报告必须包括：

• 表格清单
• 表格关联图：源 .tex、输入位置、标签、标题、论文中的引用位置
• 表格说明
• 表格生成和实验参数的来源记录
• 主张支持状态
• 表格完整性问题
• 统计证据问题
• 标题和叙述修正
• 审稿人风险预测
• 分派的操作和后续技能
• 记忆更新部分

步骤 10 - 回写项目记忆

如果存在记忆，请更新最小且有用的一组条目：

• memory/evidence-board.md：表格证据状态、源 .tex、设置、表格生成参数、实验参数和关联主张
• memory/claim-board.md：已获支持、范围已收窄、遭到反驳或尚未准备好的主张
• memory/risk-board.md：由表格歧义、缺少不确定性、基线薄弱、缺少来源记录或过度主张导致的审稿人风险
• memory/action-board.md：表格编辑、重新运行、标题修正、结果诊断、基线审计或主张修订
• paper/.agent/：表格映射、源文件/输入配对、论文位置、表格说明、标题状态、来源记录缺口和过时表格警告
• 工作树 .agent/worktree-status.md：结果生成或表格生成任务及退出条件

使用以下确定性标签：

• 对照原始数据、日志、生成的表格或论文文本核验过的值，标记为 verified
• 用户提供的上下文，标记为 user-stated
• 关于审稿人风险和叙述的判断，标记为 inferred
• 无法检查的数值或统计主张，标记为 unverified

最终检查

完成前：

• 每个表格都关联了一个主张和一个审稿人问题
• 如果项目使用 tables/*.tex，每个论文表格都有已解析的独立源文件
• 每个经过审查的表格都有与标题分开的表格说明
• 已记录表格生成参数和实验参数，或明确标记为未知
• 行/列含义和指标方向明确无歧义
• 加粗、下划线、脚注、舍入和缺失值均有相应规则
• 已提供不确定性，或已说明缺少不确定性的理由
• 适用时，基线和计算资源公平性清晰可见
• 已收窄过度主张
• 已将修正分派为具体的后续操作或技能
• 如存在项目记忆，已完成更新