指南 · OWX 创作

Agent 创作 OWX 文档的最佳实践

可靠作品从读者任务与保留证据开始,而不是先选视觉模板;结构、数据、呈现、资产与来源都留在明确的作者树中。

更新于 2026 年 9 月 5 日实践指南OWL Compose CLI 0.1.3 and laterOWL Compose Product

从读者要做的判断开始

  1. 说清读者看完要理解或完成什么。
  2. 只选一个主内容合同。
  3. 固定章节数量前先冻结权威证据。
  4. 结论和最强证据排在次要细节之前。

让数据与主张可追溯

用 Dataset、Query 和 Fact 绑定 metric、table 与 chart 的数据。把来源事实、作者解释和不确定性清楚分开;可绑定的数值不要只复制到装饰文本。

写出完整视觉系统

新的视觉作品使用包内 styles.owcss 和完整 token-first quick-style 合同。在真实节点上消费所有必需语义角色;具有含义的局部分类颜色保持显式。

同时通过确定性与视觉闸门

ow a2ui check ./artifact/document.owx
ow a2ui preflight ./artifact/document.owx --require ow-table=1
ow a2ui fmt ./artifact/document.owx --check
ow a2ui compile ./artifact/document.owx --output ./artifact/document.json
ow a2ui digest ./artifact/document.json
产品边界

编译后用真实浏览器检查桌面端与移动端;所有裁切、溢出、空图、弱阅读顺序与未解析值都回到 OWX 修复。

常见问题

常见问题

所有作品都应该用同一布局吗?

不应该。章节数量、密度、不对称关系与焦点组件应由读者任务和保留证据决定。

布局需要时可以新增未注册组件吗?

不可以。先查看当前 Catalog;若必要原生形态缺失,应报告明确能力缺口,而不是发明标签或嵌入任意网页代码。

使用真实工作流

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

安装 CLI,用 OWX 创作并在本地校验,然后发表一份默认私密的作品;准备分享时再显式创建读者链接。