报告积木

解决什么问题

在 AI Agent 自动生成分析报告时，往往会遇到排版碎片化、数据呈现缺乏层次感以及图表信息缺失等痛点。开发者常需要花费大量时间在 HTML/CSS 调试和图表标注上，导致报告交付效率低下且视觉一致性差。

核心能力与工作流

该技能通过结构化的积木组件来解决上述问题。首先，Agent 会读取 references/reports.md 以获取标准化的 Blocks、embeds 和工作流定义。接着，结合 report-shell.reference.html 中的现成 HTML/CSS/JS 模板，快速构建离线可用的报告页面。
在内容组装阶段，技能吸收了多种优秀实践：

• 采用 folio / datainpane 的块组合与 KPI 条设计，实现离线 HTML 的清晰布局。
• 借鉴 report-creator 的 Mermaid 图表代码化与指标分组能力。
• 引入 Evidence.dev 的价值盒层级（KPI → 文本 → 图表），确保数据到结论的平滑过渡。
• 强制执行 Cursor canvas 的图表标注规范（标题、坐标轴、数据源），杜绝信息断层。

适用边界与注意点

使用该技能时需严格遵守“证据优先”和“科学严谨”的基调。默认视觉外壳为海军蓝/石板灰（navy/slate），排版细节仅参考 analysis-reports.md 中的字体排印规则。它更适合需要深度数据分析与结构化输出的研发场景，而非轻量级的快速摘要。