name: artifact_presentation
metadata: { "includeInPrompt": false }
description: Build or revise a slide deck (pptx by default; pdf or html on request). Use whenever a build task's artifact kind is presentation, or the user asks for a deck, slides, or a presentation. Covers per-slide HTML authoring, the StylePlan theme system, font embedding, deck assembly, render gates, and the PPTX export.

Slide-deck artifacts / 幻灯片产物

A deck is authored as one standalone HTML file per slide plus a shared
deck.css and a deck.json manifest, assembled and gated deterministically,
then exported. The per-slide sources under .src/slides/ are the editable
truth for every future revision; slide ids never renumber.

一份幻灯片（deck）的编写方式是：每张幻灯片一个独立 HTML 文件，外加共享的 deck.css 和 deck.json 清单文件，以确定性的方式组装并通过质量门检查，然后导出。.src/slides/ 下的每张幻灯片源文件是后续所有修订的唯一可编辑事实来源；幻灯片 id 永不重新编号。

Three rules hold on every slide, before any reference is read. Sentence case
everywhere (including stat labels). Never use text-transform:uppercase or
letter-spacing on any text. No slide furniture: pills, subtitles, summary
lines, eyebrows, kickers, badges, chips, tags, and captions do not belong
anywhere on a slide. The cover is the deck title over its hero image and
nothing else.

三条规则适用于每一张幻灯片，且优先于任何参考文档的阅读。全部使用句首大写（包括数据标签）。绝不对任何文本使用 text-transform:uppercase 或 letter-spacing。不放幻灯片装饰元素：胶囊标签、副标题、摘要行、眉题、引导语、徽章、芯片、标签和图注一律不得出现在幻灯片上。封面就是叠在主视觉图上的幻灯片标题，除此之外没有任何其他元素。

Task	Read first
New deck	`/opt/hatch/skills/artifacts/presentation/references/workflow.md` plus the references it names
Edit an existing deck	`/opt/hatch/skills/artifacts/presentation/references/editing.md`, plus the references it names
Design and layout	`/opt/hatch/skills/artifacts/presentation/references/visual.md`
Theme generation or application	`/opt/hatch/skills/artifacts/presentation/references/theme.md`
Slides that plot data	`/opt/hatch/skills/artifacts/references/charts.md` (shared)
Slides that show a place or a map	`/opt/hatch/skills/artifacts/references/maps.md` (shared)

任务	先阅读
新建幻灯片	`/opt/hatch/skills/artifacts/presentation/references/workflow.md` 及其提到的参考文档
编辑已有幻灯片	`/opt/hatch/skills/artifacts/presentation/references/editing.md` 及其提到的参考文档
设计与布局	`/opt/hatch/skills/artifacts/presentation/references/visual.md`
主题的生成或应用	`/opt/hatch/skills/artifacts/presentation/references/theme.md`
绘制数据的幻灯片	`/opt/hatch/skills/artifacts/references/charts.md`（共享）
展示地点或地图的幻灯片	`/opt/hatch/skills/artifacts/references/maps.md`（共享）

Scripts / 脚本

Script	What it does
`/opt/hatch/bin/hatch-slide-style`	Compiles the StylePlan; a deck is never built on an invented substitute plan
`/opt/hatch/skills/artifacts/scripts/embed_deck_fonts.mjs`	Subsets and embeds webfonts into deck.css; a font that will not download warns, never blocks
`/opt/hatch/skills/artifacts/scripts/assemble_deck.mjs`	Validates slide files against the manifest, enforces CSS scoping, emits the combined document; non-zero exit is unshippable
`/opt/hatch/skills/artifacts/scripts/render_audit.mjs` (shared)	Renders slides and runs the deck gates; `workflow.md` names the flags
`/opt/hatch/skills/artifacts/scripts/build_pptx.py`	Exports the validated PNGs as the PPTX and carries each slide's title into its speaker notes as best-effort accessibility text; the daemon-side rebuild path preserves those notes after UI edits

脚本	作用
`/opt/hatch/bin/hatch-slide-style`	编译 StylePlan；绝不允许基于自行编造的替代方案构建幻灯片
`/opt/hatch/skills/artifacts/scripts/embed_deck_fonts.mjs`	对 Web 字体做子集化并嵌入 deck.css；无法下载的字体只告警，不阻塞
`/opt/hatch/skills/artifacts/scripts/assemble_deck.mjs`	依据清单校验幻灯片文件，强制 CSS 作用域，生成合并文档；非零退出码即不可交付
`/opt/hatch/skills/artifacts/scripts/render_audit.mjs`（共享）	渲染幻灯片并运行幻灯片质量门；具体参数见 `workflow.md`
`/opt/hatch/skills/artifacts/scripts/build_pptx.py`	把校验通过的 PNG 导出为 PPTX，并尽力将每张幻灯片的标题写入其演讲者备注作为无障碍文本；守护进程侧的重建路径会在 UI 编辑后保留这些备注

Verification / 验证

Follow /opt/hatch/skills/artifacts/testing/SKILL.md: run the gates, then read every
slide PNG fresh before returning a link.

遵循 /opt/hatch/skills/artifacts/testing/SKILL.md：先运行质量门检查，然后在返回链接之前逐一重新查看每张幻灯片的 PNG。