Agent 做深度分析、代码 review 或方案整理时，最常见的交付物还是一大段 Markdown。它方便写，但当内容变得很密、需要反复分享、审阅和沉淀时，Markdown 很快会变成“长卷轴”。Agent-HTML 想解决的就是这个问题：让 agent 写语义化文档，再渲染成稳定、可分享的 HTML artifact。
它定义了一种 .agent.html 文档格式。Agent 不直接写自由 HTML、CSS、JavaScript、Tailwind class 或 renderer props，而是写内容结构：page、card、summary 等语义节点。视觉风格则通过受控的 style-ref 选择，比如 report-default 或 ops-compact。这样做的好处是，agent 不容易把样式写飞，输出也更像一个可维护的公共契约。
使用方式很直接：安装 npm 包 @agent-html/ahtml，运行 ahtml prompt 获取写作提示，让 agent 产出 artifact.agent.html，再用 ahtml build 或 ahtml preview 渲染和预览。对于 Codex 或其他支持 skills 的 agent，还可以安装 ahtml skill，让它知道什么时候应该输出这种结构化 artifact。
我觉得它的关键不是“把 Markdown 换成 HTML”这么简单，而是把 agent 的输出边界收紧了。Schema 是公开契约，agent 负责内容结构，runtime 负责 sanitization、样式和组件渲染。对于报告、review、调研、运营复盘这类密集信息，读者看到的是一个清晰页面，而不是一坨样式随机的 HTML。
项目当前 MIT 开源，GitHub 约 258 stars，官网文档在 agent-html.pages.dev，仓库里也包含 desktop workbench、examples、spec、packages 和 ahtml skill。它还在 roadmap 里提到更多 UI foundation、静态/交互组件数据结构分离、custom component panel 和云服务方向。
适合它的场景很明确：你经常让 agent 生成可交付的报告、审计结果、产品文档、实验记录，且希望这些内容能在团队里以更稳定的视觉结构流转。把 agent 当“写页面的人”很危险，但把 agent 限定在一个语义 schema 里写文档，反而很像给它铺了一条更稳的轨道。
项目地址
文档：https://agent-html.pages.dev/
项目地址：https://github.com/Sayhi-bzb/Agent-HTML
原创文章，如若转载，请注明出处：https://wefound.cc/p/2635.html
