kai-slide-creator

Category: Ops & Delivery | Uploader: kaisersong | Downloads: 0 | Version: v1.0（Latest）

生成HTML演示文稿/幻灯片 — 21 种风格模版，播放/演讲者模式。适用于路演、产品发布、技术分享、方案宣讲等场景。

Changelog: Source: GitHub https://github.com/kaisersong/slide-creator

Directory Structure

Current level: tree/main/

📁 demos/
- 📁 mode-paths/
  - 📄 auto-BRIEF.json 3.4 KB
  - 📄 auto-PLANNING.md 2.8 KB
  - 📄 intent-broker-auto-BRIEF.json 3.7 KB
  - 📄 intent-broker-auto-PLANNING.md 4.0 KB
  - 📄 intent-broker-auto.html 39.6 KB
  - 📄 intent-broker-polish-BRIEF.json 4.9 KB
  - 📄 intent-broker-polish-PLANNING.md 6.1 KB
  - 📄 intent-broker-polish.html 41.3 KB
  - 📄 polish-BRIEF.json 4.8 KB
  - 📄 polish-PLANNING.md 5.7 KB
- 📁 screenshots/
  - 📄 aurora-mesh.png 280.6 KB
  - 📄 blue-sky.png 794.0 KB
  - 📄 bold-signal.png 49.6 KB
  - 📄 chinese-chan.png 40.4 KB
  - 📄 creative-voltage.png 37.7 KB
  - 📄 dark-botanical.png 81.1 KB
  - 📄 data-story.png 44.3 KB
  - 📄 electric-studio.png 34.7 KB
  - 📄 enterprise-dark.png 51.6 KB
  - 📄 glassmorphism.png 333.2 KB
  - 📄 japanese-zen.png 40.4 KB
  - 📄 modern-newspaper.png 36.9 KB
  - 📄 neo-brutalism.png 60.5 KB
  - 📄 neo-retro-dev.png 23.4 KB
  - 📄 neon-cyber.png 96.0 KB
  - 📄 notebook-tabs.png 44.3 KB
  - 📄 paper-ink.png 43.0 KB
  - 📄 pastel-geometry.png 42.0 KB
  - 📄 split-pastel.png 51.0 KB
  - 📄 swiss-modern.png 29.7 KB
  - 📄 terminal-green.png 49.1 KB
  - 📄 vintage-editorial.png 55.6 KB
- 📄 .DS_Store 6.0 KB
- 📄 aurora-mesh-en.html 39.7 KB
- 📄 aurora-mesh-zh.html 39.6 KB
- 📄 blue-sky-en.html 36.6 KB
- 📄 blue-sky-zh.html 60.7 KB
- 📄 bold-signal-en.html 37.1 KB
- 📄 bold-signal-zh.html 48.0 KB
- 📄 chinese-chan-en.html 31.5 KB
- 📄 chinese-chan-zh.html 32.1 KB
- 📄 creative-voltage-en.html 35.0 KB
- 📄 creative-voltage-zh.html 43.9 KB
- 📄 dark-botanical-en.html 41.9 KB
- 📄 dark-botanical-zh.html 41.0 KB
- 📄 data-story-en.html 41.8 KB
- 📄 data-story-zh.html 47.6 KB
- 📄 electric-studio-en.html 41.8 KB
- 📄 electric-studio-zh.html 42.9 KB
- 📄 enterprise-dark-en.html 42.2 KB
- 📄 enterprise-dark-zh.html 48.1 KB
- 📄 glassmorphism-en.html 42.1 KB
- 📄 glassmorphism-zh.html 49.8 KB
- 📄 modern-newspaper-en.html 41.6 KB
- 📄 modern-newspaper-zh.html 48.0 KB
- 📄 neo-brutalism-en.html 37.9 KB
- 📄 neo-brutalism-zh.html 47.9 KB
- 📄 neo-retro-dev-en.html 40.9 KB
- 📄 neo-retro-dev-zh.html 51.9 KB
- 📄 neon-cyber-en.html 41.3 KB
- 📄 neon-cyber-zh.html 54.4 KB
- 📄 notebook-tabs-en.html 41.1 KB
- 📄 notebook-tabs-zh.html 60.5 KB
- 📄 paper-ink-en.html 40.8 KB
- 📄 paper-ink-zh.html 50.9 KB
- 📄 pastel-geometry-en.html 40.9 KB
- 📄 pastel-geometry-zh.html 55.3 KB
- 📄 slide-creator-intro-BRIEF.json 7.3 KB
- 📄 slide-creator-intro.html 56.5 KB
- 📄 split-pastel-en.html 40.9 KB
- 📄 split-pastel-zh.html 46.8 KB
- 📄 swiss-modern-en.html 40.8 KB
- 📄 swiss-modern-zh.html 62.3 KB
- 📄 terminal-green-en.html 33.0 KB
- 📄 terminal-green-zh.html 39.8 KB
- 📄 vintage-editorial-en.html 41.4 KB
- 📄 vintage-editorial-zh.html 39.9 KB
📁 evals/
- 📁 generated-decks/
  - 📁 2026-04-21-slide-creator-intro/
    
    📁 screenshots/
    
    📄 new-blue-cover-vtb.png 256.8 KB
    
    📄 new-blue-cover.png 199.0 KB
    
    📄 new-creative-voltage-cover-vtb.png 38.9 KB
    
    📄 new-creative-voltage-cover.png 38.9 KB
    
    📄 orig-blue-cover-vtb.png 420.2 KB
    
    📄 orig-blue-cover.png 144.9 KB
    
    📄 orig-creative-voltage-cover-vtb.png 41.0 KB
    
    📄 orig-creative-voltage-cover.png 41.0 KB
    
    📄 comparison.md 3.6 KB
    
    📄 eval-results.json 6.4 KB
    
    📄 slide-creator-intro-blue-sky-BRIEF.json 5.5 KB
    
    📄 slide-creator-intro-blue-sky-zh.html 63.6 KB
    
    📄 slide-creator-intro-creative-voltage-BRIEF.json 4.9 KB
    
    📄 slide-creator-intro-creative-voltage-zh.html 44.4 KB
    
    📄 user-prompt.md 422 B
