MarsDawn

Chip Huyen 的 read-only／write action 分類，核准前為什麼要看它

Chip Huyen 在 2025 年 1 月發表的〈Agents〉，從教科書式的定義出發，一路寫到一個更具體的分類：agent 的動作分成「只是看世界」跟「會改變世界」兩種。這個分類，正好可以用來判斷你手上五分鐘該花在計畫裡的哪幾行。

這篇文章主張什麼

Huyen 開門見山：

“An agent is anything that can perceive its environment and act upon that environment.”

（Agent 是任何能感知環境、並對環境採取行動的東西。）

從這裡出發，她說明 agent 需要什麼：一個可以行動的環境，還有一組決定它能做什麼的工具——她稱之為「tool inventory」。她點出一個分界：只是讓 agent 能感知環境的動作是「read-only actions」，能讓它對環境採取行動的動作是「write actions」。對於後者，她講得很直接：

“Write actions enable a system to do more.”

（Write action 能讓系統做到更多事。）

但她也直接點出第二種動作帶來的風險：「the prospect of giving AI the ability to automatically alter our lives is frightening」（讓 AI 有能力自動改變我們的生活，這個念頭令人不安），照她的說法：「you shouldn’t allow an unreliable AI to initiate bank transfers」（不該讓一個不可靠的 AI 去發起銀行轉帳）。她對 agent 最難搞定的那一塊也講得很坦白：

“If you’ve ever been in any planning meeting, you know that planning is hard.”

（如果你參加過任何一場規劃會議，就知道規劃有多難。）

Huyen 在這篇文章裡完全沒有提到 MarsDawn，也沒有推薦任何 Markdown 工具。〈五分鐘審完一份 agent 計畫〉已經引用她這篇文章裡三句話：執行前不監督的代價、以為自己做完其實沒做完的 agent，還有第三步裡她說系統遇到有風險的操作「可以在執行前要求人類明確核准」那一句。這篇不重複這些引文；還沒看過那篇的話，下面有連結。

以下是我們的解讀，不是 Huyen 的

Huyen 的 read-only／write action 分法，不是寫給審閱用的建議，而是一種給工具分類的方式。但它是一個很好用的通用判斷法，可以用來抓出〈五分鐘審完一份 agent 計畫〉第三步已經要你放慢腳步的那種有風險的操作：讀一個檔案、跑一次搜尋、列一下目錄，這些是 read-only，做錯了頂多重跑一次；刪資料、force push、合併分支、寄信、扣款，這些是 write action——照她的說法，這種一旦做錯就是「令人不安」的那種，而且等你讀到 agent 的報告時，它可能已經做完了。她說連人坐在一起開會都覺得規劃很難，這也提醒我們別對一份計畫的精確度期待過高：計畫讀起來自信，不代表它是對的。

MarsDawn 幫得上、幫不上的地方

MarsDawn 沒辦法幫你判斷計畫裡哪一步是 read-only、哪一步是 write——這是文字沒標出來的判斷，app 裡的任何東西都不會替你讀出語意。它裡面也沒有 AI 模型：不會幫你標出風險高的那一行，不會替你跑「規劃到底有多難」的檢查，也不會給計畫打分數。它做的是讓檔案在你自己做判斷的時候保持好讀：側邊欄（「顯示方式 ▸ 顯示側邊欄」，⌃⌘S）的「大綱」分頁讓你先看過計畫的架構，再逐行讀；原始碼和排好的頁面並排（⌘2），步驟圖就不會卡在 Mermaid 原始碼那個階段；「編輯 ▸ 拷貝引用」（⌥⌘C）把你的位置拷貝成 plan.md:10，你一發現順序不對的 write 動作，馬上就能貼出去當回饋。

試試看

MarsDawn 已在 Mac App Store 上架。免費的 marsdawn 命令列工具現在就能用：

brew install redtear1115/tap/marsdawn

它不需要 app 就能把 Markdown 輸出成 PDF。

命令列工具 · 買之前先看：MarsDawn 做不到的事

接下來

資料來源