最佳实践 · MDW 创作

Agent 创作 MDW 文档的最佳实践

.mdw 是发布契约,不是改名后的 Markdown。可靠创作会把主张、结构、呈现、资产和证据放进可检查的关系里,而不是依赖一段私有 CSS。

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

从读者任务和内容形态开始

  1. 按阅读任务选 report、article、briefing 或 dashboard。
  2. 先排结论与证据,再做样式。
  3. 选择受支持主题与兼容 accent。
  4. 一份文档只用一个批准图标库。

让数据与呈现都显式

重要数值放在 typed facts 或 query results,再让表格、metric 与 chart 引用它们。不要把关键数字只写进装饰文案。

把媒体当作有证据的资产

  1. 最终字节冻结进包。
  2. 记录来源、作者或发布方、许可、获取日期、digest、alt、caption 与 credit。
  3. 用户或模型生成图片标明 authored metadata。
  4. 图片失败时文档仍应可理解。

跑完确定性闸门

依次 check、build、digest;失败就回到草稿源。

ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw
产品边界

不要解压后手改生成包。修改 draft,再重新构建。

常见问题

常见问题

.mdw 只是另一个 Markdown 后缀吗?

不是。它是包含内容、呈现、完整性资产与协议元数据的确定性类型化包。

可以放任意 HTML 或 JavaScript 吗?

不可以。只能使用支持的 typed 节点与渲染能力。

使用真实工作流

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

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