从读者任务和内容形态开始
- 按阅读任务选 report、article、briefing 或 dashboard。
- 先排结论与证据,再做样式。
- 选择受支持主题与兼容 accent。
- 一份文档只用一个批准图标库。
让数据与呈现都显式
重要数值放在 typed facts 或 query results,再让表格、metric 与 chart 引用它们。不要把关键数字只写进装饰文案。
把媒体当作有证据的资产
- 最终字节冻结进包。
- 记录来源、作者或发布方、许可、获取日期、digest、alt、caption 与 credit。
- 用户或模型生成图片标明 authored metadata。
- 图片失败时文档仍应可理解。
跑完确定性闸门
依次 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。