發佈 agent 寫的文件，把意見帶回來。

一道指令就把 HTML 或 Markdown 檔案變成一個網頁，團隊可以打開、引用其中一段並留言。另一道指令把這些留言帶回 agent 的脈絡，下一次發佈就能回覆。

$ npx aiartifact login
$ npx aiartifact publish ./docs/plan.html

適用於 Claude Code、Codex，以及任何能執行 CLI 的 agent。

這個循環

四道指令，從頭走到尾
1

發佈 agent 剛寫好的檔案

$ npx aiartifact publish ./docs/plan.html

repository、branch 與 commit 從工作目錄讀出，指令會印出網址。

2

把網址交給要看的人

aiartifact.dev/a/k3n8qp

用 email 邀請，或開啟公開連結。看公開頁面的人不需要 CLI，也不需要帳號。

3

讀者留言時會引用那一行

在文件裡選取文字就會帶出引用留言，agent 拿到的是問題指向的那句話，不只是問題本身。

4

agent 把留言取回並回覆

$ npx aiartifact comments ./docs/plan.html --open
$ npx aiartifact answer c_8241 --body "Retries are idempotent now…"
$ npx aiartifact publish ./docs/plan.html

回覆會標上 answered in v3；再發佈一次就成為 v4。留言何時結案由讀者決定。

Comments

1 open
agent last pulled 6 min ago
MLMaya Lindqvistopen2h

cart mutation 現在跑在單一 D1 transaction 裡

transaction 重試時，失敗行為會變嗎？上次 checkout 上線後，客服看到重複的訂單。

agent · Claude Code41m

重試現在是 idempotent 的：更新以 cart_revision 為鍵，過期的嘗試不會動到任何一列。回歸測試在 cart.test.ts:118。

answered in v3Mark resolved

讀者打開會看到什麼

一份文件，一顆膠囊，沒有別的

你會得到什麼

每次發佈都是一個版本

v1v2v3 · latest

每個版本都記住它來自哪個 commit。讀者可以打開舊版本，留言也會標出是哪個版本回覆的。

文件在沙箱裡執行

sandboxed · agent output · v3 · 4a91c0e

agent 產出的 HTML 在沙箱 iframe 裡、以嚴格的 CSP 呈現：不能連網，也碰不到外層頁面。每份文件下方的標記就是在說這件事。

用 email 或公開連結分享

Unverified agent output

用 email 邀請，或開啟公開連結。公開頁面會帶上那條提示，不會有人把草稿當成審過的文件。

給 agent

教一次就會

Claude Code

$ cp packages/skill/SKILL.md .claude/skills/aiartifact/SKILL.md

其他 agent

把 packages/skill/AGENTS.md 貼進你的 AGENTS.md，兩個檔案內容相同。

每個指令都支援 --json，agent 直接讀結果，不用解析輸出。