- 📁 late-context/
  - 📁 cases/
    
    📁 lc-001-basic-late-trigger/
    
    📄 context.json 548 B
    
    📄 expectations.json 334 B
    
    📄 expected-brief.json 270 B
    
    📁 lc-002-style-switch-near-end/
    
    📄 context.json 465 B
    
    📄 expectations.json 254 B
    
    📄 expected-brief.json 141 B
    
    📁 lc-003-report-request-negative/
    
    📄 context.json 340 B
    
    📄 expectations.json 110 B
    
    📄 expected-brief.json 33 B
    
    📁 lc-004-core-runtime-guard/
    
    📄 context.json 658 B
    
    📄 expectations.json 337 B
    
    📄 expected-brief.json 268 B
    
    📁 lc-005-preset-metadata-bypass/
    
    📄 context.json 594 B
    
    📄 expectations.json 421 B
    
    📄 expected-brief.json 286 B
    
    📁 lc-006-blue-sky-runtime-control/
    
    📄 context.json 567 B
    
    📄 expectations.json 381 B
    
    📄 expected-brief.json 259 B
    
    📁 lc-007-style-signature-near-limit/
    
    📄 context.json 587 B
    
    📄 expectations.json 349 B
    
    📄 expected-brief.json 290 B
    
    📁 lc-008-same-brief-parity-control/
    
    📄 context.json 346 B
    
    📄 expectations.json 523 B
    
    📄 expected-brief.json 265 B
    
    📁 lc-009-same-brief-parity-noisy-wrapper/
    
    📄 context.json 600 B
    
    📄 expectations.json 529 B
    
    📄 expected-brief.json 265 B
    
    📁 lc-010-sparse-brief-fallback/
    
    📄 context.json 300 B
    
    📄 expectations.json 392 B
    
    📄 expected-brief.json 279 B
    
    📁 lc-011-invalid-brief-fail-closed/
    
    📄 context.json 596 B
    
    📄 expectations.json 267 B
    
    📄 expected-brief.json 35 B
    
    📁 lc-012-high-context-rich-benchmark/
    
    📄 context.json 753 B
    
    📄 expectations.json 573 B
    
    📄 expected-brief.json 281 B
    
    📁 lc-013-default-chrome-leak-regression/
    
    📄 context.json 181 B
    
    📄 expectations.json 401 B
    
    📄 expected-brief.json 194 B
    
    📁 lc-014-data-story-numeric-fidelity/
    
    📄 context.json 222 B
    
    📄 expectations.json 428 B
    
    📄 expected-brief.json 254 B
    
    📁 lc-015-high-context-richness-non-regression/
    
    📄 context.json 210 B
    
    📄 expectations.json 666 B
    
    📄 expected-brief.json 380 B
    
    📁 lc-016-title-balance-negative-fixture/
    
    📄 context.json 195 B
    
    📄 expectations.json 334 B
    
    📄 expected-brief.json 125 B
    
    📁 lc-017-structural-preset-title-control/
    
    📄 context.json 194 B
    
    📄 expectations.json 372 B
    
    📄 expected-brief.json 122 B
    
    📁 lc-018-mixed-language-title-balance/
    
    📄 context.json 211 B
    
    📄 expectations.json 390 B
    
    📄 expected-brief.json 118 B
  - 📁 core-md-guard/
    
    📄 README.md 590 B
  - 📁 low-context-safe-generate/
    
    📄 README.md 1.7 KB
  - 📄 manifest.json 769 B
