| name | latex-document-writer |
| description | LaTeX 论文写作助手，负责章节、段落、图表、代码块等正文内容的撰写与组织。不涉及模板格式调整。 |
latex-document-writer
1. 核心限制 ⚠️
- 禁止执行任何编译命令（
pdflatex,xelatex,latexmk等） - 仅编辑
.tex文件并保存即可。
2. 目录结构规范
| 路径 | 用途 |
|---|---|
latex/chapter[n]/n.tex |
第 n 章内容（如 latex/chapter1/1.tex） |
figures/ |
图片资源 |
bib/ |
参考文献 |
main.tex |
主文件（勿放内容） |
latex/config.tex |
配置文件（严禁修改） |
3. 写作风格规范
3.1 层次结构与内容组织
核心原则：连贯段落优先，列表为辅。
标题层级：\section → \subsection → \subsubsection → enumerate [label={(\arabic*)}]（作为第四级）
逐级决策：
在任意层级下组织内容时，按以下顺序判断：
(1) 能否用连贯段落？若内容有连贯的逻辑推导、因果关系或叙事性质 → 使用完整段落，到此结束。
(2) 需要细分但内容厚重？各分支含长句、技术推导或需多段展开 → 使用下一级标题。
(3) 需要细分且内容轻量？各项简短独立、天然并列 → 使用列表：
- 有序枚举：
enumerate [label={(\arabic*)}] - 无序快速列举：
itemize
硬性约束：
- 禁止将连贯句子拆解为
\item - 禁止连续两个列表分点之间无实质过渡段（至少一个完整段落）
- 第四级标题后不再允许使用
enumerate [label={(\arabic*)}]，只准用 pifont 宏包或itemize - 禁止
\item开头加\textbf{}（除非用户明确要求）
📁 示例 → references/writing-style.md
3.2 源码行宽
为提升源码可读性，段落文字每行建议控制在 **"30个汉字"或"60个字符（含空格）**左右后手动换行。
例外：LaTeX 命令行、lstlisting 代码块、表格、公式、长URL、文件路径这些必须在同一行的功能性代码除外。
4. 浮动体规范
代码块
使用 lstlisting 环境，必须指定 language=、caption、label=lst:xxx。
📁 模板 → snippets/code-block.tex
图形
决策：简单示意图 → TikZ | 复杂/外部图 → includegraphics
TikZ 模板 📁 snippets/figure-tikz/：
| 文件 | 适用场景 |
|---|---|
_index.tex |
基础模板 + 样式参考 |
flowchart.tex |
流程图（条件、循环、步骤） |
block.tex |
框图（架构、模块、布局） |
tree.tex |
树状结构（二叉树、目录、组织） |
relation.tex |
关系图（ER、拓扑、时序、状态机、类图） |
data-struct.tex |
数据结构（内存、指针、链表、数组） |
chart.tex |
图表（坐标系、韦恩图、饼图、柱状图） |
外部图片 📁 模板 → snippets/figure-image.tex
约束：
- 必须
[H]固定位置 caption在图下方label=fig:xxx
表格
使用三线表（toprule/midrule/bottomrule），禁止 \hline。
约束：
caption在表上方label=tab:xxx- 表头用
\textbf{} - 代码用
\texttt{}
📁 模板 → snippets/table.tex
5. 术语与引用
术语格式
中英对照用 中文 (English) 格式。
📁 术语表 → references/glossary.tex
交叉引用
| 引用对象 | 格式 |
|---|---|
| 章节 | \ref{sec:xxx} |
| 代码 | \ref{lst:xxx} |
| 图片 | \ref{fig:xxx} |
| 表格 | \ref{tab:xxx} |
禁止：引用不存在的标签。引用前必须确认标签已定义。