核心功能
kai-report-creator 是一款专门用于生成精美单文件HTML报告的技能,覆盖商业报告、数据看板、研究文档、KPI仪表盘等场景。其核心设计理念是"零依赖、高可读、AI友好"——输出文件为独立的HTML,内嵌所有CSS/JS或通过CDN加载,无需npm或构建工具即可直接打开或嵌入任何系统。
显著优点
1. 完整的功能体系
- 7套内置主题:corporate-blue(商务)、minimal(学术)、dark-tech(技术)、dark-board(项目看板)、data-story(数据叙事)、newspaper(新闻编辑)、regular-lumen(周期报告)
- 丰富的可视化组件:KPI卡片(带趋势指示)、ECharts图表(bar/line/pie/radar/funnel/sankey)、时间线、流程图、思维导图、数据表格、Callout提示框
- 智能主题路由:根据关键词自动推荐最佳主题(周报→regular-lumen、销售→corporate-blue、技术→dark-tech等)
- 三阶段工作流:
--plan生成中间表示文件(.report.md)→--generate渲染HTML →--review自动优化
2. AI友好的机器可读层
报告HTML内嵌三层结构供下游AI解析:summary JSON → section annotations → component raw data,实现报告在AI pipeline中的无缝流转。
3. 严格的内容质量控制
- 硬性规则:KPI值≤8中文字符、时间线必须含真实日期、禁止占位符图表
- 内容分类:narrative(<5%数字)、mixed(5-20%)、data(>20%)自动路由不同视觉策略
- 防伪造机制:所有缺失数据使用
[数据待填写]占位,绝不编造数字
潜在缺点与局限性
1. 技术门槛
--export-image功能依赖Playwright(需pip install playwright && playwright install chromium),非开箱即用- 自定义主题需理解CSS变量覆盖机制
- sankey图等高级图表需要严格的
nodes+links数据结构
2. 内容约束
- 严格禁止"模板式标题"(如"核心能力""背景介绍"),强制使用信息型标题,增加编写认知负担
- narrative/mixed类报告禁止纯占位KPI/图表,可能降低"视觉丰富度"预期
3. 生态局限
- 图表库锁定ECharts,Chart.js已废弃
- 导出PPTX/PNG需配合
kai-html-export技能,非原生支持
适合人群
- 商业分析师:快速产出销售报告、季度复盘、KPI仪表盘
- 产品经理:生成PRD摘要、竞品对比、用户研究报告
- 技术团队:架构文档、API文档、部署手册(dark-tech主题)
- 咨询顾问:客户交付物、行业研究、白皮书(minimal主题)
- 运营团队:周报日报、项目进展、数据看板(regular-lumen主题)
常规风险
1. 内容幻觉风险
虽然规则禁止编造数据,但复杂报告的--plan阶段可能过度推断用户意图,需人工审核.report.md文件。
2. 视觉一致性风险
自定义theme_overrides若未遵循色彩规范,可能破坏可读性(尤其dark主题)。
3. 下游解析依赖
机器可读层格式变更可能导致依赖该结构的AI agent失效,需关注版本更新。
4. 移动端兼容性
虽然声明mobile responsive,但复杂表格和大型sankey图在小屏上的可用性仍需实测验证。
---
版本:1.20.0 | 来源:OpenAI生态系统内置技能