overflow-repair

Overflow Repair Skill

概述

本技能专门处理 Category D：溢出与对齐缺陷，包括：

• D1：Overfull hbox（段落文本、表格单元格、公式溢出栏宽）
• D2：长公式未合理断行
• D3：URL/长标识符溢出

该技能由 code-surgeon-agent 调用，执行对 .tex 源码的精确修改，以消除或缓解溢出问题。所有修复遵循 最小修改原则，不改变学术内容。

---

适用场景

当 layout-detective-agent 或 rule-engine-agent 报告中出现以下缺陷 ID 时，路由至本技能：

缺陷 ID	描述	优先级
D1	Overfull hbox（段落/表格/公式）	High
D2	长公式未断行	High
D3	URL/长标识符溢出	Medium

---

输入规范

输入项	来源	说明
主 .tex 文件路径	项目上下文	需修改的源文件
规则引擎报告	rule-engine-agent 输出	包含溢出位置（行号）、溢出量、对象
排版侦探报告	layout-detective-agent 输出	包含视觉确认的溢出页面和对象
当前编译日志	.log 文件	用于验证修复后溢出是否消除

---

输出规范

修改完成后，必须返回以下信息：

{
  "skill": "overflow-repair",
  "status": "success | partial | failed",
  "modified_files": ["main.tex", "tables/table1.tex"],
  "changes": [
    {
      "defect_id": "D1",
      "object": "Table 2",
      "action": "替换 tabular 为 tabularx，设置列宽比例",
      "before": "\\begin{tabular}{|l|c|c|}",
      "after": "\\begin{tabularx}{\\linewidth}{|l|X|X|}"
    }
  ],
  "unresolved": []
}

---

修复策略

策略选择流程

1. 根据日志和视觉报告定位溢出位置与类型（段落/表格/公式/URL）。
2. 按照下文各类型的修复策略依次尝试，从最不侵入的方案开始。
3. 每次修改后，通知 orchestrator-agent 触发重新编译以验证效果。
4. 若当前策略无效，回退并尝试下一策略。

---

D1：段落文本溢出

问题特征：

• 日志：Overfull \hbox (Xpt too wide) in paragraph at lines A--B
• 视觉：某行文本伸出右边界

修复策略（按优先级）：

1. 引入断词点
   在溢出单词的合适位置添加 \- 连字符，使 LaTeX 能在该处断行。

   % 修改前
   This is a verylongwordthatdoesnotbreak.
   % 修改后
   This is a very\-long\-word\-that\-does\-not\-break.
   

2. 调整段落级容差
   在段落前临时增加 \emergencystretch 或调整 \tolerance。

   {\emergencystretch=1em  % 允许额外拉伸 1em
    This is the problematic paragraph content...
   }
   

   注意：修改后需恢复默认值，避免影响全局。

3. 局部微调措辞（需 semantic-polish-agent 介入）
   若排版手段无法解决，可替换为稍短的近义词或调整语序。

   % 修改前
   the implementation of the proposed methodology
   % 修改后
   the implementation of our method