从读者要做的判断开始
- 说清读者看完要理解或完成什么。
- 只选一个主内容合同。
- 固定章节数量前先冻结权威证据。
- 结论和最强证据排在次要细节之前。
让数据与主张可追溯
用 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 创作并在本地校验,然后发表一份默认私密的作品;准备分享时再显式创建读者链接。