SuperAPI AI 工具集

html-report

写作与研究

查看项目

更新于 10-16 07:58

技能介绍

用途:把用户要的“报告/总结页/写up”做成一个自包含、样式完善的交互式 HTML 文件,并发布到 GitHub Pages。它针对 Claude 默认输出 markdown 的倾向,鼓励用 HTML 的交互能力呈现数据、对比、代码和细节。

主要能力:可用 Chart.js/Plotly 等做交互图表、DataTables 等做可排序过滤表格、标签页做对比、details 折叠长内容、highlight.js 高亮代码并配复制按钮、Mermaid/Graphviz 画架构流程图、KaTeX 排公式、悬停提示与弹窗、暗色模式、粘性目录、响应式与打印样式。每个报告建议至少使用其中三种交互元素。

使用方式:先规划标题结论、分段与对应交互,然后基于 templates/base.html 生成一个 HTML 文件,路径为 <repo>/<reports_dir>/<YYYY-MM-DD>-<slug>.html,所有库走 CDN,无构建步骤,自定义 CSS 和 JS 各放一个块,并设置 title、description、viewport 与 Open Graph 标签。发布执行:python3 <skill-dir>/scripts/publish.py <html-path-relative-to-repo> "<title>" "<one-line description>"。脚本会更新 manifest.json、git add、commit、push 并打印公开 URL。草稿模式可加 --draft,跳过提交推送并返回本地路径。配置读取同目录 config.json,local_repo_path、reports_dir、base_url 多数可自动检测。

适用场景:含数据的分析、多方案对比、代码说明、较长的研究报告。

限制与反模式:不适用于一句话回答、一次性调试输出、用户明确要求 markdown、或要放进用户项目文件的代码。需单文件、CDN、无构建,保持移动端 375px 可读,暗色模式可持久化,尊重 prefers-reduced-motion,避免仅段落列表伪装 HTML、静态图表、无排序的大表格、无高亮代码墙、移动端溢出的图表等。