Answer me with HTML：让 AI 用一页可读的 HTML 回答复杂问题

这是什么

Answer me with HTML 是一个面向 AI Agent 的技能（Skill），它让 AI 在回答复杂问题时，不是输出一长串文字，而是生成一页结构清晰、图文并茂的 HTML 页面。这个页面包含图表、对比表格、时间线等可视化元素，让你能真正“读进去”而不是面对一堵文字墙。

该技能的核心思路是：AI 只负责写简短的 Markdown 草稿，然后由随技能附带的命令行工具（CLI）负责渲染成精美的 HTML 页面。根据项目作者在 README 中的基准测试，相比直接让 AI 手写 HTML，使用本技能可以将输出 token 减少约 6 倍，生成速度提升约 2.8 倍，成本降低约 27%。

项目采用 MIT 协议，当前最新版本为 v0.4.14，在 GitHub 上已获得 1959 个 Star 和 134 个 Fork，社区关注度较高。

适合谁

开发者：需要快速理解复杂技术概念、代码架构或进行技术选型对比。
技术写作者：希望将技术解释转化为更直观、可分享的页面。
项目经理：需要向团队或客户清晰展示方案、流程或对比分析。
任何使用 AI Agent 的创作者：厌倦了 AI 输出的大段文字，希望获得更结构化、更易读的答案。

能做什么

安装后，你可以像平常一样向 AI 提问，当问题足够复杂时，AI 会自动生成一页 HTML 来回答。例如：

解释概念：如“解释 TCP 三次握手”，会生成包含时序图、状态图和标志位表格的页面。
分析代码结构：如“这个仓库的模块如何组织”，会生成文件夹树和调用图。
对比方案：如“Redis 还是 Memcached？”，会生成带 ✓ 和 ✗ 的对比表格，并给出结论。
审阅文本：如“这段文字有什么问题？”，会逐句标注问题词和修改建议。
梳理历史：如“Kubernetes 是怎么诞生的？”，会生成带关键时间点的时间线。
制定计划：如“规划缓存变更”，会展示真实代码和待决策选项。

此外，它还支持生成 3Blue1Brown 风格的讲解视频（通过 am video 命令），视频页面会逐步展示图表，并支持配音（可选 ElevenLabs）。

使用前准备

你需要安装 Node.js 20 或更高版本。无需 npm install 步骤，CLI 已打包在技能内。

该技能支持多种 AI Agent 平台，包括 Claude Code、Codex、Cursor、OpenCode 等，也支持通用 Agent。

安装方法

推荐让 AI Agent 自动安装，只需将以下指令粘贴给 Agent：

Install Answer me with HTML: read https://raw.githubusercontent.com/QingYunA/answer-me-with-html/main/INSTALL.md and follow it.

如果 Agent 无法打开链接，可以使用 npx 命令：

npx -y skills add QingYunA/answer-me-with-html -g -y -a <你的Agent名称>

对于 Claude Code，也可以使用插件方式：

/plugin marketplace add QingYunA/answer-me-with-html
/plugin install answer-me-with-html@answer-me-with-html

或者使用一键命令：

npx skills add QingYunA/answer-me-with-html

该命令会询问要安装到哪些 Agent，支持超过 70 种 Agent。

使用示例

安装后，直接向 Agent 提问即可。例如：

> Explain the TCP three-way handshake
> Map out how the modules in this repo fit together
> Redis or Memcached for our cache?

Agent 会生成一个 HTML 页面，并保存在 ~/.answer-me-with-html/pages/ 目录下。页面右上角有按钮可以切换主题、深浅色模式，并可以复制生成页面的 Markdown 源。

如果想生成讲解视频，可以这样提问：

> make a 3b1b-style video on the TCP handshake

Agent 会生成一个视频播放页面，支持逐步展示图表、镜头聚焦、对象过渡，并可选配音。

风险与注意事项

成本可能增加：在上下文很重的环境中（约 51,000 tokens），由于技能会额外增加两轮对话，可能导致总成本比直接手写 HTML 高约 20%。建议根据实际使用场景评估。
依赖 Node.js：需要 Node.js 20 或更高版本，且生成视频时需要 Chrome、ffmpeg 和 Node.js 22+。
隐私与数据：生成的页面保存在本地，但使用 ElevenLabs 配音时会将文本发送到第三方服务，请注意敏感信息。
自动更新检查：技能默认每周检查一次 GitHub 更新，但不会自动更新，你可以通过设置关闭。
页面自动打开：默认生成页面后会在浏览器中打开，如果觉得打扰，可以通过 am config set open off 关闭。