先辨认手里的 artifact
- 带自定义布局或脚本的 raw HTML
- 仓库里的 Markdown 计划
- 可拍板的技术规格
- 持续更新的报告
- 执行前必须批准的候选计划
不要逼所有文件进同一个 host
HTML host 承诺原样呈现；OpenWiki 承诺 typed identity、修订与评审。选错以后再补，往往两边都不完整。
构建受支持的 OpenWiki 成果
把最终范围、证据、风险和决定请求用 draft 命令重新表达，运行 check、build，再 publish。
ow a2ui draft init ./handoff --title "Implementation plan" --description "Scope, risks, and approval request" --language en
# Author through typed draft commands.
ow a2ui draft check ./handoff
ow a2ui draft build ./handoff
ow publish ./handoff/document.mdw --review --no-open会话边界与能力边界都要守住
不要把 Claude Code 会话里的秘密、私有路径和无关上下文带进文档。阅读发 view，批准才发 review capability。
常见问题
常见问题
Claude Code 生成的 HTML 可以直接上传吗？
不可以。用 HTML artifact host，或另写 typed .mdw。
Claude Code 修订计划后能保留同一 URL 吗？
可以。重建 .mdw 后用 --update 指向原 document ID。
使用真实工作流
把 Agent 创作的作品发表出来。
让每份报告、文档或计划拥有面向读者的页面；批注、评审决定和正式版本都从这里回到 Agent。