SuperAPI AI 工具集

report-with-html

前端与建站

查看项目

更新于 10-16 08:35

技能介绍

用途与触发边界:该技能在需要交付可视化 HTML 报告或交互式信息工具时使用,典型产物包括系统/架构/流程/因果/决策/对比/差距视图、面向客户的数据报告或单页、数据/档案浏览器或评审工作台,以及用户明确要求的 HTML/Web 演示。普通状态回复、一般评审、代码 diff、问题清单或 Markdown 文档不触发。默认交付为在浏览器中打开并验证过的 HTML;PNG 仅作质检产物,只有用户要求图片时才交付;若需可编辑 PowerPoint,先完成并验证 HTML,再使用 deck-creator(Route C)。

主要能力:先确定受众、页面要支持的决策或理解、以及权威来源,再选择组件;每个数字需带单位、日期/窗口与可追溯来源,未知值保持未知。页面骨架由问题决定:机制/架构/流程、决策与权衡、带时间戳的因果链、实体×标准的对比、集合浏览等。实现状态只作为徽标呈现,缺失依赖、未验证结果必须可见。统计图表使用已安装的成熟图表能力或项目声明的图表栈,不手写图表引擎。几何编码需有明确编码键和数据支撑读数;颜色承载类别或状态而非第二个独立度量。交互遵循可访问性:原生按钮/链接/对话框、可见关闭控件与 Escape、焦点保持与恢复、语义 HTML 与 ARIA。

使用方式:先阅读必读来源——design-principles.md、references/visualization-patterns.md、approved-examples.md 中最接近的条目,以及 data-visualization-discipline;再按需加载组件参考。分类与编排使用 assets/report-template.html 或已批准示例作为起点。交付流程包含运行交付闸门与渲染:uv run <skill-dir>/scripts/delivery_gate.py init page.html [--height 9600],填写 page.html.gate.md 各槽位后运行 uv run <skill-dir>/scripts/delivery_gate.py check page.html(不通过则退出码为 1);重新渲染使用 <skill-dir>/scripts/render_report.sh page.html page.png 1300 2400(H 为示例非默认);分段查看使用 uv run <skill-dir>/scripts/crop_segments.py page.png --segments 5。CI 或共享浏览器环境需设置 CHROME_BIN。

限制:资料未提供该技能的收费、价格、平台支持范围与具体效果数据;其本地路径、组件前置条件与交付目录需依据具体项目和调用 Skill 的约定,资料未提供时暂未提供。