lightest-typst-report

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、形态已定）

1. read workflow §0 + typography 本次形态 § + 将用到的 figures/visualization 节
2. apply_patch → reports/<name>/
3. writing_compile_check → read PDF
4. 缺 prose / 数值图 / 去 AI → 对应邻接技能 → 再 compile

项目根：reports/<slug>/main.typ；SSH 编译需 daemon 在线。