agent-html 图标 agent-html v1.0
一个让 Agent 输出干净单文件 HTML 的小 Skill

让 Coding Agent 生成干净好看的单文件 HTML

本质就是个轻量 Skill,教大模型输出不带 CDN 依赖、自带微 CSS 的单文件 HTML。
借鉴 shadcn 的冷灰色调与 1px 细线,告别大模型自由发挥时的粗糙塑料感。

$ npx skills add QingYunA/agent-html
浏览 6 套常用母版 查看基础组件
0 npm
零外部构建流程,没有任何 node_modules
100% 离线
双击直接在浏览器打开,内网绝不白屏
6 套模板
长文档、监控大盘、双栏工作台、对比、时间轴、看板
Agent Skill
支持 Claude Code、Cursor、Pi、Codex 等

6 套开箱即用的布局模板

大模型自由发挥容易排版错乱。直接套用现成结构,清晰又省心。

单栏长文档与系统评估报告母版

860px 居中标准阅读视口,针对技术评审、架构审查、面试评估与打印 PDF 深度优化。具备元数据标头、评分栏、结论 Callout、折叠手风琴与一键导出 Markdown。

中文报告母版预览

业务指标监控与实时过滤数据大盘

宽屏流式响应式网格布局。内置 4 列 KPI 统计卡片、纯原生响应式 SVG 走势图与柱状图、双重实时过滤工具条(搜索+状态下拉)、原生模态弹窗与一键复制表格 Markdown。

中文大盘母版预览

左右双栏工作台与数据审查器 (100vh)

视口充满型工作台应用。左侧 320px 边栏支持快速检索过滤用例列表,右侧详情区动态响应渲染选中条目属性、人工审查裁决操作组(通过/修复/拒绝),以及一键将裁决结论复制发回终端 Agent。

中文工作台母版预览

并排横向对比与 A/B 评测矩阵

双栏左右并排对比布局(基准方案 vs 升级挑战方案)。内置核心胜出判定 Callout、参数规格对决、输出快照对比、量化 Delta 差异对照表以及一键复制对比 Markdown 摘要。

中文对比矩阵母版预览

事件垂直时间轴与突发故障编年史

高信息密度单轨垂直时间线。具备语义化状态圆点(故障、警告、恢复、信息)、精确时间戳与操作人标签、可展开诊断日志,以及一键将时间线完整复制为 Markdown。

中文时间轴母版预览

任务缺陷分拣与敏捷拖拽看板

4 列分类流转看板(Backlog、进行中、阻塞阻断、已完成)。零外部库依赖,纯原生 HTML5 Drag & Drop(~35 行原生 JS 驱动),提供一键复制分拣结果回发 Agent 闭环。

中文看板母版预览

为什么坚决追求零 CDN 自包含?

对比 AI Agent 生成前端页面的三种典型实现路径。

CDN 依赖陷阱
Tailwind CDN 运行时
模型习惯注入 <script src="cdn.tailwindcss.com"> 与远程字体。
  • ✕ 企业离线环境 / 隔离机房彻底白屏失效
  • ✕ 2 秒 JS 运行时解析开销,伴随严重排版闪烁 (FOUC)
  • ✕ 触发严格企业内网的内容安全策略 (CSP) 拦截
  • ✕ 外部 CDN 节点漂移失效导致长期归档文件损坏
AI 视觉塑料陷阱
随意手写内联 CSS
禁用 CDN 后,大模型容易自由发挥产生不可控的视觉漂移。
  • ✕ 产生不协调的纯黑 1px 粗暴边框与失衡留白
  • ✕ 表格列宽失衡,缺少移动端自适应
  • ✕ 零暗黑模式支持,夜晚查看极其刺眼
  • ✕ 每次会话自由命名 CSS 类,完全无法复用

基础原子组件与矢量图表

开箱即用的 HTML 片段:按钮体系、胶囊徽章、原生微交互、6 大纯原生 SVG 图表与 24 个矢量图标。

