
01|先确认 CLI 与 Agent Skill 真的可用
不要把“装过”当成“能用”。先检查 ow 是否在 PATH 中,再跑 doctor。doctor 通过,才说明当前 Agent 环境拿到了与 CLI 匹配的工作流说明。
command -v ow
ow agent doctor --target auto02|把内容做成类型化草稿
先定读者、标题和文档语言,再逐步加入段落、事实、表格、图表或评审信息。生成包是构建产物,不要解压后直接改。
ow a2ui draft init ./artifact --title "Launch plan" --description "Decision-ready launch plan" --language en
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw03|校验完成后再发布
check 看结构和绑定,build 产出确定性包,digest 给出身份摘要。三步都成功,再发布;Hosted 还会在服务端复核一次。
ow publish ./artifact/document.mdw --no-open产品边界
Hosted 不直接接收 Markdown、HTML、目录、stdin、Bundle JSON 或 JSON-LD。
04|把返回的链接分清楚
- 给普通读者发只读链接。
- 保留 document ID,后续修订和恢复都要用。
- 评审或管理链接带权限,只交给对应的人。
- 交付前在真实浏览器里打开一次,确认布局、图片和访问状态。
常见问题
常见问题
可以直接发布一份 Markdown 吗?
不可以。Hosted 只接收由 ow a2ui draft 构建并通过校验的 .mdw 包。
本地构建也需要登录吗?
不需要。草稿、校验、构建和 digest 都在本机完成;只有发布到 Hosted 时才需要账户凭据。
使用真实工作流
把 Agent 创作的作品发表出来。
让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。