latex-format-adapter
- 核心职责
解析格式规范 → 生成/修改 LaTeX 配置
- 输入来源
📄 外部规范文档
-
PDF 格式规范：学校/期刊/出版社的模板要求文档
-
Word 参考模板 (.docx)：需要转换为 LaTeX 格式的 Word 模板
-
图片/截图：格式样例、标注说明、扫描的纸质规范
📝 文字描述
-
用户直接描述：如 "页边距改成上下2.5cm，左右3cm，标题用黑体小三"
-
格式说明文档：LaTeX 模板附带的格式规范 (README/说明文档)
-
规范条文：逐条列出的格式要求清单
🔍 逆向分析
-
从 PDF 反推：分析已有 PDF 输出，提取页面布局、字体、间距等参数
-
学习现有模板：从其他 LaTeX 项目的配置文件中学习格式定义
-
对比修改：用户提供编译后的 PDF，指出与规范不符之处
🤝 交互式调整
-
迭代优化：根据用户反馈逐步调整格式
-
局部修正：针对具体问题（如"目录页码对齐不正确"）精确修改
- 输出目标
根据项目结构自动识别并调整相应的格式控制文件：
① 导言区配置（最常见，优先使用）
适用于大多数项目，直接在主文档或配置文件中调整宏包参数：
配置位置 典型文件 调整内容
主文档导言区 main.tex 、thesis.tex
直接在 \documentclass 和 \begin{document} 之间配置
独立配置文件 config.tex 、setup.tex 、preamble.tex
通过 \input{config} 导入的格式设置
常见调整内容：
-
页面布局：geometry 宏包（页边距、页眉页脚间距）
-
字体设置：fontspec/ctex（中英文字体、字号、字重）
-
标题样式：ctex/titlesec（章节格式、编号样式、间距）
-
行距段距：setspace/parskip（行距、段前段后间距）
-
页眉页脚：fancyhdr（页眉页脚内容、样式、分隔线）
-
目录样式：tocloft/titletoc（目录格式、缩进、页码）
-
列表样式：enumitem（编号格式、缩进、间距）
-
参考文献：biblatex/natbib（引用格式、排序方式）
② 独立样式文件（中大型项目）
适用于需要模块化管理或复用格式定义的项目：
文件类型 典型用途 示例
.sty 文件 封装可复用的格式定义和宏命令 mythesis.sty 、heading-style.sty
分模块配置 按功能拆分配置（便于维护） config/fonts.tex 、config/layout.tex
操作方式：
-
创建新的 .sty 文件或修改现有样式包
-
拆分大型 config.tex 为多个模块化文件
-
通过 \usepackage{mystyle} 或 \input{config/module} 引入
③ 文档类定制（高级需求）
适用于需要深度定制文档行为的场景（如学校官方模板）：
文件类型 典型用途 注意事项
.cls 文件 定义文档类（如 \documentclass{mythesis} ） 需要深入理解 LaTeX 内部机制
操作方式：
-
修改现有 .cls 文件（如 thesis.cls 、ctexart.cls 的定制版）
-
从零创建新的文档类（复杂，通常基于现有类扩展）
-
调整底层命令定义（字体族、计数器、浮动体行为等）
选择原则：
-
✅ 优先使用 ①：简单直接，适合 90% 的格式调整需求
-
⚠️ 必要时用 ②：项目复杂度高、需要模块化管理、多人协作时
-
⛔ 谨慎使用 ③：仅在导言区配置无法实现时才考虑（如需修改文档类底层行为）
- 工作流程
第一步：理解需求
-
接收输入：获取用户提供的格式规范（PDF/图片/文字描述等）
-
提取参数：识别关键格式要求
-
页面布局：纸张大小、页边距、装订线
-
字体字号：正文/标题/图表的字体、字号、字重
-
间距设置：行距、段间距、标题间距
-
编号格式：章节编号、图表编号、公式编号
-
页眉页脚：内容、位置、样式
-
特殊要求：封面、摘要、目录、参考文献等格式
第二步：分析项目结构
-
检查现有文件：
-
主文档是什么？（main.tex 、thesis.tex 等）
-
是否有配置文件？（config.tex 、setup.tex 等）
-
是否使用自定义类/样式？（.cls 、.sty 文件）
-
确定调整策略：
-
简单项目 → 直接修改导言区配置
-
复杂项目 → 考虑模块化拆分
-
官方模板 → 可能需要修改 .cls 文件
第三步：映射 LaTeX 命令
将格式要求转换为 LaTeX 代码：
-
页边距 2.5cm → \usepackage[top=2.5cm, bottom=2.5cm, ...]{geometry}
-
标题黑体小三加粗 → \ctexset{section={format={\heiti\zihao{-3}\bfseries}}}
-
行距 1.5 倍 → \setstretch{1.5} 或 \linespread{1.5}
第四步：实施修改
-
备份原文件（如有必要）
-
编辑配置文件：
-
修改现有配置
-
或创建新的 .sty / .tex 文件
-
验证语法：确保 LaTeX 命令正确
第五步：测试验证
-
提醒用户编译：xelatex main.tex 或项目特定的编译命令
-
对比输出：将生成的 PDF 与格式要求对比
-
迭代调整：根据差异继续优化
- 与 latex-document-writer 的协作
-
格式与内容分离：
-
本 skill（latex-format-adapter）：只负责格式配置文件（config.tex 、.sty 、.cls 等）
-
latex-document-writer：只负责正文内容（章节 .tex 文件、图表、公式等）
-
协作边界：
-
✅ 本 skill 可以修改：宏包引入、格式参数、样式定义
-
❌ 本 skill 不应修改：章节内容、图表数据、参考文献条目
-
典型工作流：
-
用户先用 latex-format-adapter 配置好格式
-
再用 latex-document-writer 填充内容
-
格式微调时切回 latex-format-adapter