- 📄 failure-map.md 1.2 KB
- 📄 scoring-schema.json 6.0 KB
📁 plans/
- 📄 2026-04-25-ai-native-org-skill-bug-record.md 14.9 KB
- 📄 2026-04-25-style-reference-rollout-plan.md 3.6 KB
📁 references/
- 📄 aurora-mesh.md 11.5 KB
- 📄 base-css.md 6.8 KB
- 📄 blue-sky-starter.html 69.8 KB
- 📄 bold-signal.md 8.4 KB
- 📄 brief-template.json 3.5 KB
- 📄 chinese-chan.md 12.8 KB
- 📄 composition-8.md 5.3 KB
- 📄 composition-guide.md 3.8 KB
- 📄 creative-voltage.md 10.7 KB
- 📄 dark-botanical.md 8.9 KB
- 📄 data-story.md 14.6 KB
- 📄 design-quality.md 11.5 KB
- 📄 design-system.md 3.9 KB
- 📄 diagram-patterns.md 10.2 KB
- 📄 electric-studio.md 8.3 KB
- 📄 enterprise-dark.md 19.8 KB
- 📄 glassmorphism.md 13.3 KB
- 📄 html-template.md 20.9 KB
- 📄 impeccable-anti-patterns.md 11.1 KB
- 📄 js-engine.md 18.8 KB
- 📄 modern-newspaper.md 8.5 KB
- 📄 neo-brutalism.md 10.8 KB
- 📄 neo-retro-dev.md 9.5 KB
- 📄 neon-cyber.md 9.2 KB
- 📄 notebook-tabs.md 7.1 KB
- 📄 paper-ink.md 14.5 KB
- 📄 pastel-geometry.md 6.9 KB
- 📄 planning-template.md 4.7 KB
- 📄 pptx-extraction.md 2.7 KB
- 📄 review-checklist.md 13.6 KB
- 📄 split-pastel.md 8.1 KB
- 📄 style-index.md 3.3 KB
- 📄 swiss-modern.md 19.3 KB
- 📄 terminal-green.md 8.7 KB
- 📄 title-profile-registry.json 5.6 KB
- 📄 title-quality.md 3.9 KB
- 📄 vintage-editorial.md 8.6 KB
- 📄 workflow.md 25.0 KB
📁 schemas/
- 📄 generation-brief.schema.json 7.3 KB
📁 scripts/
- 📄 eval-quality.py 1.8 KB
- 📄 generate.py 35.1 KB
- 📄 low_context.py 113.2 KB
- 📄 quality_eval.py 16.0 KB
- 📄 render-from-brief.py 2.1 KB
- 📄 screenshot-demos.py 3.8 KB
- 📄 title_browser_qa.py 17.8 KB
- 📄 title_profiles.py 6.7 KB
- 📄 validate-brief.py 685 B
📁 tests/
- 📄 audit_style_consistency.py 6.8 KB
- 📄 conftest.py 165 B
- 📄 run_tests.py 2.2 KB
- 📄 test_audit_style_consistency_autofix.py 1.5 KB
- 📄 test_cross_preset_consistency.py 15.0 KB
- 📄 test_demo_quality.py 30.2 KB
- 📄 test_design_quality_guards.py 13.9 KB
- 📄 test_doc_sync.py 4.3 KB
- 📄 test_export_integration.py 7.8 KB
- 📄 test_generate_rendering.py 14.4 KB
- 📄 test_ir_first_contract.py 12.1 KB
- 📄 test_low_context_pipeline.py 16.6 KB
- 📄 test_main_cli.py 2.8 KB
- 📄 test_mode_path_regressions.py 2.8 KB
- 📄 test_mode_simplification.py 2.6 KB
- 📄 test_preset_background_patterns.py 6.1 KB
- 📄 test_priority_preset_reference_contracts.py 1.7 KB
- 📄 test_quality_eval.py 9.6 KB
- 📄 test_review_checklist.py 3.8 KB
- 📄 test_style_fidelity.py 1.4 KB
- 📄 test_style_reference_completeness.py 7.9 KB
- 📄 test_swiss_modern_reference_contract.py 3.3 KB
- 📄 test_title_browser_qa.py 4.1 KB
- 📄 test_title_profile_registry.py 3.6 KB
- 📄 test_validate_console_output.py 957 B
- 📄 test_validate_css_vars.py 1.6 KB
- 📄 test_validate_default_chrome.py 1.8 KB
- 📄 test_validate_js_engine_contract.py 10.3 KB
- 📄 test_validate_priority_preset_contracts.py 7.0 KB
- 📄 test_validate_title_balance.py 4.9 KB
- 📄 test_validate_visual_variety.py 4.5 KB
- 📄 test_workflow_polish.py 1.5 KB
- 📄 validate.py 47.9 KB
📁 themes/
- 📁 _example-coral-dawn/
  - 📄 reference.md 6.8 KB
  - 📄 starter.html 41.1 KB
