| name | lightest-typst-report |
| skill_id | lightest_typst_report_skill |
| controlled | true |
| description | 当用户要把调研/行业/技术报告落成 Typst PDF、要双栏 preprint/IEEE 版式、三线表与 booktabs、Fletcher/CeTZ 架构流程图，或从 lightest-writing 定稿 prose 进入排版阶段时使用；覆盖 4 个 reference 的版式与可视化配方。**触发**：Typst 报告、调研 PDF、行业研报、双栏、三线表、架构图、流程图、IEEE、preprint、ilm、biz-report、prose 排版成稿。**加载**：`skills_fetch(skill_ids=["lightest_typst_report_skill"])` → 按阶段 read 四个 reference（见下文路由表）。**勿用**：仅 compile 报错 → `typst_writing_skill`；CSV/Excel→matplotlib Exhibit → `lightest_data_viz_skill`；HTML 拼页出 PDF → 禁止；正文润色 → `lightest_writing_skill`。 |
| references | ["references/report-workflow.md","references/typography-and-layout.md","references/figures-tables-and-citations.md","references/visualization-guide.md"] |
LighTest Typst 可视化报告
角色：把已定体裁、已定 prose 的调研/技术/实验内容，落成可编译的 Typst 项目并验收 PDF 版式。细节配方在四个 reference（合计 3200+ 行）；写 .typ 前必须 read 对应 reference，禁止凭记忆猜 preamble 或包版本。
权威源：本目录 references/*.md；合并 lucifer1004/claude-skill-typst、ChanMeng666/typst-claude-skill、apcamargo/typst-skills、Mineru98/typst-skills 等公开 GitHub 上游（见各 reference 文末来源表）。
邻接技能边界（先路由再 fetch）
| 技能 | 用 / 不用 |
|---|
typst_writing_skill | 只修 Typst 语法、单文件编译报错、章节 apply_patch 技巧；不用本技能 |
本技能 lightest_typst_report_skill | 研报/技术报告 版式、双栏/IEEE、模板函数、表图 caption、Fletcher/CeTZ、成稿→PDF 验收 |
lightest_writing_skill | 大纲、行业研究树、prose 润色 / 去 AI 味；排版阶段只改引号内句子，不动 #figure 结构 |
lightest_data_viz_skill | CSV/Excel→matplotlib/seaborn 的 Exhibit/Figure 静态图（PNG/PDF），再 #image 嵌入 Typst；禁止在本技能里手写假数据 CeTZ-Plot |
chart_visualization_skill | 对话内 ```graph``` / Vega 示意；不能替代研报正式 Figure 或带刻度的 Exhibit |
lightest_latex_skill | 用户明确要 LaTeX 顶会稿；非 Typst 报告 |
lightest_docx_cn_paper_skill | Word 国标学位/期刊；非 Typst PDF |
academic_search | 文献检索；引用须 read 摘要后再写，禁止编造 DOI |
硬禁令：HTML/CSS 拼页当 PDF；同一文档叠两个冲突的 #show: ieee + #show: preprintx；无 read 数据却画 CeTZ-Plot 数值图。
端到端工作流（Agent 默认顺序）
| 阶段 | 动作 | 必读 reference |
|---|
| 0 澄清 + 形态 | 报告类型、语言、单栏/双栏、图表量级、数据路径 | report-workflow.md §0、§版式决策树 |
| 1 大纲 | 每节标注图表类型 + label（@fig: / @tab:） | report-workflow.md §1 + typography-and-layout.md §6 skeleton |
| 2 脚手架 | reports/<slug>/ + preamble；空壳须 compile 绿 | typography-and-layout.md §2–§5 或 §19/§20 |
| 3 分章 prose | 一章一 patch；数字来自已 read 的数据 | typography-and-layout.md |
| 4 表图 | 表→figures-tables-and-citations.md；架构/流程→visualization-guide.md；CSV 数值图→先 lightest_data_viz_skill | 见下「Exhibit / Figure」 |
| 5 验收 | compile → read PDF 清单 → 可选去 AI → 再 compile | report-workflow.md §5、§分阶段验收 |
工具链：list_dir / grep_search → read（.typ/.bib/CSV/PDF）→ apply_patch → writing_compile_check({ project_path }) → read PDF pages（text + image）。
节奏：一次 patch 只修一层（syntax → layout → 图布局 → copy）；永远先 compile 通过，再去 AI 味。
任务路由表（用户意图 → read 什么）
| 用户要什么 | 形态 / 起步 | 先 read（顺序） | 次要 read |
|---|
| 中文行业调研 PDF | 单栏 A · §2 或 §19 research-report | workflow §0 → typography §2、§19 → figures §1–§2 | visualization（若有架构图） |
| 技术方案 / 内部 memo | 单栏 E | workflow §0 → typography §19（classification 改「内部」） | figures §1 |
| CS/EE 双栏 preprint / 双栏研报 | 双栏 B · §20 paper() 或 preprintx §11 | workflow §0 → typography §1、§3、§20 → figures §1、§35 双栏 placement | visualization §双栏通栏 |
| IEEE 会议稿 | 双栏 D · charged-ieee | workflow §0 → typography §11、§12 → figures booktabs | — |
| 长报告 + 图表目录 | ilm | typography §11 ilm.with | figures caption |
| 商业研报 + 信息框 | biz-report + showybox | typography §13 → figures 表 | visualization 示意 |
| 三线表 / 指标矩阵 | — | figures §2.2 三线表、§booktabs | typography 表 show 规则 |
| 架构 / 流程 / 反馈环 | Fletcher | visualization §Fletcher → figures §1 caption | typography 通栏（双栏时） |
| LaTeX / Markdown 迁移 | — | typography §38 → figures §29/§36 → workflow Pandoc 禁令 | workflow §LaTeX 对照表 |
| 仅「编译失败」 | — | 改 fetch typst_writing_skill | — |
| CSV 画折线/柱状进 PDF | 数据图外置 | 先 lightest_data_viz_skill → 再 figures #image 嵌入 | 本技能 visualization §CSV 边界 |
§ 号均指对应 references/*.md 内章节标题。
完整迷你示例：用户要「双栏研报 PDF」
用户原话：「把这份技术调研排成 双栏研报，要有架构图和指标表，导出 PDF。」
0. 加载与第一轮 read（不要先写 .typ）
skills_fetch(skill_ids=["lightest_typst_report_skill"])
read → references/report-workflow.md # §0 确认形态 B（双栏 preprint 风）
read → references/typography-and-layout.md # §1 形态表、§3 双栏、§20 paper() 或 §11 preprintx
read → references/figures-tables-and-citations.md # §1 caption/label、§35 双栏 placement
1. 澄清（若未给出则问一句）
语言（中/英）、是否通栏封面+摘要、架构图节点清单、指标表是否已有 CSV。
2. 脚手架
reports/llm-survey-2025/
preamble.typ # #set page(columns: 2) 或 #show: paper.with(...)
main.typ
sections/01-intro.typ …
refs.bib
figures/
apply_patch 后立刻 writing_compile_check — 空章也要绿。
3. 第二轮 read（动手表图前）
read → references/visualization-guide.md # Fletcher 架构图 + 双栏通栏 block
# 若有 metrics.csv：
skills_fetch(skill_ids=["lightest_data_viz_skill"]) # 出 figures/metrics.png
read → references/figures-tables-and-citations.md # §1 #image 宽 88% / 通栏 100%
4. 写入顺序
prose 一章一 patch → 指标表（三线表 <tab:metrics>）→ 架构图（<fig:arch>）→ .bib 与 @key 同步 grep。
5. 验收 read PDF
read pages：封面/标题通栏页；含 @fig:arch 的页（type:"image"）；含 @tab:metrics 的页；参考文献；任意双栏页检查宽图未溢出单栏。
6. 可选
lightest_de_ai_writing_skill 只改正文句 → 再 writing_compile_check。
Exhibit / Figure 验收（Typst 侧 + 与 data_viz 分工）
| 类型 | 谁生产 | Typst 侧验收项 |
|---|
| 架构 / 流程 / 示意 | 本技能 Fletcher 或 CeTZ | <fig:…> + caption 能独立理解；双栏用通栏；read PDF 看节点不重叠 |
| 精确数值图（CSV） | lightest_data_viz_skill → PNG/PDF | #image("figures/…") 路径相对当前 .typ；caption 与图内单位/时间范围一致；数字可追溯 read |
| 三线表 / booktabs | 本技能 #table | kind: table、表题在上；正文有 @tab:；禁止「表1」空 caption |
| 对话 graph 示意 | chart_visualization_skill | 不得冒充正式交付 Figure；若用户要 PDF 定稿，必须升级到 data_viz 或 Typst 表 |
分阶段勾选（摘自 workflow，Agent 交付前自检）
骨架：main.typ + preamble compile 通过；形态与阶段 0 一致；字体 NCM + Noto CJK（禁 SimSun）。
内容：每章 patch 后 compile；每个 <fig:/<tab: 正文有 @ 引用；数字来自已读数据。
图表：每张图 read PDF 页；双栏宽图已通栏；caption 写论证句而非重复标题。
引用：每个 @key 在 refs.bib；无编造 DOI；参考文献页生成。
交付：封面、目录（若有）、摘要、结论、每个图表页、双栏平衡感；grep "<fig:" 无 duplicate label。
形态速选（阶段 0 快照）
| 用户描述 | 起步 |
|---|
| 中文行业调研 PDF | typography §2 或 §19 research-report |
| CS 双栏 preprint / 双栏研报 | typography §20 paper() 或 preprintx §11 |
| IEEE 会议稿 | charged-ieee §11 |
| 数值对比 | figures 三线表 / booktabs |
| 架构/流程 | visualization Fletcher |
| LaTeX/MD 迁移 | typography §38 + figures §29/§36 + workflow Pandoc |
行业 topic 未结构化时，可先 lightest_writing_skill → industry-research-tree.md，再进入上表。
四个 reference（勿再拆第五份）
| 文件 | 内容 |
|---|
report-workflow.md | 阶段 0–5、目录结构、Agent 节奏、compile 调试、包版本锁定、LaTeX 迁移禁令 |
typography-and-layout.md | 单栏/双栏、通栏、Universe 模板、research-report / paper()、theme、LaTeX §38 |
figures-tables-and-citations.md | 表/图/caption/公式/引用、子图、双栏 placement、Pandoc |
visualization-guide.md | Fletcher / CeTZ / CeTZ-Plot 边界、CSV 规则、双栏通栏 |
最短路径（已有 prose、形态已定）
read workflow §0 + typography 本次形态 § + 将用到的 figures/visualization 节apply_patch → reports/<name>/writing_compile_check → read PDF- 缺 prose / 数值图 / 去 AI → 对应邻接技能 → 再 compile
项目根：reports/<slug>/main.typ；SSH 编译需 daemon 在线。
