核心定位
kai-report-creator 是一款面向 AI 工作流的专业报告生成技能，主打「零构建依赖、单文件输出、机器可读」三大特性。用户通过 Markdown 风格的中继格式（IR）描述内容，AI 将其渲染为自包含的 HTML 文件——CSS/JS 全部内联或走 CDN，无需 npm、无需打包，双击即可在浏览器打开，也可嵌入邮件、IM 或文档系统。
核心用法
技能通过 /report 命令暴露四个主要模式：
--plan：根据主题生成.report.md中间文件，包含完整 frontmatter、章节结构与占位符，供用户填充数据后再渲染；--generate：读取 IR 文件，按「主题 CSS → 共享 CSS → 覆盖层」顺序组装样式，渲染 KPI、图表、时间轴、流程图等组件，输出单 HTML；--review：对已生成的 HTML 执行一键自动审校，依据 8 项检查点修正硬规则违规（如 KPI 值长度、时间轴有效性）；--themes：输出主题预览页，展示 7 套内置风格（corporate-blue、minimal、dark-tech 等）。
内容以「标签围栏」语法声明组件，如 :::kpi、:::chart type=bar、:::timeline，plain Markdown 则自动渲染为富文本。图表统一使用 ECharts，支持 sankey、funnel 等高级可视化。
显著优点
1. 架构洁癖：单文件、零依赖、移动端自适应，解决了 BI 工具「链接失效、样式错乱、导出困难」的痛点。
2. AI 优先设计：HTML 内嵌三层机器可读结构（summary JSON → section 注解 → component 原始数据），下游 Agent 可快速解析，无需 OCR 或 DOM 遍历。
3. 渐进式披露：--plan 与 --generate 分离，让「结构规划」与「数据填充」成为可协作的异步流程。
4. 设计质量内建：硬规则（KPI 值≤8 汉字、无 U+FE0F、时间轴须为真日期）在生成前强制执行，配合「视觉节律」规则（禁止 3 段以上连续纯文本）保证可读性。
5. 内容类型感知：自动检测叙事型（narrative）、混合型（mixed）、数据型（data）三种密度，避免在文字报告中硬塞空 KPI 或装饰图表。
潜在缺点与局限
- 数据准备门槛：虽支持从 raw notes 或 URL 生成，但复杂报告仍需人工整理为 IR，无法直接对接数据库或 API 实时拉取。
- 图表交互受限：单文件架构决定了重度交互（实时筛选、钻取）需额外开发，技能定位为「静态报告」而非「动态仪表盘」。
- 主题定制需 CSS 知识：自定义主题需覆盖 CSS 变量，对非前端用户不够友好。
- 审查模式为单次自动：
--review无人机确认环节，高敏感场景建议人工复核。
适合人群
- 产品经理、运营、分析师：需快速产出可分享的季度复盘、数据周报。
- 咨询与研究团队：撰写白皮书、竞品对比、用户调研，要求格式统一、便于归档。
- AI 平台开发者：需要「人类可读 + 机器可读」双模报告，作为 Agent 工作流的输出节点。
- 对「PPT 转 PDF 再截图」流程感到厌倦、希望一份源文件多端可用的效率追求者。
常规风险
- 占位数据误用：技能严格禁止编造数字，使用
[数据待填写]占位；若用户未检查直接分发，可能导致信息缺失。 - 浏览器兼容性：ECharts 与 CSS 变量在 IE11 及以下不支持，企业内部老旧系统需测试。
- 图片导出依赖 Playwright：
--export-image需本地安装 Chromium，容器化部署时需额外处理。 - 敏感数据泄露：单 HTML 文件包含全部内容，分享前需脱敏，避免通过公开链接直接传播含内网数据的报告。