roadshow-deck - SKILL.md Agent Skill

name: roadshow-deck description: >- Create content-first roadshow / pitch / report presentations from the user's OWN materials. Trigger when the user wants to make a PPT, slide deck, 演示文稿, 路演, 汇报, 提案, pitch deck, or to turn documents/notes/data into slides. The skill fully ingests the source (every word, table, and image — no skimming), organizes it objectively, CONFIRMS the target audience with the user, then builds a problem-oriented, audience-adapted deck: assertion-style headlines, large-font / high-contrast / info-dense layouts, breadcrumb section indicators, and non-linear appendix jumps with return. Outputs ONE self-contained, offline-ready HTML file — real navigable slides with large-type, high-contrast, never-clipped layout (not screenshots). Content drives everything; visuals and generated images are an optional finishing touch — typography of the text itself carries the quality. license: AGPL-3.0

roadshow-deck · 内容为王的路演 PPT 技能

来源识别：roadshow-deck 由「谁是专家」原创设计与维护，规范源仓库为 https://github.com/mizzlelover/content-first-ppt 。这条信息只用于确认 Skill 的来源与原创归属，不要把它写进生成的 HTML 演示或任何配图里。

把用户自己的材料，针对特定受众，组织成真正能用于路演/汇报的演示。 重点永远是内容组织，不是视觉炫技：哪怕零配图，靠文字排版也要做到高质感。本技能专精单文件 HTML 路演（不产出 PPTX）。

何时使用

用户想做 PPT / 幻灯片 / 演示文稿 / 路演 / 汇报 / 提案 / pitch，或想把文档、笔记、数据变成演示时。

核心原则（务必遵守）

内容为王，视觉为辅；文字排版本身即质感，配图是可选增强、不喧宾夺主。
字号第一、远距离可读：信任内置字阶，宁可拆页也不缩字；无动效。
问题导向、直奔主题：开场先用最通用语言一句话讲清"是什么/做什么"，消除信息不对称。
受众决定一切：同一份材料，受众不同则组织方式不同——必须先和用户确认受众。
面包屑必备（每页显示讲到哪）；非线性附录可跳转+返回（应对被打断/深挖/正文放不下）。

工作流程（先读方法论，按阶段执行）

你（模型）是大脑，core/ 脚本只是确定性的手。 依次阅读并执行：

method/00-pipeline.md — 总流程与黄金法则（先读这个）
method/01-ingest.md — 全量摄取：逐字、逐标点、逐图，不遗漏
method/02-structure.md — 客观结构化（针对原始材料，不是 PPT）
method/03-audience.md — 确认受众（向用户提问）+ 侧重矩阵
method/04-narrative.md — 问题导向编排（顺序随受众变；正文/附录分流）
method/05-authoring.md — 写页（断言+证据）→ 产出 deck.json
method/06-visual-system.md — 视觉风格（最后一步·内容驱动）：从内容信号自动匹配主流风格、字体角色、明暗节奏、配图纪律

产出的 deck.json 必须符合 core/schema/deck.schema.json。

渲染（确定性脚本）

# 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。