latex-modular

# latex-modular ## 触发场景 ### 文件更新约束 > **本技能的 `.md` 文件禁止使用 Write/Edit 工具更新。** > 必须用 `scripts/` 下的 Python 脚本原子写入（`tmp + os.replace()`）。 | 文件 | 更新方式 | 脚本 | |------|----------|--------| | `SKILL.md` frontmatter | Python 原子写入 | `scripts/update_frontmatter.py` | | `SKILL.md` 正文 | Python 直接重建 | `scripts/safe_write.py` 的 `safe_write()` | | `scripts/components/*.txt` | Python 写入 | `scripts/component_manager.py` | | `references/*.md` | `scripts/safe_write.py` | 随技能自带 | - [把这段 LaTeX 做成模块化模板] - [生成一个 LaTeX 文档，用模块化方式] - [重构这个 LaTeX 代码进模块化体系] - [提取 LaTeX 的组件，做成可复用模块] - [用 latex-modular 生成一个...文档] - [验证这段 LaTeX 能不能编译通过] **不触发**： - 用户只是问 [LaTeX 怎么写]——这是闲聊 - 用户要求直接编辑 .tex 文件而不使用模块化方式 ## 核心能力 > 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。 - **extract 模式** — 从已有 LaTeX 代码中提取文档头、宏包、自定义命令、环境、样式，保存为可复用组件 - **compose 模式** — 通过 Python 脚本按模块组合生成完整 LaTeX 文档，确保编译无错误 - **refactor 模式** — 将原始 LaTeX 代码重构进模块化体系，保留原文语义，按模块拆分存储 - **validate 模式** — 使用 lualatex 编译验证生成的 .tex 文件，报告错误并返回修复建议 - **template 模式** — 模板库+自定义保存+内容注入。支持 `--template` 按名加载、`--save-as` 保存自定义模板、`--content` 注入正文、`--list-templates` 等，内置 article/report 两种预设模板（`scripts/template.py` + `scripts/templates/`） - **inject 模式** — 向现有 .tex 增量插入组件，不破坏已有内容。自动将导言区内容追加到目标导言区，正文插入到指定位置。支持 LuaLaTeX/XeLaTeX 直接注入和 pdfLaTeX 语法动态转换（`scripts/component_inject.py`） - **convert 模式** — 将完整的 pdfLaTeX 文档转换为 LuaLaTeX 兼容语法。原文件不动，输出新文件 + 转换报告（`scripts/convert.py`） ### 渐进式文件索引 | 文件 | 位置 | 说明 | |------|------|------| | `references...