核心用法
kai-slide-creator 是一款基于 IR-first(中间表示优先)工作流的 HTML 幻灯片生成技能。用户通过自然语言描述需求,系统首先生成结构化的 BRIEF.json 规划文件,再据此渲染为纯浏览器运行的零依赖 HTML 演示文稿。
两种工作模式:
- 自动模式 (Auto):3-6 分钟快速出稿,适合时间紧迫的标准场景
- 精修模式 (Polish):8-15 分钟深度规划,自动执行 Review 检查,适合关键场合
使用流程(Phase 0-5):
1. Phase 0:需求解析与内容类型识别
2. Phase 1:生成 BRIEF.json 结构规划
3. Phase 2:风格选择与 composition 路由确定
4. Phase 3:HTML 生成与预写入验证
5. Phase 3.5:Review 检查(精修模式自动执行)
6. Phase 4-5:交付与可选导出
核心命令:
/slide-creator --plan [prompt]:创建内容规划/slide-creator --generate:从 BRIEF.json 生成 HTML/slide-creator --review [file.html]:执行 17 项质量检查/slide-creator(无 flag):交互式引导
显著优点
技术架构优势:
- 零依赖:生成纯 HTML/CSS/JS,无需构建工具,浏览器直接打开
- IR-first 设计:中间表示层(BRIEF.json)实现内容与表现分离,便于迭代修改
- 21 种专业风格:覆盖商业路演(Bold Signal、Aurora Mesh)、数据报告(Data Story、Enterprise Dark)、技术文档(Terminal Green、Neon Cyber)、创意品牌(Vintage Editorial、Neo-Brutalism)等场景
- 智能风格匹配:内置内容类型到风格的推荐映射表
功能特性:
- 演讲者模式(Presenter Mode)与播放控制
- 响应式设计与滚动吸附导航
- CJK 字体优化(自动加载 Noto Sans SC/JP/KR)
- 水印与编辑模式可选开关
- 预写入验证管道:9 道门禁确保输出质量
潜在缺点与局限性
内容生成约束:
- 依赖 LLM 的内容理解能力,复杂叙事结构需要用户多次迭代
- 图表/数据可视化依赖 CSS 实现,不支持复杂交互图表
- 多媒体(视频、音频)支持有限
风格系统限制:
- 自定义主题需遵循特定文件结构(
themes/<name>/reference.md) - Blue Sky 风格使用独立架构(
#stage/#track),与其他风格不兼容 - Swiss Modern 风格有严格的 canonical export 路径要求
工作流门槛:
- 需要理解 IR-first 概念,新手可能有学习曲线
- 精修模式耗时较长(8-15 分钟),不适合极紧急场景
- 17 项 Review 检查点可能过度严格,某些边缘场景会触发不必要的修复循环
适合人群
- 创业者/产品经理:快速制作投资人路演 Deck、产品发布演示
- 技术布道者:生成 API 文档演示、技术分享幻灯片
- 数据分析师:制作数据故事(Data Story)类型的 KPI 看板
- 咨询顾问:方案宣讲、客户提案的标准化输出
- 设计师/开发者:需要零依赖、可版本控制的 HTML 演示格式
常规风险
内容准确性风险:
- LLM 可能误解用户意图,生成与需求不符的内容结构
- 建议关键场合使用「精修模式」并人工审阅
BRIEF.json
风格一致性风险:
- 多轮迭代中可能出现 token 使用不一致(如混用
--bg与--bg-primary) - 强制风格规则可能限制创意表达
技术兼容风险:
- 旧版浏览器可能不支持
scroll-snap等现代 CSS 特性 - CJK 字体加载失败时的回退机制依赖网络环境
知识产权风险:
- 生成的内容基于 LLM 训练数据,商业使用前建议审查版权合规性