latex-scaffold
从现有的 Markdown 草稿和 `itations/ref.bib` 中搭建一个 LaTeX 项目(`latex/main.tex`、参考书目布线、结构)。**触发器**:latexscaffold、md→tex、LaTeX 重建项目、生成 main.tex。**使用时**:需要 LaTeX/PDF 交付(例如 arxiv-survey-latex pipeline),且草稿已生成/已进入构建阶段。**如果**:则跳过:还没有 `output/DRAFT.md`(或者你不需要 LaTeX 交付)。**Network**: none.**Guardrail**: 移除 markdown 残留(`##`, `**`, `[@...]`);参考书目指向 `itations/ref.bib`;不在此步骤改写内容。
📖 中文导读:从现有的 Markdown 草稿和 `itations/ref.bib` 中搭建一个 LaTeX 项目(`latex/main.tex`、参考书目布线、结构)。**触发器**:latexscaffold、md→tex、LaTeX 重建项目、生成 main.tex。**使用时**:需要 LaTeX/PDF 交付(例如 arxiv-survey-latex pipeline),且草稿已生成/已进入构建阶段。**如果**:则跳过:还没有 `output/DRAFT.md`(或者你不需要 LaTeX 交付)。**Network**: none.**Guardrail**: 移除 markdown 残留(`##`, `**`, `[@...]`);参考书目指向 `itations/ref.bib`;不在此步骤改写内容。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: latex-scaffold
description: |
Scaffold a LaTeX project (latex/main.tex, bibliography wiring, structure) from an existing Markdown draft and citations/ref.bib.
Trigger: latex scaffold, md→tex, LaTeX 项目骨架, 生成 main.tex.
Use when: 需要 LaTeX/PDF 交付(例如 arxiv-survey-latex pipeline),且 draft 已生成/已进入写作阶段。
Skip if: 还没有 output/DRAFT.md(或你不需要 LaTeX 交付)。
Network: none.
Guardrail: 移除 markdown 残留(##, **, [@...]);bibliography 指向 citations/ref.bib;不在此步骤改写内容。
LaTeX Scaffold
Convert the approved Markdown draft into a minimal, buildable LaTeX project.
This is a deterministic conversion step; prose quality should already be addressed in output/DRAFT.md.
Inputs
output/DRAFT.md(or another approved draft)citations/ref.bib
Outputs
latex/main.tex(and any required LaTeX support files)
Workflow
- Create
latex/directory if missing. - Create
latex/main.texwith sections matching the outline. - Wire bibliography to
citations/ref.bib.
Quality checklist
-
latex/main.texexists and referencescitations/ref.bib.
Script
Quick Start
python .codex/skills/latex-scaffold/scripts/run.py --helppython .codex/skills/latex-scaffold/scripts/run.py --workspace <workspace_dir>
All Options
- See
--help(inputs/outputs are taken from the unit runner when used via pipeline)
Examples
- Build
latex/main.texfromoutput/DRAFT.md:python .codex/skills/latex-scaffold/scripts/run.py --workspace <ws>
Notes
- The generated
latex/main.texincludes a table of contents (tocdepth=2) for readability. - Language default: the scaffold uses
article(English-looking front matter). If the draft contains CJK characters, it switches toctexartso the PDF renders correctly. - Conversion rules (high level):
- Headings
##/###/####→\section/\subsection/\subsubsection(strips leading numeric prefixes like1.2). ## Abstract→abstractenvironment.[@Key]or[@Key1; @Key2]→\citep{Key}/\citep{Key1,Key2}.- Inline markdown
**bold**/*italic*/`code`→\textbf{}/\emph{}/\texttt{}.
- Headings
Troubleshooting
Issue: the generated latex/main.tex still contains Markdown markers
Fix:
- Re-run
latex-scaffoldand ensure the inputoutput/DRAFT.mdis clean (no##, no**, no[@...]syntax that isn""t handled).
Issue: citations are missing in LaTeX
Fix:
- Ensure
citations/ref.bibexists and the scaffold points bibliography to it; then compile withlatex-compile-qa.