Claude 还在吐 Markdown？这个 Skill 让它学会在合适的时机甩出 HTML

Anthropic 工程师 Thariq Shihipar 在 2026 年写的那篇《The Unreasonable Effectiveness of HTML》火了之后，AI 输出格式的争论就从「要不要用 Markdown」升级成了「什么时候 Markdown 不够用」。9 月份 GitHub 上冒出来一个叫 dogum/html-artifacts 的 Skill，把这件事从「观点」变成了「产品」——单文件 HTML 工件，什么时候出 HTML、什么时候老实回到 Markdown，机器自己判。

这东西解决的是什么问题

一句话：让 Claude 知道什么时候该交一个能交互的 HTML 页面，而不是一份平铺直叙的 Markdown 报告。

• 对比表、架构图、流程图、带 SVG 的仪表盘、可以做滑块的原型 demo——这些内容 HTML 比 Markdown 信息密度高一截；
• 一次性的浏览器内编辑器，比如让你「拖一下分桶、改完导回 JSON」的小工具，单文件 HTML 跑得最顺；
• 给团队 review 的可视化周报、post-mortem、PR 写评，HTML 比干巴巴的 .md 更适合人脑。

它做对了什么

最值得抄的不是「输出 HTML」，而是它明确列出的「别乱出 HTML」的反向触发条件——

• 短对话回复、纯代码片段、终端式回答；
• 用户打算逐行再编辑、或者要进 git 走 diff 的内容（HTML diff 难看，作者自己也承认）；
• 30 行以内的轻量内容，老老实实用 Markdown。

这一点对应的是 Skill 生态里最常见的过度触发问题：作者怕 Claude 不调用，所以写得很激进，结果 Claude 动不动甩你一个 HTML 看着头皮发麻。html-artifacts 的做法是把它写成「判别启发式 + 例外条款」，并且用一套 7 个 eval 用例（包括 4 个「应该触发」+ 3 个「坚决不该触发」）去卡死边界，社区在做这个策略，GitHub 上 147+ Star 算是刚起步。

几个值得抄的设计点

• 渐进披露到极致：主文件只装识别规则 + 8 个二级标题索引，按需加载 8 个 references/exploration-and-planning.md 之类的子文件；
• verify-before-delivering 是 v2 才加的新规：能跑浏览器就 headless 截图、检查 console；跑不了就跑一遍阅读清单——作者说「这一条比任何样式建议都顶用」；
• 不是孤立的 skill，是 plugin marketplace 形态：/plugin marketplace add dogum/html-artifacts 一行装，配合 /plugin update 跟版本。

谁适合装

• 经常让 Claude 写周报、post-mortem、产品方案的 PM / TL；
• 写技术博客、需要交互原型的独立开发者；
• 团队里有人觉得「Markdown 太干」但又不想每次自己写样式的人。

怎么用

一行命令装：

/plugin marketplace add dogum/html-artifacts
/plugin install html-artifacts@html-artifacts

然后直接说「把这个 PR 写成 HTML 评审页」「给我做个 dashboard 看这几个指标」「做个能拖的小编辑器让我分类这堆 issue」——它会生成单文件 .html，本地浏览器直接打开。

GitHub 仓库在这里（顺带读 README 的「What this skill does」一节，作者对边界讲得很克制）：

https://github.com/dogum/html-artifacts

GitHub: https://github.com/dogum/html-artifacts