最佳实践 · 版本

AI 文档版本管理最佳实践

AI 让内容变化更快,也让“当前是什么”和“当时批准了什么”更容易混在一起。好的版本管理不是多存几个文件,而是给不同引用明确承诺。

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

先定义作品身份代表什么

用一句话写明主题、所有者、读者任务和证据边界。以后每次更新,都用这句话判断是否仍是同一作品。

追加,不覆盖

用 --update 让 canonical 前进,同时保留历史版本、PDF 与包。候选需要批准时与当前正式版隔离。

ow publish ./artifact/document.mdw --update <document_id> --review --no-open

让每种 URL 做它擅长的事

  1. canonical:活文档当前状态。
  2. 固定版本:批准、审计、引用。
  3. 版本化 PDF:离线附件。
  4. .mdw:Agent 恢复与继续。

含义变化时新建身份

所有者、主题、受众、决定或证据边界实质变化,就不要为了继承注意力继续占用旧 URL。

常见问题

常见问题

周期报告每次都需要新 URL 吗?

通常不需要。读者契约不变时,在同一作品下追加修订。

后续更新会改变旧版链接吗?

不会。固定版本指向不可变的正式修订。

使用真实工作流

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

让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。