为什么会话链接常常不是好交付
会话可能包含弃用方案、私有代码、凭据、个人备注和与结果无关的后续消息。它按“怎么做出来”组织,而不是按读者任务组织。
先划出成果边界
- 写清读者与要支持的决定。
- 只保留有依据的结论、约束和下一步。
- 留下来源,也留下未知。
- 移除秘密、会话私话和未经采用的分支。
让 Agent 构建并发布成果
用 typed draft 表达正文、证据、表格、图表和决定,再依次 check、build、digest、publish。
ow a2ui draft init ./artifact --title "Architecture decision" --description "Reviewed recommendation and evidence" --language en
# Add typed sections, evidence, tables, diagrams, and decisions.
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw
ow publish ./artifact/document.mdw --no-open根据用途发不同链接
阅读发 view URL;需要拍板才发 review capability;审计或引用要发固定版本。
常见问题
常见问题
为什么不直接分享完整 Agent 对话?
它可能暴露废案、私有上下文、凭据和无关内容;单独成果能把披露范围收窄。
读者能从 OpenWiki 链接继续原会话吗?
不能。发布物是成果,不是可转移会话;需要机器继续时可读取 typed 包。
使用真实工作流
把 Agent 创作的作品发表出来。
让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。