home / skills / huangwb8 / chineseresearchlatex / transfer_old_latex_to_new
This skill guides and automates migrating NSFC LaTeX templates to the new version, handling structure changes and updates end-to-end.
npx playbooks add skill huangwb8/chineseresearchlatex --skill transfer_old_latex_to_newReview the files below or copy the command above to add this skill to your agents.
---
name: migrating-latex-templates
version: 1.4.1
description: 当用户明确要求"迁移标书""升级模板""跨版本迁移""旧标书转新模板"时使用。智能迁移NSFC LaTeX标书到新版模板，基于五阶段工作流（分析→映射→规划→执行→验证），自动处理结构变化、内容重组、引用更新；支持AI驱动语义匹配与启发式回退，并提供 runs 输出隔离与一键迁移脚本。
author: Bensz Conan
metadata:
author: Bensz Conan
short-description: NSFC LaTeX标书跨版本智能迁移
keywords:
- latex
- nsfc
- proposal migration
- template upgrade
- cross-version migration
- structure reorganization
triggers:
- 迁移标书
- 升级模板
- 跨版本迁移
- 旧标书转新模板
- 模板结构变化
- 内容重组
dependencies:
- python: ">=3.8"
- latex: texlive-full
- scripts/run.py
- scripts/core/
entry_point: python skills/transfer_old_latex_to_new/scripts/run.py
config: skills/transfer_old_latex_to_new/config.yaml
references: skills/transfer_old_latex_to_new/references/
---
# LaTeX 标书智能迁移器
> **核心入口**：`python skills/transfer_old_latex_to_new/scripts/run.py --help`
>
> **一键迁移**：`bash skills/transfer_old_latex_to_new/scripts/migrate.sh --old ... --new ...`
>
> **配置中心**：[config.yaml](config.yaml)
>
> **参考文档**：[references/](references/)
>
> **拆分文档**：
> [references/quickstart.md](references/quickstart.md) /
> [references/config_guide.md](references/config_guide.md) /
> [references/api_reference.md](references/api_reference.md) /
> [references/troubleshooting.md](references/troubleshooting.md) /
> [references/faq.md](references/faq.md) /
> [references/case_study_2025_to_2026.md](references/case_study_2025_to_2026.md)
---
## 快速开始
```bash
# 一键分析（生成结构差异报告）
python skills/transfer_old_latex_to_new/scripts/run.py analyze \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026
# 一键应用（执行迁移，apply前自动快照）
python skills/transfer_old_latex_to_new/scripts/run.py apply \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026 \
--run-id <上一步输出的run_id>
# 一键编译（验证迁移结果）
python skills/transfer_old_latex_to_new/scripts/run.py compile \
--run-id <run_id> \
--new /path/to/NSFC_2026
# 一键恢复（回滚到apply前状态）
python skills/transfer_old_latex_to_new/scripts/run.py restore \
--run-id <run_id> \
--new /path/to/NSFC_2026
```
### 一键迁移（推荐）
```bash
bash skills/transfer_old_latex_to_new/scripts/migrate.sh \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026
```
### runs 输出隔离（强烈建议：测试/批处理）
```bash
python skills/transfer_old_latex_to_new/scripts/run.py analyze \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026 \
--runs-root /path/to/runs
```
**输出目录**：默认 `skills/transfer_old_latex_to_new/runs/<run_id>/`；指定 `--runs-root` 则输出到该目录。
```
runs/<run_id>/
├── input_snapshot/ # 旧新项目输入快照
├── analysis/ # 结构分析JSON（sections_map_*.json, structure_diff.json）
├── plan/ # 迁移计划（migration_plan.json）
├── backup/ # Apply前新项目快照（用于restore）
├── logs/ # 执行日志与编译输出
│ ├── apply_result.json # 迁移执行结果
│ ├── compile_summary.json # 编译摘要
│ ├── compile_*_*.out.txt # 编译标准输出
│ ├── compile_*_*.err.txt # 编译标准错误
│ └── latex_aux/ # LaTeX 中间文件隔离目录
│ ├── main.aux # 辅助文件
│ ├── main.log # 编译日志
│ ├── main.bbl # BibTeX 输出
│ ├── main.blg # BibTeX 日志
│ ├── main.out # hyperref 输出
│ ├── main.toc # 目录文件
│ └── *.aux # 其他辅助文件
└── deliverables/ # 交付物（PDF、报告、指南）
```
**中间文件隔离**: 所有 LaTeX 编译中间文件(.aux/.log/.bbl等)自动保存在 `logs/latex_aux/` 目录,避免在项目目录产生"垃圾"文件。最终 PDF 自动复制回项目根目录。
---
## 前置约束（铁律）
### 修改范围白名单
**✅ 可修改**:
- `extraTex/*.tex` 内容文件（**排除** `@config.tex`）
- 新项目 `references/*.bib`（如需更新引用格式）
- 本技能运行产物：`runs/<run_id>/`（日志、分析、备份、交付物）
**❌ 禁止修改**:
- `main.tex` 模板结构文件
- `extraTex/@config.tex` 配置文件
- `.cls`、`.sty` 样式文件
- 任何影响编译环境的系统文件
更完整的流程说明、配置与排障文档已拆分到 `references/`：
- [references/quickstart.md](references/quickstart.md)
- [references/config_guide.md](references/config_guide.md)
- [references/api_reference.md](references/api_reference.md)
- [references/troubleshooting.md](references/troubleshooting.md)
## 📋 版本与变更
**当前版本**: v1.4.0（与 [config.yaml](config.yaml) 同步）
**变更记录**: 见根级 [CHANGELOG.md](../../../CHANGELOG.md)
**优化计划**: 质量评估与优化计划见 `plans/v202601081355.md`（仓库根级）
---
**最后更新**: 2026-01-08
**维护者**: Bensz Conan
**许可证**: MIT
This skill automates migrating NSFC LaTeX proposals from older templates to a new template using a five‑stage workflow: analysis → mapping → planning → execution → validation. It isolates runs, produces structured reports and artifacts, and offers a one‑click migration script to streamline large or repeated updates. The tool preserves template files and style assets while safely transforming content and citations.
The skill inspects both old and new project trees, generates a structure diff and section mapping, and builds a migration plan (migration_plan.json). It then executes content moves and transformations into a runs/<run_id>/ workspace, snapshots the new project before applying changes, and compiles the result into isolated logs and deliverables for verification. AI semantic matching plus heuristic fallbacks guide content remapping; an automated restore path and granular logs enable safe rollbacks.
What files will never be modified by this skill?
The tool never modifies main.tex, extraTex/@config.tex, .cls or .sty files, or other system/compile environment files.
How do I test a migration safely?
Run the analyze command with a --runs-root to create an isolated run; inspect analysis and plan outputs before running apply. Apply creates a backup snapshot automatically.
Where are LaTeX intermediate files stored?
All .aux/.log/.bbl and other intermediate files are isolated under runs/<run_id>/logs/latex_aux/ to avoid polluting the project directory.