SuperAPI AI 工具集

hai-visual-report

办公与效率

查看项目

更新于 10-15 22:15

技能介绍

用途:把想法、需求、方案、评审结果或目标文档转成可读、可展示的多段 HTML 报告,生成真实的 .html 文件,包含标题、结论、图表、矩阵、分节与下一步。它不是单屏分享用的视觉卡片(那是 create-visual-card),也不是纯 Markdown 回答。

核心原则:先可视化结构,再打磨文案。先识别核心判断、参与者、关系、路线、风险与验证,再转成可扫读的 HTML 页面。

内容模型:默认八块——标题(标题、范围、生成日期)、结论(一句话结论与最重要判断)、结构图(Mermaid 或布局图,置于顶部附近)、核心分节(问题、目标、方案、用户、流程、架构、权衡、风险等,每节至少一个可视化对象)、决策矩阵、时间线/阶段、风险与证据、下一步。每块的可视化形式由内容决定:复杂关系用 Mermaid 图,清晰流程用时间线或步骤条,选项比较用矩阵,风险用网格,范围用纳入/排除面板。

工作流:先识别报告类型(想法、需求、目标、评审、架构风格),决定八块侧重;提取核心判断,信息缺失时说明假设而非编造,并让事实、假设、判断可见地分开;写前先读 references/output-template.md 与 references/html-skeleton.md(Tailwind + Mermaid 最小骨架);输出一个完整 .html 文件,优先放在 $TMPDIR/hai-visual-report-<topic>/ 等系统临时目录,用户指定路径时遵循;CSS/JS 内联或走 CDN(Tailwind CDN、Mermaid CDN 均可),避免项目本地资源,保持单文件可移植;中文请求用中文界面文案,英文请求用英文,代码标识符不变;做 QA 后返回绝对路径。

风格:安静、专业的报告风格,不是营销落地页;卡片只用于重复的发现、选项、风险、指标或提示。若来自架构评审,保留架构图优先、选项矩阵、为何不选替代方案、红蓝对抗评审(判断本身归 hai-architecture)。

输出骨架:报告类型、核心判断、生成的 HTML 绝对路径、QA 清单(是否生成、结论+图+下一步是否靠前、Mermaid 是否可读、是否多段而非一张长卡、文字是否溢出、事实与假设是否分开)。

限制与边界:需要单张视觉卡片或单屏摘要时用 create-visual-card;需要架构级判断(APoSD/Ousterhout 评审、模块边界批评)时用 hai-architecture,本技能只渲染报告,不产出架构结论。避免两个陷阱:装饰性页面掩盖结论与下一步;事实、假设、判断混在一起。