用途
Answer me with HTML 用于把复杂问题的回答转成单页可视化 HTML 解释页。模型只负责用扩展 Markdown 写内容草稿,页面布局、配色、深色模式与图表坐标都由随技能附带的 am CLI 完成。该技能明确要求不要手写 HTML、CSS、SVG,回复用户与撰写草稿都应使用用户的语言。
何时生成页面
技能给出判断标准,满足以下任一情况就生成页面:存在三个以上相互关联的概念,且读者需要看到它们的关系;存在流程、协议、调用链或状态转换(尤其含分支或多个参与者);存在跨三个以上维度的比较、方案权衡或“能、不能”清单;存在层级结构或随时间演进的过程。否则用纯文本回答。不确定时,问题越“需要图才能理解”,越适合生成页面。
内部报告不生成页面:如果父智能体或协调者委派了研究、实现、审查或进度报告,应返回它要求的文本或结构以及发现和证据,不渲染页面;只有当被委派的任务明确要求页面时才渲染,并返回页面路径与验证细节。视频需要明确请求,单纯委派不授权生成视频。
常开模式:如果上下文中有 [answer-me-with-html always-on] 提醒,判断门槛会放低,任何给出结论、摘要、计划、比较、审查或解释的回合都附一个页面;日常结论用小页面,2–4 个面板即可。使用 --no-open 渲染,避免浏览器窗口打断用户,由用户点击回复末尾的路径打开。
闲聊、没有结论的一两句话、纯命令输出,或用户要求纯文本时,不生成页面。
使用方式
CLI 位于技能目录的 scripts/am.mjs,单文件,无依赖,只需 Node.js 20+。命令中的 am 指 node "${CLAUDE_SKILL_DIR}/scripts/am.mjs"。在 Claude Code 中该占位符会被替换为技能目录;其他宿主需手动写绝对路径,并用 test -f 检查。
先在心里列出 3–8 个面板,每个面板只回答一个子问题。用 heredoc 一次渲染,例如在 frontmatter 中写 title,正文用 ## 面板标题,流程用 flow 代码块。
根据输出处理:✓ 表示成功;✗ 表示未写页面,需按行号修正草稿后重试;draft: 会保存草稿路径,可只改被标记的行;code 与 STE 警告按提示处理。再次渲染时,数据目录或临时目录中的页面用 --replace,-o 写出的页面复用同一路径覆盖。
只读一条信息:回复终端仅 2–3 行,一句核心结论加页面链接;先渲染页面再写回复,回复是回合最后一步。若页面有 ask 且宿主支持提问,先写回复再调用提问工具。
已有页面只需改一个面板时,用 patch 命令从 HTML 的 #am-source 取源草稿,只替换对应 ## 段落,原地覆写。
草稿格式与组件
frontmatter 支持 template(sheet 默认单屏概览、doc 线性解释)、theme(auto、blueprint、shadcn、paper 或用户自制主题)、title、subtitle、file、cols、source 等。面板标题可带 span、meta、bare 等属性;表格状态词 ok、no、warn 会渲染为徽章,可加排序与过滤。数学公式用 $…$ 与 $$ 块。html、svg 围栏块按原样嵌入,但 html 块中的 script 不会运行。
组件按信息形态选择,包括 flow(连接与分支)、er(数据模型)、sequence(时序消息)、tree(层级分类)、timeline(历史阶段)、limits(数值上限)、chart(bar、line、pie 图表)、annot(逐词注释)、kv(元数据块)、callout(结论或警告)、ask(需用户决策)以及 Markdown 表格(多维比较、能或不能清单)。
适用场景与限制
适用于需要把多概念关系、流程、比较、层级或演进讲清楚的回答场景。限制包括:需 Node.js 20+;不生成视频,除非明确请求;委派的内部报告默认不渲染页面;html 块中的脚本不会执行;STE 或代码警告的页不会自动打开,警告重试最多 2 轮;清理与更新提示需征得用户同意后才执行;页面默认保存在 ~/.answer-me-with-html/pages,沙箱环境可能改存临时文件夹,可能被系统清理。