kaisersong/kai-slide-creator

kai-slide-creator

生成零依赖 HTML 演示文稿，纯浏览器运行。主路径是 IR-first：user prompt → BRIEF.json → HTML → validate。

安装

Claude Code: 告诉 Claude「安装 https://github.com/kaisersong/slide-creator」
OpenClaw: clawhub install kai-slide-creator

使用方式

/slide-creator ... 是 Claude/OpenClaw 的 slash 技能调用，不是 bash 命令。

规划深度：

• 自动 (Auto) — 快速出稿，约 3-6 分钟
• 精修 (Polish) — 深度规划，约 8-15 分钟，自动执行 Review

内容类型 → 风格推荐：

| 内容类型 | 推荐风格 | |---|---| | 数据报告 / KPI 看板 | Data Story、Enterprise Dark、Swiss Modern | | 商业路演 / VC Deck | Bold Signal、Aurora Mesh、Enterprise Dark | | 产品发布 / SaaS | Blud Sky、Aurora Mesh、Glassmorphism、Electric Studio | | 开发工具 / API 文档 | Terminal Green、Neon Cyber、Neo-Retro Dev Deck | | 研究 / 思想领导力 | Modern Newspaper、Paper & Ink、Swiss Modern | | 创意 / 个人品牌 | Vintage Editorial、Split Pastel、Neo-Brutalism | | 哲学 / 思想 | Chinese chan| | 咨询报告 / 战略方案 | Strategy Consulting、Enterprise Dark、Swiss Modern |

命令路由

自动 (Auto) — 快速出稿 | 精修 (Polish) — 深度规划，自动执行 Review

