核心用法
kai-report-creator 是一款面向复杂报告生成场景的专业技能，支持通过 --plan 创建结构化中间表示（IR）、--generate 渲染为独立HTML文件、--review 自动优化、--themes 预览主题等完整工作流。
典型使用路径：
1. 规划阶段 (/report --plan "主题")：生成分层结构的 .report.md 文件，自动识别内容类型（narrative/mixed/data）并推荐视觉锚点
2. 生成阶段 (/report --generate file.report.md)：读取IR文件，渲染为包含ECharts图表、KPI卡片、时间线、桑基图等组件的独立HTML
3. 优化阶段 (/report --review file.html)：一键自动修复设计硬规则违规（如KPI值长度、通用标题重写）
核心组件： KPI卡片（支持趋势指示）、ECharts图表（bar/line/pie/radar/funnel/sankey）、时间线、流程图/思维导图、标注块（callout）、数据表格。
技术特性：
- 零依赖构建：单HTML文件内联所有CSS/JS，支持CDN或完全内联（
--bundle） - 三层AI可读结构：JSON摘要 → 区块注释 → 组件原始数据，便于下游AI代理解析
- 智能内容路由：基于数字密度自动分类内容类型，narrative类禁用占位符KPI/图表
- 严格设计约束：8项硬规则（KPI值≤8中文字符、无通用H2标题、无U+FE0F变体选择符等）
- 多主题支持：6款内置主题（corporate-blue/minimal/dark-tech等）+ 自定义品牌主题
显著优点
1. 工程化完整性：从内容分析、结构规划、视觉渲染到自动审查的闭环工作流，减少人工校验成本
2. 跨端一致性：移动端响应式布局与桌面端等效体验，内置导出PNG/打印支持
3. 数据诚信机制：禁止伪造数据，缺失值使用 [INSERT VALUE] 占位符，narrative报告自动降级视觉组件
4. 扩展性设计：自定义模板（--template）、主题覆盖（theme_overrides）、自定义组件标签（custom_blocks）
潜在局限
- 导出依赖外部工具：PNG导出需
playwright环境，非纯内置方案 - 图表库单一：仅支持ECharts，复杂定制图表需手动扩展
- 审查自动化边界：AI建议类规则（如内容准确性）仍需人工确认，非全自动
- 主题覆盖粒度：CSS变量覆盖机制对高级交互组件样式控制有限
适合人群
- 商业分析师：季度财报、KPI仪表盘、销售数据看板
- 产品经理：竞品分析、用户研究报告、项目复盘文档
- 研究人员：学术白皮书、调研报告、数据叙事文档
- 技术团队：架构文档、API文档、系统性能报告（推荐dark-tech主题）
常规风险
| 风险类型 | 说明 | 缓解机制 |
|---------|------|---------|
| 数据幻觉 | AI可能生成看似合理但虚假的数据 | 强制占位符机制 + narrative/mixed/data分级路由 |
| 设计质量滑坡 | 通用标题、过长KPI值、破坏视觉节奏 | 8项硬规则自动扫描 + 静默最终审查 |
| 可访问性缺陷 | 移动端功能隐藏、对比度不足 | L1设计质量检查强制修复 |
| 输出文件损坏 | 未转换的`:::`指令残留 | L0内容检查强制转换 |
| 主题覆盖失效 | 自定义CSS变量与共享样式冲突 | CSS组装顺序标准化（theme → shared → post-override → TOC） |