| name | lightest-latex |
| skill_id | lightest_latex_skill |
| controlled | true |
| description | 当用户要写或改 LaTeX（.tex）、套顶会/学位论文模板（NeurIPS/ICML/ICLR/ACL/CVPR/清北 thuthesis/pkuthss）、编译 PDF、Beamer/海报/BibTeX，或维护 main.tex 写作项目时使用；覆盖模板选型→main.tex→编译→read 验版。**触发**：.tex、LaTeX、顶会模板、毕业论文、Beamer、BibTeX、main.tex、pdflatex、xelatex。**加载**：`skills_fetch(skill_ids=["lightest_latex_skill"])` → read `references/writing-project-guide.md` 与任务相关 reference。**勿用**：Typst 研报 → `lightest_typst_report_skill`；润色 → `lightest_writing_skill`；HTML 拼页出 PDF → 禁止，走写作项目 + 本技能或 Typst。 |
| references | ["references/writing-project-guide.md","references/SOURCES.md","references/ml-paper-writing/writing-guide.md","references/ml-paper-writing/citation-workflow.md","references/ml-paper-writing/checklists.md","references/debugging-guide.md","references/bibliography-guide.md","references/beamer-guide.md","references/ieee-journal-twocolumn-guide.md","references/poster-design-guide.md","references/code-patterns.md","references/format-conversion.md","references/thuthesis-guide.md","references/pkuthss-guide.md","references/latex-thesis-zh/GB_STANDARD.md","references/venue-templates/ml_conference_style.md","templates/venues-README.md"] |
LighTest LaTeX（内置 Skill）
官方内置：连接本地项目时同步到 .lightest/skills/lightest-latex/；扫描器读 skill_id: lightest_latex_skill；不在 skills.ts 重复注册。
从 ≥20 个公开 GitHub Agent Skill 与官方会议/学位模板合并为单一入口（见 references/SOURCES.md）。路径均以本目录为根；勿向用户复述第三方 skill 名或任何 skill 聚合站/市场发现渠道。
技能分工
| 技能 | 何时 |
|---|
| 本技能 | 选模板、写 .tex、版式/公式/表格、顶会 cls、BibTeX、Beamer/海报、编译 PDF |
lightest_writing_skill | 英文 prose 润色、去 AI 味（成稿后） |
lightest_typst_report_skill | 用户明确要 Typst 研报而非 LaTeX |
academic_search | 文献检索；引用须走 citation-workflow，禁止幻觉 BibTeX |
详细工作流（强制）
写作项目根 = 含 main.tex 的目录（project_path / read 的 path 传文件夹，勿传 main.tex 文件路径）。
| 阶段 | 动作 | 工具 / 路径 |
|---|
| 0. 摸底 | 看清目录、既有章节、是否已有写作根 | list_dir；定位用 grep_search |
| 1. 选模板 | 按目标会议/学位/体裁定 templates/venues/<name>/ 或 assets/templates/ | 见下节「任务路由」与 templates/venues-README.md；整目录复制（含 .sty/.bst/.cls） |
| 2. main.tex | 在 Agent 项目下建写作根（如 papers/neurips/），入口为 main.tex（或会议主文件 + 子文件） | apply_patch；顶会稿先 read references/ml-paper-writing/writing-guide.md；学位论文先 read references/thuthesis-guide.md 或 pkuthss-guide.md |
| 3. 改源码 | 改前先读将动区域；多章用 \input{data/chap01} 等 | read → apply_patch |
| 4. 编译 | 每批 .tex 改动后必须编译 | writing_compile_check({ project_path: "papers/neurips" })；或 bash .lightest/skills/lightest-latex/scripts/compile_latex.sh …/main.tex |
| 5. 修错 | 读日志对应行 ±10–20 行 → 修 → 再编译至通过 | references/debugging-guide.md |
| 6. read PDF | 编译通过后验排版 | `read(items=[{path:"papers/neurips", pages:[1,2], type:"text" |
| 7. 磁盘 PDF（可选） | 仅当用户要项目内 main.pdf | writing_compile_check({ project_path, export_pdf: true }) |
平台：本机 writing_compile_check 支持 macOS / Windows（TinyTeX）；Linux 本机不支持，须 SSH 远端。编译成功的 PDF 默认只在 App 内存；验版用步骤 6，勿只靠 list_dir 找 PDF。
引擎：CJK / fontspec / xeCJK / thuthesis / pkuthss → XeLaTeX；纯英文顶会稿多为 pdfLaTeX（脚本与 writing_compile_check 会按项目探测）。
纪律：未验证的 BibTeX 禁止当正式引用；未编译通过不得宣称「已完成」。
示例 1：NeurIPS 顶会稿
目标：英文 ML 投稿 PDF，NeurIPS 2025 版式。
skills_fetch → read references/ml-paper-writing/writing-guide.md + checklists.md- 复制模板：
cp -r .lightest/skills/lightest-latex/templates/venues/neurips2025/ papers/my-neurips/（保留 neurips.sty、main.tex 同目录）
- 在
papers/my-neurips/ 写/改 main.tex（或会议主文件），正文 \input{sections/...}；引用仅 DOI/API 拉 BibTeX（citation-workflow.md）
writing_compile_check({ project_path: "papers/my-neurips" })read(items=[{path:"papers/my-neurips", pages:[1]}]) 查标题/摘要/栏宽；再按需 pages:[2,3] 看图表
勿：只拷 main.tex 丢掉 .sty；在对话里 HTML 拼页冒充 PDF。
示例 2：清华学位论文（thuthesis）
目标：中文学位论文，ThuThesis v7.7.1。
read references/thuthesis-guide.md + references/latex-thesis-zh/GB_STANDARD.md（国标引用）- 复制
templates/venues/thuthesis/ → thesis/thu-master/；主控多为 thuthesis-example.tex，可重命名为写作根 main.tex 或保持主文件名但 project_path 仍指向含该入口的目录
- 改
thusetup.tex（题目/导师/学位）、data/chap*.tex、ref/refs.bib；编译须 XeLaTeX（见 thuthesis-guide）
writing_compile_check({ project_path: "thesis/thu-master" })read(items=[{path:"thesis/thu-master", pages:[1,2]}]) 验封面、摘要、目录
对比 NeurIPS：学位论文走 thuthesis/ + 中文国标 + XeLaTeX；顶会稿走 templates/venues/<conf>/ + ml-paper-writing/ + 常为 pdfLaTeX。北大 → pkuthss/ + references/pkuthss-guide.md（example/thesis.tex，biber）。
任务路由（简表）
| 用户要 | 先 read | 模板 / 路径 |
|---|
| 新建 LaTeX 写作项目 | writing-project-guide.md | 目录内 main.tex |
| 顶会 ML（NeurIPS/ICML/ICLR/AAAI/COLM） | ml-paper-writing/writing-guide.md | templates/venues/<name>/ |
| ACL / EMNLP / NAACL | emnlp2024/formatting.md | emnlp2024/ 或 acl/ |
| CVPR / ICCV / ECCV | venue-templates/ml_conference_style.md | cvpr2026/ / iccv2025/ / eccv2026/ |
| 清华 / 北大学位论文 | thuthesis-guide.md / pkuthss-guide.md + latex-thesis-zh/ | thuthesis/ / pkuthss/ |
| IEEE 期刊双栏 | ieee-journal-twocolumn-guide.md | examples/ieee-twocolumn-sample.tex |
| Beamer / 海报 / 简历 | beamer-guide.md / poster-design-guide.md / resume-ats-guide.md | assets/templates/ |
| 编译失败 | debugging-guide.md | — |
| 引用 / .bib | bibliography-guide.md + citation-workflow.md | 禁止未验证 BibTeX |
| MD/DOCX ↔ LaTeX | format-conversion.md | scripts/convert_document.sh |
顶会目录一览（复制整目录）：neurips2025/、icml2026/、iclr2026/、acl/、emnlp2024/、cvpr2026/、iccv2025/、eccv2026/、aaai2026/、colm2025/；学位：thuthesis/、pkuthss/。详见 templates/venues-README.md。
编译（两种方式）
| 方式 | 何时 |
|---|
writing_compile_check | LighTest 写作项目（推荐）；project_path = 含 main.tex 的目录 |
scripts/compile_latex.sh | 单次编译任意 .tex 路径；--preview 可选 |
bash .lightest/skills/lightest-latex/scripts/compile_latex.sh path/to/main.tex --preview
引用幻觉（强制）
未程序化验证的条目标 [CITATION NEEDED] 或 PLACEHOLDER_*_verify，并告知用户。细则：references/ml-paper-writing/citation-workflow.md。
References 索引
加载本 skill 后 先 read 与任务相关的下表文件；SKILL.md 只保留路由与工作流。
| 文件 | 内容 |
|---|
references/writing-project-guide.md | 主 reference（必读）：写作项目、main.tex、编译环境、中文 ctex、协作与 patch 纪律 |
references/SOURCES.md | 上游 GitHub 合并索引（维护者） |
| 顶会写作 | |
references/ml-paper-writing/writing-guide.md | ML 论文结构与写作 |
references/ml-paper-writing/checklists.md | 投稿前 checklist |
references/ml-paper-writing/citation-workflow.md | DOI/API 引用、禁幻觉 BibTeX |
references/ml-paper-writing/reviewer-guidelines.md | 审稿视角要点 |
references/venue-templates/ml_conference_style.md | CV/NLP 版式要点 |
| 学位 / 中文 | |
references/thuthesis-guide.md | 清华 ThuThesis 速查（XeLaTeX、thusetup.tex） |
references/pkuthss-guide.md | 北大 pkuthss（biber） |
references/latex-thesis-zh/GB_STANDARD.md | GB/T 7714 等 |
references/latex-thesis-zh/TABLE_GUIDE.md 等 | 三线表、摘要结构（见 thuthesis-guide 表） |
| 版式与组件 | |
references/code-patterns.md | 公式、表格、图表通用模式 |
references/bibliography-guide.md | .bib 与 natbib/biblatex |
references/beamer-guide.md | 幻灯片 |
references/poster-design-guide.md | 会议海报 |
references/ieee-journal-twocolumn-guide.md | IEEE 双栏 |
references/format-conversion.md | Pandoc / MD↔TeX |
references/debugging-guide.md | 编译报错排错 |
references/tables-and-images.md | 图表插入 |
references/visual-packages.md | TikZ 等 |
references/font-guide.md | 字体 |
references/long-form-best-practices.md | 长文写作 |
references/profiles/*.md | 简历、商务文档等场景 |
templates/venues-README.md | 各 venue 目录说明 |
脚本与通用 .tex 样例：scripts/、assets/templates/、examples/。
常见失败模式
| 场景 | 会出现的问题 | 处理 |
|---|
project_path 指向 main.tex 文件 | 编译 / read PDF 失败 | 改为含 main.tex 的目录 |
只拷主 .tex 无 .sty | 缺包、版式全错 | 整目录复制 templates/venues/<name>/ |
| 学位论文用 pdfLaTeX | 中文/字体失败 | 改 XeLaTeX（thuthesis/pkuthss） |
| 手写未验证 BibTeX | 投稿引用错误 | citation-workflow + 占位符 |
编译成功就 list_dir 找 PDF | 误以为无输出 | read(项目根, pages) |
改完未 writing_compile_check | 宣称完成仍报错 | 每批 patch 后必编译 |
与 Typst 二选一
用户未指定格式时：调研 PDF / 行业报告优先问 Typst（lightest_typst_report_skill）；投稿顶会 / 现有 .tex / 导师要 LaTeX → 本技能。