| 命令 | 加载内容 | 行为 | |------|----------|------| | --plan [prompt] | references/brief-template.json；如用户指定了 custom theme，同步加载 themes/<name>/reference.md | 创建 BRIEF.json；仅在用户明确要求时额外派生 PLANNING.md | | --generate | SKILL.md + 已选风格文件（内置 references/*.md / blue-sky-starter.html；自定义 themes/<name>/reference.md）+ composition 源 + references/title-quality.md + references/html-template.md + references/js-engine.md + references/base-css.md + references/impeccable-anti-patterns.md | 从 BRIEF.json 生成 HTML，并执行写入前门禁；如用户显式要求 eval，同步产出单 deck 评测 JSON | | --review [file.html] | references/review-checklist.md + 目标 HTML | 执行 17 项检查点 → 确认窗口 → 修复/报告 | | 无 flag (交互式) | references/workflow.md + 其他按需 | 遵循 Phase 0-5 | | 直接给内容 + 风格 | 同 --generate | 先落一个有效 BRIEF.json，再走同一个 deterministic renderer 与 strict 写入前门禁；禁止手拼最终 HTML |

渐进式披露： 每个命令只加载所需文件。--plan 只提炼 IR，不接触 CSS。

核心规则（按优先级）

1. 风格强制 所有颜色、字体、组件、背景、动画、图表色、signature elements 都必须且只能来自选中的风格文件。模板里的 [from style file] 和示例值只是占位，禁止直接使用。
   默认推荐面第一阶段聚焦 4 个 production presets：Swiss Modern / Enterprise Dark / Data Story / Blue Sky；但用户显式指定任意当前 preset 时，必须保留该选择。support tier 只影响默认推荐优先级，不影响显式指定。 Custom theme（themes/<name>/reference.md）与内置 preset 同等对待。BRIEF.json 的 style.preset 支持三种值：内置 preset 名、custom theme 文件夹名、或 themes/<name>/reference.md 路径。代码层会自动归一化解析。
   Swiss Modern 额外要求 canonical export path：面板保持 .slide direct child，token 保持 --bg/--text/--red，使用 canonical 类（.left-panel/.right-panel/.stat-row/.cta-block），并写入 data-export-role；不得生成 .left-col/.right-col 或 --bg-primary/--accent 这类兼容别名。

2. 叙事弧线 先锁内容结构，再锁 composition route。每页都要有明确 page role、不同布局意图和足够的信息推进；不要先拼播放/编辑壳子，再回头补故事。内部 route 名称属于实现细节，不要挤占用户入口层。

3. 标题质量 标题必须是断言式，禁止 Overview / Introduction / Summary / 结论 / 概览 这类通用标签。多行标题必须平衡，不能出现孤儿行、塌陷中间行或靠过窄 measure 硬挤换行。规则和示例只看 references/title-quality.md。

4. 运行时与壳子基线 非 Blue Sky 风格必须走共享壳子：body[data-preset]、scroll-snap、SlidePresentation、PresentMode、首屏 .visible 修复、data-notes、shell markers。Blue Sky 是唯一允许保留自身 #stage/#track 架构的 preset。

5. 可降级功能 播放模式、编辑模式、水印都默认开启，但优先级低于风格、叙事和标题。

   • 播放模式：默认开启
   • 编辑模式：默认开启，可省略编辑模式，尤其在用户明确说不要或 existing HTML/导入场景受约束时
   • 水印：默认保留，但必须是 JS 注入到最后一页，position: absolute，禁止 position: fixed

详见 references/html-template.md。生成任何 HTML 前必读此文件。

Direct-route guard: 无论是 --generate 还是“直接给内容 + 风格”，都必须先 materialize 一个有效 BRIEF.json，再通过 render_from_brief() 同一路径渲染，并在写出最终文件前通过 python3 scripts/validate_html.py "$TMP_HTML" --strict。禁止在交互式路径里绕过 BRIEF 直接手写最终 HTML。

Optional eval artifact: 当用户显式要求 eval / 评测 时，生成链路应在 strict gate 通过后额外写出单 deck 评测 JSON。原始 CLI 对应 --eval（默认写同名 .eval.json）或 --eval-out <path>；评测至少包含 style_score (= style_signature_coverage)、quality gates、hard failures 与关键 diagnostics。

Pre-Write Validation Pipeline（写入前门禁）

组装完整 HTML 后，先写入临时文件，再运行：

任一失败都算生成失败，必须修复或重生直到通过。

核心门禁顺序：

1. 风格强制 / canonical export 选中风格的 Signature Elements、Typography、Components、Background 必须完整注入；不得遗漏 checklist 项。Blue Sky 例外：使用 blue-sky-starter.html 基底。

2. 叙事弧线 / composition route 页数、page roles、composition route 必须完整；连续两页不得使用相同布局；每页至少使用 2-3 种组件类型，不得只用 .g + .bl 堆砌。单页列表项 ≤ 5 条；标题 + 正文段落 + 列表三者不得同时出现在同一页（内容过多时拆页）。

3. 标题质量 标题规则见 references/title-quality.md。

4. 架构隔离 / runtime 非 Blue Sky 风格必须使用 scroll-snap-type: y mandatory + SlidePresentation。#stage/#track/translateX 只允许 Blue Sky。

5. Preset metadata / shell markers body[data-preset] 必须存在且非占位；写出 id="slide-N"、#brand-mark、.nav-dots、.progress-bar、.slide-num-label、data-export-role。

6. 对比度 / token 使用 文字对比必须正确；浅底不用浅字，深底不用深字；优先用风格 token，不要发明局部颜色。

7. 字体 / CJK Google Fonts 合并为单一链接；<style> 开头要有 body { background-color: ... } 回退；CJK 页面追加对应 Noto Sans SC/JP/KR。

8. CSS 工程 布局、背景、间距通过 CSS 选择器定义；inline style="" ≤ 5 处，目标 0。

9. 低级错误与模板完整性 禁止 U+FE0F。Blue Sky 模板路径还要检查 REQUIRED BLOCK、@keyframes、以及 go() 返回 boolean。

更多视觉和内容规则在 --review / Phase 3.5 Review 中执行。完整反模式映射表见 references/impeccable-anti-patterns.md。

风格参考

只读取已选风格的文件：

• 内置预设：完整列表、风格说明和选择建议都在 references/style-index.md

• 支持层级：默认推荐面与 support tier 定义在 references/preset-support-tiers.json

• 内置风格文件位置：统一在 references/ 下；Blue Sky 例外，使用 references/blue-sky-starter.html

• 自定义主题：themes/<name>/reference.md

• 风格选择器：references/style-index.md

• 视口与共享 CSS：references/base-css.md

• 设计质量基线：references/design-quality.md

• 标题规则：references/title-quality.md

• 反模式：references/impeccable-anti-patterns.md

• BRIEF.json 已存在 → 直接读取并作为真相源

• 只有在用户明确要求人工审阅时才派生 PLANNING.md

• 现有 HTML 增强遵循 references/workflow.md 的 Enhancement Mode

相关技能

• kai-html-export — 导出 PPT（图片模式或 Native 模式）