按钮体系与状态徽章 交互可用
覆盖 Primary、Secondary、Outline、Ghost、Destructive 以及图标尺寸变体。
按钮变体
带图标与尺寸组合
语义状态徽章
200 OK 正常 Warning 预警 Critical 阻断 In Progress 处理中 中性默认
原生微交互基元 原生 DOM
零依赖原生弹窗、手风琴折叠面板与决策结论提示框。
原生 <dialog> 模态弹窗
自带背景虚化遮罩、ESC 自动关闭、0 第三方库
可折叠 <details> 诊断日志手风琴
无需任何 JavaScript,用于超长排障 Trace 日志、执行细节、长文本折叠等场景。
执行摘要提示框 (Callout) 突出展示架构评审结论、安全性检测判定或灰度发布准入意见。
零 CDN 纯原生 SVG 图表(6 大核心形态) 零外部库 · 精准调色
基于原生 SVG 矢量曲线绘制。100% 离线自包含、零 JS 图表库依赖、Retina 高清视网膜渲染、自动适配深浅主题。
24h 请求吞吐量 (TPS) ↑ +18.4%
各阶段响应延迟分布 (ms) P95 统计
24ms 48ms 92ms 35ms 18ms
集群健康度全景占比 99.8% 达标
1,280 节点
● 65% 正常832
● 25% 预警320
● 10% 降级128
出入网络流量对冲
— 入向 1.4G ┄ 出向 860M
核心模块耗时排行 P95 ms
DB 连接池等待280ms
大模型首字生成 (TTFT)195ms
网关鉴权校验 (JWT)48ms
边缘静态资源缓存12ms
集群内存占用水位 正常负荷
78.4% 已使用 15.6 / 20 TB 0% 100%
纯前端实时过滤数据表
5 行纯原生 JavaScript,不需要引入任何前端框架即可实现客户端毫秒级检索。
Trace 编号 所属集群服务 响应耗时 显存占用 当前状态
tr-0812-alpha 网关认证接入中心 (Auth-Gateway) 14ms 128 MB 正常
tr-0812-beta 大模型推理执行管道 (Worker-Pool) 420ms 4.2 GB 优化达标
tr-0812-gamma 异步队列缓存调度 (Redis-Pipeline) 1.2s 890 MB 负载偏高
tr-0812-delta 分布式指标实时采集 (Telemetry) 88ms 340 MB 流式收集中
精选 24 研发与运维纯矢量 Lucide 风格图标 点击任意图标即可将 SVG 代码复制至剪贴板
采用 stroke="currentColor",能够随父级字色自动适配深浅主题。零字体依赖,100% 离线可用。
搜索 (Search)
成功 (Check)
告警 (Alert)
复制 (Copy)
日历 (Calendar)
终端 (Terminal)
过滤 (Filter)
外链 (External)
用户 (User)
折叠 (Chevron)
删除 (Trash)
下载 (Download)
分支 (Branch)
提交 (Commit)
合并请求 (PR)
缺陷 (Bug)
服务器 (Server)
数据库 (Database)
处理器 (CPU)
实时监控 (Activity)
防护 (Shield)
访问控制 (Lock)
刷新 (Refresh)
设置 (Settings)

日常提示词示例

日常跟 Agent 对话时可以直接使用的指令,避免生成枯燥的 Markdown 文本墙。

“不要输出 Markdown 墙。把这次系统架构审查的结论做成一个单文件可视化 HTML 报告,包含达标评分卡、执行摘要 Callout、可折叠的细项手风琴,并支持打印为 PDF。”
“生成一个单文件 HTML 监控看板,展示生产 API 延迟与吞吐大盘。包含 4 列 KPI 统计卡、纯前端实时搜索过滤表格,以及原生弹窗交互。”
“记录今天网关故障的突发事故复盘与时间轴编年史。单轨垂直时间线排版,带有明确时间戳、操作人标签,并支持一键复制为 Markdown 归档。”
“制作一个 4 列敏捷任务分拣拖拽看板,对这 20 个 Bug 工单按优先级进行分拣流转。支持纯原生 HTML5 跨列拖拽,并提供一键复制分拣决策回终端机制。”
“制作一个模型 A 与模型 B(或 Prompt v1 vs v2)的横向并排对比评测矩阵。左侧基准右侧挑战者,下方列出量化差异 Delta 对照表与最终胜出判定。”
“为这次排障调试会话创建一个左右双栏的 Master-Detail 查看器。左侧支持搜索过滤用例列表,右侧展示格式化 JSON Payload 并带有一键复制按钮。”
# 1. 通过 skills.sh 官方生态一键安装(支持 Claude Code, Pi, Cursor, Codex 等)
npx skills add QingYunA/agent-html -g

# 2. 或使用独立 CLI 在任意工程中导出指定母版
npx agent-html template dashboard > dashboard.html
npx agent-html check dashboard.html
原生 <dialog> 模态弹窗组件

完全采用浏览器原生 dialog 标签与 CSS backdrop 虚化滤镜构建。具备原生键盘焦点锁、无障碍支持与 ESC 一键关闭,不需要引入任何外部 JS 弹窗库。

已复制到剪贴板!