| name | tex-document-creator |
| description | 创建或修改 TeX/LaTeX 文档。适用于新建中文笔记、讲义、报告、幻灯片，或整理 TeX 目录结构，特别是需要把 tex、pdf、build 分开的任务。 |
TeX Document Creator
用于仓库内的 TeX 文档创建、改写、编译和目录整理。
默认做法
- 先看仓库里是否已有
.tex、latexmkrc、Makefile、compile.sh 等约定；有就复用。
- 中文文档默认用
ctexart；长文档可用 ctexrep；幻灯片可用 ctexbeamer。
- 预设最小前导区，不堆无关宏包。
- 目录默认保持：
文档目录/
├── xxx.tex
├── xxx.pdf
└── build/
aux/log/out/toc/fls/fdb_latexmk/synctex.gz/xdv 之类中间文件放进 build/。- 如需编译脚本，放在
build/compile.sh，不要把顶层弄乱。
图形与宏包
- 如果文档里有多张几何直观图，先检查是否已有合适宏包，不要默认全手写 TikZ。
- 可先用
kpsewhich 探测本机是否有现成包，例如：
tkz-euclide：平面几何、坐标点、角、直角标记；pgfplots：坐标图、函数图、数据图。
- 只有在没有合适包，或需求明显超出包的舒适区时，才自己造轮子。
- 如果必须手写 TikZ，至少抽出统一样式，避免整份文档里线宽、箭头、颜色、标签位置各写各的。
- 教学型文档不要只写文字不给图；应在“读者需要脑补图形”的位置主动补图。
编译
- 优先
latexmk -xelatex -outdir=build
- 如有需要，把最终 PDF 拷回文档目录顶层
- 若
latexmk 不可用，再退回 xelatex -output-directory
写作要求
- 若任务是“通俗解释论文/方法”，优先参考
references/research-paper-simplifier.md。
- 若任务是“解释一个技术方法并保留推导”，再参考
references/method-note-writing.md。
- 非必要不解释 LaTeX 常识；把上下文留给具体任务。
hyperref 开着时，标题里尽量不要直接塞复杂数学公式。- 若文档使用
\tableofcontents，目录页后默认显式加 \newpage，避免正文紧接在目录后面。
- 若用户明确要求某种结构化环境块（如
Problem、Definition、Theorem、Proof），应在前导区一次性设计好，而不是正文里零散凑出来。
- 若文档是入门讲义，优先保证版面和叙述的一致性，而不是追求花哨宏包堆叠。
- 图较多时，先列出图清单，再分批编译；不要等全文写完才发现图形风格失控。
资源
- 新建脚手架：
scripts/scaffold_tex_document.sh
- 补充约定：
references/layout-and-build.md
- 论文通俗解释风格：
references/research-paper-simplifier.md
- 方法型技术笔记写法：
references/method-note-writing.md
