consistency-polisher

Consistency Polisher Skill

概述

本技能专门处理 Category C：排版一致性缺陷，包括：

• C1：表格字号不统一（\resizebox 滥用导致字号参差）
• C2：图片分辨率/风格不一致
• C3：Caption 格式不统一

该技能由 code-surgeon-agent 调用，通过对表格字号、图片尺寸策略、标题格式的统一化处理，消除全篇排版风格割裂，使论文呈现出专业、一致的视觉形象。

一致性缺陷通常不致命，但严重影响审稿人对论文专业度的第一印象。本技能的目标是建立并强制执行全篇统一的排版规范。

Source-changing 边界：本技能默认只生成一致性 repair plan、风险和 approval 状态；只有显式 --apply 或宿主等价授权存在时才写回 .tex。多轮一致性修复必须同时显式启用 --apply --max-rounds N，并由 runtime 的 carry-forward、freshness、candidate gate、round lineage 和 gatekeeper 决策放行。

---

适用场景

缺陷 ID	描述	优先级	是否自动修复
C1	表格字号不统一	Medium	是
C2	图片分辨率/风格不一致	Low	否（仅诊断并建议）
C3	Caption 格式不统一	Medium	是

---

输入规范

输入项	来源	说明
主 .tex 文件路径	项目上下文	需修改的源文件
排版侦探报告	layout-detective-agent 输出	包含 C 类缺陷的具体描述
模板信息	templates.yaml 或上下文	会议/期刊模板的字号、栏宽等默认参数

---

输出规范

{
  "skill": "consistency-polisher",
  "status": "success | partial | failed",
  "modified_files": ["main.tex", "tables/experiments.tex"],
  "changes": [
    {
      "defect_id": "C1",
      "object": "Table 2",
      "action": "移除 \\resizebox，改用 tabularx 并统一使用 \\small",
      "before_snippet": "\\resizebox{\\linewidth}{!}{\\begin{tabular}{...}",
      "after_snippet": "{\\small\\begin{tabularx}{\\linewidth}{...}}"
    }
  ],
  "suggestions": [
    {
      "defect_id": "C2",
      "object": "Figure 5",
      "message": "图片分辨率过低（72 DPI），建议替换为至少 300 DPI 的矢量图或高分辨率位图"
    }
  ],
  "unresolved": []
}

---

修复策略

通用原则

1. 建立风格锚点：从全篇中自动识别或由用户指定一个“最佳实践”表格/图片/Caption 作为模板，其余向它看齐。
2. 最小破坏：修改仅限于样式层面，不改变表格内容、图片信息或标题文本。
3. 模板优先：若会议/期刊模板提供了官方样式文件，优先遵循模板预设，而非自定义样式。

---

C1：表格字号不统一

问题特征：

• 不同表格使用了差异明显的字号（如一个 \small，另一个 \tiny）。
• 使用 \resizebox{\linewidth}{!}{...} 整体缩放表格，导致文字被非线性缩放而变形，且与其他表格字号不一致。

修复策略（按优先级）：

策略 1：移除 \resizebox，改用 tabularx 自适应宽度

\resizebox 是表格一致性的头号杀手，必须无条件移除。

% 修改前
\begin{table}
\centering
\resizebox{\linewidth}{!}{
  \begin{tabular}{|l|c|c|c|}
  \hline
  Method & Metric1 & Metric2 & Metric3 \\
  \hline
  Ours & 95.2 & 87.3 & 78.1 \\
  \hline
  \end{tabular}
}
\caption{Results}
\end{table}

% 修改后
\begin{table}
\centering
\small  % 统一字号
\begin{tabularx}{\linewidth}{|l|X|X|X|}
\hline
Method & Metric1 & Metric2 & Metric3 \\
\hline
Ours & 95.2 & 87.3 & 78.1 \\
\hline
\end{tabularx}
\caption{Results}
\end{table}