template-migrator

Template Migrator Skill

概述

本技能专门处理 Category E：跨模板迁移缺陷，包括：

• E1：单栏↔双栏图表尺寸失配
• E2：页数预算不匹配（如 9 页→14 页的内容重分布）
• E3：模板特定宏兼容性

该技能由 code-surgeon-agent 在 /migrate-template 命令触发时调用，负责将一篇论文从原模板平滑迁移至目标模板，并自动适配图表尺寸、页数预算和宏包兼容性。这是 PaperFit 最具差异化价值的能力，直接解决了科研工作者切换会议投稿时的真实痛点。

适用场景

缺陷 ID	描述	优先级	是否允许语义修改
E1	单栏↔双栏图表尺寸失配	Critical	否
E2	页数预算不匹配	Critical	是（最后手段）
E3	模板特定宏兼容性	Critical	否

输入规范

输入项	来源	说明
主 .tex 文件路径	项目上下文	需修改的源文件
目标模板名称	用户命令参数	如 ECCV2024、ICLR2025
模板配置	config/templates.yaml	包含目标模板的栏数、默认字号、页宽、预期页数等
原模板信息	自动检测或用户指定	当前 \documentclass 及主要宏包
排版侦探报告	layout-detective-agent	迁移后首次编译的 E 类缺陷列表

输出规范

{
  "skill": "template-migrator",
  "status": "success | partial | failed",
  "modified_files": ["main.tex", "figures/fig1.tex"],
  "changes": [
    {
      "defect_id": "E1",
      "object": "Figure 1",
      "action": "单栏图改为跨栏图",
      "before": "\\begin{figure}\n\\includegraphics[width=\\linewidth]{fig1.pdf}\n\\end{figure}",
      "after": "\\begin{figure*}\n\\includegraphics[width=\\textwidth]{fig1.pdf}\n\\end{figure*}"
    }
  ],
  "macro_fixes": [
    {
      "issue": "\\theoremstyle undefined in ECCV",
      "fix": "改用 \\newtheorem 直接定义"
    }
  ],
  "unresolved": [],
  "page_budget_status": {
    "current_pages": 9,
    "target_pages": 14,
    "gap": 5,
    "action_taken": "触发 adjust-length 子流程"
  }
}

迁移流程

第一步：加载模板配置

1. 从 config/templates.yaml 读取目标模板的完整配置。
2. 配置项包括：
   • documentclass：如 \documentclass[10pt,twocolumn]{article} 或 \documentclass{iclr2025}
   • column_type：single 或 double
   • default_figure_width：\linewidth 或 \textwidth
   • expected_pages：该会议/期刊的典型页数（如 ICLR 9 页，ECCV 14 页）
   • forbidden_packages：与新模板冲突的宏包列表
   • required_packages：新模板必须加载的宏包

示例配置（config/templates.yaml 片段）：

ECCV2024:
  documentclass: "\documentclass[10pt,twocolumn]{article}"
  column_type: double
  default_figure_width: "\linewidth"
  expected_pages: 14
  forbidden_packages: ["amsthm", "algorithm2e"]
  required_packages: ["graphicx", "amsmath", "amssymb"]
  float_behavior: "figures may use figure* for wide content"