核心用法
kai-report-creator 是一款面向中英文用户的智能报告生成技能，专门用于创建美观、单文件、零依赖的HTML报告。用户可通过 /report 命令配合多种 flag 灵活操作：
- `--plan "主题"`：先生成中间表示文件(
.report.md)，确认结构后再渲染 - `--generate [文件]`：将计划文件渲染为最终HTML
- `--from 文件`：从原始笔记、数据或URL直接生成
- `--review`：自动优化已生成的报告
- `--themes`：预览6种内置主题
- `--export-image`：导出PNG/移动端/桌面端截图
内容驱动的工作流：用户负责提供真实数据，AI负责结构与视觉设计。禁止编造数字，缺失数据使用[数据待填写]占位。支持自动语言检测（CJK字符>10%判定为中文），并依据内容密度自动分类为narrative（叙事<5%）、mixed（混合5-20%）、data（数据>20%），从而智能选择视觉锚点（callout/timeline vs KPI/chart）。
显著优点
技术架构先进：单文件HTML，CSS/JS内联或CDN引用，无需npm/build工具，可嵌入任何地方。响应式设计，移动端友好。内置三层机器可读结构（summary JSON→section annotations→component raw data），下游AI可高效解析。
视觉系统专业：6种主题（corporate-blue/minimal/dark-tech等）+ 自定义CSS变量覆盖。组件丰富：KPI卡片、ECharts图表（bar/line/pie/radar/funnel/sankey）、表格、时间线、流程图、思维导图、代码块、图片布局等。
质量控制严格：8项硬性规则（KPI值≤8汉字/3英文词、时间线必须含真实日期、禁止FE0F变体选择符等）+ 预写入验证三层检查。自动检测并修复模板标题、占位图表、伪时间线等反模式。
潜在缺点与局限
数据依赖性：data类报告需用户输入真实数字，纯占位KPI会被降级为callout。不适用于完全无数据的概念性文档。
复杂图表限制：Sankey桑基图需特定source→target:value三元组数据结构；复杂自定义模板需理解HTML占位符机制。
导出依赖：图片导出需额外安装playwright，非内置功能。
学习曲线：IR中间格式、内容分类规则、视觉节奏控制等概念对新手有一定门槛。
适合人群
- 商业分析师/PM：快速产出季报、销售看板、项目复盘
- 研究团队：学术论文、调研报告、白皮书
- 技术团队：架构文档、API文档、性能分析报告
- 运营/市场：KPI仪表盘、活动数据总结、竞品分析
常规风险
数据真实性：系统明确禁止编造数据，但用户需自查填充的占位值。
浏览器兼容：依赖现代CSS特性，IE不支持；ECharts在部分移动端需测试。
安全注意：生成HTML含内联JS，分享时需确认无恶意脚本注入（本skill本身无此风险，但自定义模板可能引入）。
版本迭代：--review模式为单次自动优化，非交互式，重要报告建议人工复核。