核心用法
kai-slide-creator 是一个基于 IR-first 架构的 HTML 演示文稿生成技能。用户通过 /slide-creator 命令调用,支持两种规划深度:
- 自动模式(Auto):3-6分钟快速出稿,适合时间紧迫场景
- 精修模式(Polish):8-15分钟深度规划,自动执行 Review 流程
工作流程:user prompt → BRIEF.json → HTML → validate,必须先生成有效的 BRIEF.json 中间表示,再通过统一渲染器生成最终 HTML,并在写出前通过 python3 scripts/validate_html.py 严格校验。
核心命令:
--plan [prompt]:创建BRIEF.json规划文件--generate:从BRIEF.json生成完整 HTML--review [file.html]:执行 17 项检查点质量审查
显著优点
1. 22种专业风格模版:覆盖 Data Story、Enterprise Dark、Swiss Modern、Blue Sky、Neon Cyber 等场景,从商业路演到技术文档均有适配
2. 零依赖纯浏览器运行:生成单文件 HTML,无需服务器或外部资源即可播放
3. 严格的风格强制机制:颜色、字体、组件、动画完全来自选中风格文件,确保设计一致性
4. 内置演讲者模式:支持 data-notes 演讲备注、进度条、导航点等完整播放功能
5. 渐进式架构:Blue Sky 风格保留独立 #stage/#track 架构,其他风格统一走共享壳子
6. CJK 优化:自动追加 Noto Sans SC/JP/KR 字体支持
潜在局限
1. 生成时间较长:精修模式需 8-15 分钟,不适合极紧急场景
2. Python3 依赖:需要本地安装 Python3 执行验证脚本
3. 风格学习成本:22种风格的选择需要参考 style-index.md,新用户可能困惑
4. 严格校验可能失败:17项预写入门禁任一失败都会导致生成失败,需迭代修复
5. 编辑模式可省略但默认开启:在现有 HTML/导入场景下可能产生冲突
适合人群
- 创业者/产品经理:需要快速制作 VC Deck 或产品发布 PPT
- 技术团队:API 文档演示、技术分享、内部培训材料
- 咨询顾问:战略方案宣讲、客户汇报
- 研究人员:思想领导力内容、学术演讲
- 创意工作者:个人品牌展示、作品集
常规风险
- 路径混淆:
--plan只生成BRIEF.json,不接触 CSS;直接给内容必须先落BRIEF.json再走渲染器,禁止手拼最终 HTML - Swiss Modern 特殊要求:必须使用
.slidedirect child、canonical token 命名和data-export-role,禁用兼容别名 - 水印注入位置:必须是 JS 注入到最后一页,
position: absolute,禁止fixed - inline style 限制:目标 0 处,硬上限 5 处