指南 · Agent 交付

分享 Agent 的最终成果,而不是整段对话

对话是生产过程,报告、计划和规格才是交付物。把两者混在一个分享链接里,读者要翻过废案和调试记录,你也更容易泄露不该出现的上下文。

更新于 2026 年 8 月 3 日实践指南

为什么会话链接常常不是好交付

会话可能包含弃用方案、私有代码、凭据、个人备注和与结果无关的后续消息。它按“怎么做出来”组织,而不是按读者任务组织。

先划出成果边界

  1. 写清读者与要支持的决定。
  2. 只保留有依据的结论、约束和下一步。
  3. 留下来源,也留下未知。
  4. 移除秘密、会话私话和未经采用的分支。

让 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。