指南 · Codex 交付

把 Codex 的报告或计划分享成独立文档链接

Codex 会话适合生产成果,却不一定适合读者消费。收件人通常要的是结论、证据和下一步,而不是每条命令、废案和仓库细节。

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

生成前先定义交付

  1. 读者是谁,要做什么决定。
  2. 哪些证据可以披露。
  3. 哪些是事实、建议和未知。
  4. 对方只读、反馈还是批准。

在 Codex 工作流里构建 artifact

让 Agent 用 typed 操作写入标题、结构、证据、风险和可视节点,再运行完整本地校验。

ow a2ui draft init ./artifact --title "Migration recommendation" --description "Decision, evidence, and rollback plan" --language en
# Add the supported typed sections and visual nodes.
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw

选择正确的发布方式

普通报告直接发布;会授权下一步行动的计划用 --review。不要仅凭页面好看就跳过决定边界。

# Read-only publication
ow publish ./artifact/document.mdw --no-open

# Blocking decision
ow publish ./artifact/document.mdw --review --no-open --timeout 900

交付前看真实页面

用浏览器打开返回 URL,检查正文、图表、链接、移动端与访问状态。CLI 成功表示送达,不表示读者体验已经验收。

常见问题

常见问题

OpenWiki 链接会暴露我的 Codex 会话吗?

不会。它只公开你选择发布的独立 typed 文档。

Codex 能读回评审决定吗?

可以。--review 会返回 approve、request changes、reject、timeout 或 error。

使用真实工作流

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

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