Web Presentation Skill

Web-native Presentation Intelligence

HTML 原生智能演示系统

不是又一个 PPT 模板生成器——而是一套把**演示科学**（认知科学 / 传播学 / 演示研究）与 **Web 演示工程**打通的 AI Skill。给定复杂内容、真实受众、沟通目标与场景，它产出的不是"幻灯片文件"，而是一个可现场运行、可分支深潜、可动态调整的 **Presentation Application（演示应用）**。

Not another slide-template generator — an AI Skill that fuses **presentation science** (cognitive science, communication, presentation research) with **web presentation engineering**. Given complex content, a real audience, a communication goal and a situation, it produces not "slide files" but a runnable, branchable, adaptive **Presentation Application**.

**官网 / Website**：https://present.mizzlelover.xyz · **演示 Demo**：`examples/demo/index.html`

---

它解决什么 · What it solves

常见工具	本系统
输入 → 直接生成 HTML 页面	输入 → 演示策略 → 论证架构 → Scene 规划 → Presentation IR → 渲染 → QA（禁止一步到位）
通用规则："每页 6 行""标题必须问句"	证据分级（A–E）+ 边界条件：规则必须带机制、语境、证据、例外
线性翻页器	Presentation Graph：核心路径 / 可选路径 / Deep Dive / 证据附录 / 现场分支
只有"放映"一种形态	One Content Model, 三种 Mode：Stage（讲演）/ Reader（自读）/ Print（打印）
动画=装饰	语义动效（REVEAL/FOCUS/CAUSE…），讲者可 pause/seek/skip
依赖 CDN、现场断网即崩	离线优先：整目录打包，Stable > Fancy

快速开始 · Quick Start

# 1. 安装到你的 AI 编程环境（Claude Code / Codex / OpenCode / Kimi Code）
cp -r web-presentation-skill ~/.config/agents/skills/     # 用户级
# 或项目级：cp -r web-presentation-skill your-project/.agents/skills/

# 2. 看一眼可运行的完整示例（零依赖，浏览器直接打开）
open examples/demo/index.html
#    快捷键：→/Space 推进 · ← 回退 · / 搜索 · P 讲者台 · R 阅读模式 · Esc 深潜返回

# 3. 校验一份 Presentation IR
python3 scripts/validate_ir.py examples/demo/presentation.ir.json

各 harness 的详细接入方式见 [adapters/](adapters/README.md)。· See [adapters/](adapters/README.md) for Claude Code / Codex / OpenCode setup.

工作流程 · The Pipeline

源材料 Source Material
  ↓  analyze_source_content      内容理解 + 证据标注
演示策略 Presentation Strategy   情境判定(20类) → 受众建模 → 目标动词
  ↓  build_argument_map          论证树 + 六查（无证据断言/逻辑跳跃/过度声称…）
Scene 规划 Scene Plan            每幕一个 Cognitive Job · 认知负