編程代理寫計畫，在它寫程式前先審閱。

在程式碼之前先審閱計畫

計畫中的錯誤假設，只需要一則留言就能修正。同樣的假設到了程式碼裡，就得讀 diff、revert，再重跑一次。所以先讀計畫，趁修改的成本還低。

在終端機裡，計畫是一大段要捲動閱讀的文字。在 DotMD 裡，它是排版好的文件，你的每項意見都綁定在它所指的段落上：

1. 以檔案形式索取計畫

   「把計畫寫到 docs/plan.md，並在 DotMD 送給我審閱。」

2. 在有問題的地方留言

   選取一段，按下 ⌥⌘M，寫下你想要的修改。整份計畫都這樣做，然後按 Send。

3. 以 diff 檢查修正

   代理編輯檔案；舊文字是紅色，新文字是綠色，就在每項修正所回應的留言旁邊。Accept、Reopen 或 Accept All。

4. 核准，再讓它動手

   按 Approve，代理就會繼續寫程式。

代理會連同段落、行號與留言者一起看到每則留言，所以確切知道你的意思。它也能讀取你選取的段落：「重寫我在 DotMD 選取的那一段。」

完成後請它「在 DotMD 讓我看變更」，它就會替你開啟審閱。

代理會寫的文件

計畫只是開始。代理還會寫別的文件，你可以用同樣的方式審閱：

• 規格與設計文件。
• 架構決策紀錄（ADR）。
• README 與 CHANGELOG 條目。
• 遷移、上線與測試計畫。
• 函式庫與服務的比較表。

第二個代理也可以審閱第一個的成果：Claude Code 寫，Codex 留言，由你決定。請見一個代理審閱另一個。

適合你現有的環境

DotMD 在你的 Mac 上執行一個小型 MCP 伺服器，你的代理只需一行就能連上。Claude Code、Codex、Cursor 和 Visual Studio Code 都能用；各指南都有確切的設定。

• 是檔案，不是副本。DotMD 直接讀寫你專案資料夾裡的 Markdown 檔案。不需要匯入，也不需要同步。
• git。當 git、編輯器或代理修改檔案時，DotMD 會察覺，並把先前的文字保留為一個版本。用 git mv 改名的檔案，你在新位置第一次開啟時，留言會跟著回來。
• Docker。容器裡的代理可以在 http://host.docker.internal:8089/mcp 連上 DotMD。

養成習慣：在 AGENTS.md 加幾行

代理會在你要求時送出文件審閱。若要讓它每次都這樣做，並到 DotMD 找你的留言，請把這幾行加到 Codex 的 AGENTS.md，或 Claude Code 的 CLAUDE.md：

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

第一行最重要。你的註解由 DotMD 保存，不在檔案裡；沒想到 DotMD 的代理會在專案中搜尋，結果什麼也找不到。

你的檔案仍然是你的

• 沒有帳號。你的檔案、留言與版本紀錄都留在你的 Mac 上。
• MCP 伺服器只在 127.0.0.1 回應，所以其他電腦無法連上，網頁也無法使用。
• 留言與紀錄由 DotMD 保存，不在你的檔案裡。你儲存庫裡的 Markdown 沒有任何標記，也沒有 HTML 註解。

開發者常問的問題

更多問題