指南 · Claude Code 工作流

Claude Code HTML Plan:为什么有人用 HTML 写可视化规格

2026 年,Anthropic 的 Claude Code 工程师 Thariq Shihipar 演示了一种很抓人的做法:让 Agent 不只交一份 Markdown 计划,而是交一个能浏览、能比较、能点开的 HTML 规格。它解决的是“人愿不愿意认真看”,不是让 Agent 自动变聪明。

更新于 2026 年 8 月 3 日实践指南

HTML plan 这股风从哪里来

Thariq 在 How I AI 的访谈与 Code with Claude 活动中展示了 rich HTML spec、mockup 和小型交互界面。它很快形成一个明确长尾:Claude Code HTML plan。

HTML 真正增加了什么

  1. 并排比较多个方案。
  2. 用真实层级呈现组件与状态。
  3. 把流程、图表和响应式意图放在一页。
  4. 让非工程读者更容易参与评审。

HTML 没有自动解决什么

它不会替你证明事实、控制权限、保存正式版本,也不会把一句口头同意变成可执行闸门。任意脚本和外部资源还会带来额外安全成本。

按契约选择发布方式

如果必须保持原 HTML 不变,用专门的 artifact host;如果内容要长期维护、被引用或进入评审,使用 typed 文档。不要把转换后的东西说成原文件原样托管。

OpenWiki 的受治理替代路径

把最终范围、证据、风险和批准请求写成 .mdw,完成 check、build、digest,再以 --review 发布。HTML 原型与决定文档可以互相链接,但应明确它们是两个 artifact。

# Ask the Agent to author the supported typed plan, then:
ow a2ui draft check ./plan
ow a2ui draft build ./plan
ow a2ui digest ./plan/document.mdw
ow publish ./plan/document.mdw --review --no-open --timeout 900

常见问题

常见问题

是谁提出了 Claude Code HTML plan 的做法?

这轮讨论由 Anthropic Claude Code 团队工程师 Thariq Shihipar 在 2026 年的 How I AI 访谈中推广开来。

OpenWiki 能直接发布 HTML plan 吗?

不能。Hosted 只接收经过校验的 .mdw;原 HTML 请用合适的 artifact host。

HTML 一定比 Markdown 好吗?

不一定。视觉结构和交互确实重要时才值得;短小、适合 diff 的实现说明往往仍以文本更合适。

来源与延伸阅读

使用真实工作流

把 Agent 创作的作品发表出来。

让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。