- 📄 README.md 1.5 KB
- 📄 README.zh-CN.md 1.6 KB
📄 .gitignore 778 B
📄 _config.yml 307 B
📄 check-doc-sync.py 5.1 KB
📄 main.py 4.6 KB
📄 README.md 25.3 KB
📄 README.zh-CN.md 25.0 KB
📄 SKILL.md 8.0 KB
📄 slide-creator 134 B

SKILL.md

---
name: kai-slide-creator
description: 生成HTML演示文稿/幻灯片 — 21 种风格模版，播放/演讲者模式。适用于路演、产品发布、技术分享、方案宣讲等场景。
version: 2.23.2
metadata: {"openclaw":{"emoji":"🎞","os":["darwin","linux","windows"],"homepage":"https://github.com/kaisersong/slide-creator","requires":{"bins":["python3"]},"install":[]}}
---

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

## 使用方式

```bash
/slide-creator --plan [prompt]       # 生成 BRIEF.json（IR）
/slide-creator --generate            # 从 BRIEF.json 生成 HTML
/slide-creator --review [file.html]  # 17 项检查点自动优化
/slide-creator                       # 交互式创建（先看风格预览）
```

`/slide-creator ...` 是 Claude/OpenClaw 的 slash 技能调用，不是 bash/python 命令。原始沙箱里请改用 `python3 main.py --validate-brief ...` / `python3 main.py --generate ...`。

**规划深度：**
- `自动` (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|


## 命令路由

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

| 命令 | 加载内容 | 行为 |
|------|----------|------|
| `--plan [prompt]` | `references/brief-template.json` | 创建 `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，并执行写入前门禁 |
| `--review [file.html]` | `references/review-checklist.md` + 目标 HTML | 执行 17 项检查点 → 确认窗口 → 修复/报告 |
| 无 flag (交互式) | `references/workflow.md` + 其他按需 | 遵循 Phase 0-5 |
| 直接给内容 + 风格 | 同 `--generate` | 立即生成，执行同一套写入前门禁 |

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

## 核心规则（按优先级）

1. **风格强制**
   所有颜色、字体、组件、背景、动画、图表色、signature elements 都**必须且只能**来自选中的风格文件。模板里的 `[from style file]` 和示例值只是占位，禁止直接使用。  
   **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 前必读此文件。

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

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

```bash
python3 tests/validate.py "$TMP_HTML" --strict
```

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

**核心门禁顺序：**

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` 堆砌。

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`
- **内置风格文件位置**：统一在 `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`

## 面向 AI 智能体

```bash
/slide-creator 为 [主题] 制作路演 deck
/slide-creator --plan "Acme v2 产品发布"
/slide-creator --generate
/kai-html-export presentation.html
/kai-html-export --mode native presentation.html
```

- `BRIEF.json` 已存在 → 直接读取并作为真相源
- 只有在用户明确要求人工审阅时才派生 `PLANNING.md`
- 现有 HTML 增强遵循 `references/workflow.md` 的 Enhancement Mode

## 相关技能

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

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

kai-slide-creator

Directory Structure

SKILL.md

Report

Notice