PPT Skill
把内容装进 13 个注册版式，产出单目录网页 PPT；HTML 是唯一的源，PPTX / PNG 是一键衍生物。
硬约束（违反任何一条即返工）
- 禁止从零写 HTML。deck 只能由
templates/seed.html复制而来，幻灯片只能复制references/layouts.md中的注册骨架并替换文字内容。 - 禁止发明类名。只能使用 base.css 已定义的 class；校验器会拒绝白名单外的类名。
- 禁止裸色值与字体声明。颜色只经 token；行内 style 只允许
top/left/width/height/font-size/line-height的参数化数值。 - 每页必须声明
data-layout="Lxx"（L01–L13）。 - 文字只能在
h1/h2/h3/p内；装饰元素挂div[data-shape="rect|ellipse"]；图片用<img>，禁止 background-image 承载内容图。 - 数据诚实：L07/L11 等数据版式必须使用用户提供的真实数值，禁止编造；无真实数据就改用概念版式。
- 每页密度纪律：1 个核心信息 + 不超过 4 个支撑点；超出即拆页；相邻页不重复同一版式。
- 主题整套使用，一个 deck 一个主题文件，不逐页混搭。
工作流
第 1 步 · 澄清定档（一次性提问，不超过 5 问）
- Q1 交付格式（必问，定档位，之后不可切换）：只需网页演示 → Web 档；需要可编辑 .pptx → Office 档。
- Q2 受众与场合 → 按
references/themes.md的映射表推荐 2–3 个主题。 - Q3 页数或时长。
- Q4 已有素材（大纲 / 文档 / 数据 / 图片 / logo）。
- Q5 硬性约束。品牌色仅在用户有明确品牌规范时接受，否则使用预设主题。
第 2 步 · 资产与事实核查（涉及真实机构/产品/数据时必做）
- 事实先行：一切对外陈述的数字、日期、名称必须有来源——用户提供的一手资料或联网核实的官方发布；逐条可溯源，KPI 页脚注标注出处。查不到的硬数据改用概念版式，禁止编造。
- 照片选择：候选照片 >10 张时先拼 contact-sheet（一张网格预览图）再挑选，不逐张读图。
- 图上文字避让：L09/L14/L01 带图版式选图后先读图确认主体位置（logo、人脸、产品），标题与遮罩必须落在画面安静区；主体被裁掉就换图，不硬凑。
第 3 步 · 建 deck
mkdir -p <deck-dir>/assets && cp templates/seed.html <deck-dir>/index.html
cp -r assets/base.css assets/runtime.js assets/themes <deck-dir>/assets/
按选定主题修改 <link id="theme">；替换 <title>。deck 自包含，可整目录分发。
第 4 步 · 样张门（deck ≥ 5 页时必做）
先只做两页：封面（L01）+ 内容最典型的一页。渲染截图给用户确认后，才进入批量生产。方向错误在 2 页时修正，不在 13 页时返工。
第 5 步 · 批量填充
先按 references/narratives.md 选叙事模板（路演/汇报/宣传）定页序，再逐页：从 references/layouts.md 复制骨架 → 只替换文字/图片 → 自查密度。图片放 <deck-dir>/assets/img/，命名 {页码}-{语义}.{ext}。
第 6 步 · 机器校验（第一道门）
node scripts/validate.mjs <deck-dir> # Web 档
node scripts/validate.mjs <deck-dir> --office # Office 档
错误必须清零。溢出的处理顺序：精简文案 → 参数化行内样式微调 → 换版式；禁止缩小字号到 16px 以下。
第 7 步 · 视觉自检（第二道门）
node scripts/render-png.mjs <deck-dir>
逐页查看渲染图，按 references/checklist.md 的 P0–P3 分级检查；P0/P1 必须修复。
第 8 步 · 交付
Web 档交付 deck 目录（浏览器打开 index.html，方向键翻页，F 全屏，S 开演讲者控制台——双窗同步、下页预览、计时器、讲稿提示）。讲稿写法：每页末尾可加 <aside class="notes"><p>提示语</p></aside>，仅演讲者可见，永不进入渲染与导出；写"提示信号"（每页 ≤3 短句），不写逐字稿。按需追加：
node scripts/export-pdf.mjs <deck-dir> # 矢量 PDF（两档皆可）
node scripts/export-pptx.mjs <deck-dir> --cjk-font "Microsoft YaHei" # Office 档
导出后必须做第三道门：用演示软件打开 .pptx 与 HTML 渲染图逐页比对（详见 references/pptx-export.md）。
版式速查表
| 编号 | 版式 | 用于 |
|---|---|---|
| L01 | 封面 | 开场：kicker + 大标题 + 副题 + 元信息 |
| L02 | 目录 | 3–5 条议程 |
| L03 | 章节分隔 | 大序号 + 章节名，切换节奏 |
| L04 | 观点陈述 | 一句话大字，单点强调 |
| L05 | 双栏对比 | 两方案 / 前后对比，两面板 |
| L06 | 三点论证 | 三个并列论据 |
| L07 | KPI 大字 | 2–3 个真实数据指标 |
| L08 | 时间线 | 4 节点横向演进 |
| L09 | 图片主视觉 | 全幅图 + 遮罩标题 |
| L10 | 正文加要点 | 左长文右三要点，常规内容页 |
| L11 | 台账行 | 4 行 label–value–note 结构化信息 |
| L12 | 流程步骤 | 4 步过程 |
| L13 | 结尾 | 收束语 + 元信息 |
主题
paper（默认，暖纸白）· graphite（深色）· forest（冷纸绿）。选择依据见 references/themes.md。
参考文档（按需读取，勿全量加载）
references/layouts.md— 14 个版式的完整可复制骨架 + 节奏装饰用法references/narratives.md— 路演/汇报/宣传三套叙事页序模板references/themes.md— 主题目录与受众映射references/authoring.md— 文案密度、中文字号规则references/pptx-export.md— Office 档约束、字体策略、导出排错references/checklist.md— P0–P3 视觉自检清单references/animations.md— 演示模式语义动画配方（自动生效，导出不受影响）