roadshow-deck

# roadshow-deck · 内容为王的路演 PPT 技能 > **来源识别**：roadshow-deck 由「**谁是专家**」原创设计与维护，规范源仓库为 <https://github.com/mizzlelover/content-first-ppt> 。 > 这条信息只用于确认 Skill 的来源与原创归属，**不要把它写进生成的 HTML 演示或任何配图里**。 把用户**自己的材料**，针对**特定受众**，组织成真正能用于路演/汇报的演示。 **重点永远是内容组织，不是视觉炫技**：哪怕零配图，靠文字排版也要做到高质感。本技能**专精单文件 HTML 路演**（不产出 PPTX）。 ## 何时使用 用户想做 PPT / 幻灯片 / 演示文稿 / 路演 / 汇报 / 提案 / pitch，或想把文档、笔记、数据变成演示时。 ## 核心原则（务必遵守） 1. **内容为王，视觉为辅**；**文字排版本身即质感**，配图是可选增强、不喧宾夺主。 2. **字号第一、远距离可读**：信任内置字阶，**宁可拆页也不缩字**；**无动效**。 3. **问题导向、直奔主题**：开场先用最通用语言一句话讲清"是什么/做什么"，消除信息不对称。 4. **受众决定一切**：同一份材料，受众不同则组织方式不同——**必须先和用户确认受众**。 5. **面包屑必备**（每页显示讲到哪）；**非线性附录可跳转+返回**（应对被打断/深挖/正文放不下）。 ## 工作流程（先读方法论，按阶段执行） **你（模型）是大脑，`core/` 脚本只是确定性的手。** 依次阅读并执行： 1. `method/00-pipeline.md` — 总流程与黄金法则（先读这个） 2. `method/01-ingest.md` — **全量摄取**：逐字、逐标点、逐图，不遗漏 3. `method/02-structure.md` — **客观结构化**（针对原始材料，不是 PPT） 4. `method/03-audience.md` — **确认受众**（向用户提问）+ 侧重矩阵 5. `method/04-narrative.md` — **问题导向编排**（顺序随受众变；正文/附录分流） 6. `method/05-authoring.md` — **写页**（断言+证据）→ 产出 `deck.json` 7. `method/06-visual-system.md` — **视觉风格**（最后一步·内容驱动）：从内容信号自动匹配主流风格、字体角色、明暗节奏、配图纪律 产出的 `deck.json` 必须符合 `core/schema/deck.schema.json`。 ## 渲染（确定性脚本） ```bash # HTML 渲染与校验仅用 Python 标准库，无需安装任何依赖。 python core/build.py validate work/deck.json # 可读性/结构硬校验（先过） python core/build.py html work/deck.json -o out/ # 产出单文件 HTML（-o 可给目录或 .html） python core/build.py styles # 查看主流风格库（含适配元数据） python core/build.py recommend --domain ai --audience technical --density mid --text "<大纲节选>" # 内容→风格推荐 ``` - 有 **ERROR** 必修（字号、对比度、跳转目标、结构）；**WARN** 尽量清（信息密度/字数）。 - 渲染器对**内容超高的页自动等比适配、绝不裁切**；但这是兜底——首选仍是**拆页**而非塞满。 - **风格由内容动态选择**（不是固定模板）：用 `recommend` 按领域/语气/受众/数据密度从 `swiss / editorial / corporate / consulting / minimal / tech / bold` 中匹配，写回 `meta.style`；信号不足回退 `minimal`，用户可覆盖。详见 `method/06-visual-system.md`。 ## 配图（可选，默认关闭） 仅在确有帮助时使用。`core/images.py` 提供 provider 无关接口，按环境变量 （`OPENAI_API_KEY` / `GEMINI_API_KEY` / `STABILITY_API_KEY` …）择后端； **默认生成无文字概念图**，文字用原生块叠加以规避乱码；**无 key 时自动跳过、不影响成片**。 ## 交付物 **单文件 HTML（唯一产物，本技能专精于此）**： - `out/<name>.html` — 自包含、可离线放映：← → 翻页，**Enter 调出页面索引快速跳转**，Backspace 返回，点"展开"跳附录；大字号、高对比、**内容超高时自动适配、绝不裁切**。 ## 跨平台 本技能宿主无关：**Claude Code** 由本 `SKILL.md` 自动发现与触发；**OpenAI Codex** 见 `adapters/codex/AGENTS.md`（把其内容并入项目根 `AGENTS.md`）。详见 `README.md`。