規格交給代理寫,在 DotMD 把它改對。
Claude Code、Codex 和 Cursor 幾分鐘就能寫出規格、計畫與設計文件。DotMD 把每一份都變成可以像 pull request 一樣審閱的文件:對確切段落留言、修正直接顯示在檔案中,最後由你核准。
需要 macOS 14 或以上版本。閱讀免費;編輯與審閱為一次付費。
快速解答
DotMD 讓你像審查 pull request 一樣,審閱 Claude Code、Codex 與 Cursor 寫的規格、計畫與文件:在確切的段落上註解、修正顯示在檔案中,最後由你核准。審閱屬於 DotMD Reviewer,是一次性購買;閱讀免費。
為什麼聊天不適合用來審閱
代理一分鐘就能寫好一份規格。仔細讀完並把它改對,仍然是你的工作,而聊天並不適合做這件事。你引用一段、說明想要什麼,代理卻重寫了半個檔案,你看不出它改了什麼。下一輪又從同樣的猜測開始。
改用審閱程式碼的方式來審閱規格。在 DotMD 中,每則留言都綁定在它所指的段落上,修正就出現在檔案裡那則留言的旁邊,檔案的每個版本也都會保留下來。
審閱流程
-
代理把檔案送給你
它寫好規格,並送給你審閱。通知會告訴你,檔案會出現在側邊欄的 Needs You 下,代理也同時等待。
-
你在段落上留下註解
以完成後的樣子閱讀文件,包含表格、圖表與程式碼。選取需要修改的段落,按下 ⌥⌘M,寫下你的想法。送出前先把整份檔案看完。
-
你按下 Send
按一下 Review 面板底部的 Send。代理會一次收到你所有的留言,每則都附上段落與行號。
-
修正出現在檔案中
代理編輯檔案,並逐則送回留言,附上它做了什麼的說明。舊文字是紅色,新文字是綠色,就在它回應的那則留言旁邊。
-
你接受或重新開啟,最後核准
Accept 接受修正,Reopen 附上更好的說明退回,Accept All 一次全部接受。沒有需要修改的地方時,按下 Approve,代理就會繼續它的任務。
適合這樣審閱的內容
凡是代理寫成 Markdown 檔案、而你必須在它動手前確認無誤的內容:
- 功能的規格與設計文件。
- 代理寫程式之前的實作計畫。
- 遺漏一步代價很高的遷移與上線計畫。
- 其他人會照著做的 README 與文件。
- 每一列都可能各自出錯的比較表。
留言在沒有任何代理時也能使用,當作給自己的草稿筆記。
沒有任何事會被默默漏掉
在等你的代理很容易被忘記。DotMD 讓它保持在視線內,又不會打斷你正在做的事:
- 側邊欄頂端的 Needs You 列出每個有人在等你的檔案:等你審閱的代理,或是你還沒檢查的修正。
- Dock 圖示會顯示有多少檔案需要你。
- 在檔案中,橫幅會說明有什麼在等待,並附上 Review 按鈕;工具列的 Review 按鈕則以紅色數字顯示待檢查的修正數量。
- 代理在單一呼叫中等待,你閱讀時不會耗用任何 token,不論花多久。
你需要什麼
- 一部 macOS 14 或更新版本的 Mac。
- 用於審閱與代理的 DotMD Reviewer:一次付費 $39.99,Editor 擁有者則是 $24.99。閱讀 Markdown 免費。請見價格。
- 一個支援 MCP、並已連接 DotMD 的代理。Claude Code 與 Codex 的指南都有一行設定。
關於審閱 AI 規格的問題
如何在 AI 代理寫程式之前審閱它的規格?
透過 MCP 把代理連到 DotMD,讓它把規格送給你。對段落加註解,按下 Send,接受或重新開啟每項修正,再按下 Approve;在你完成之前,代理會一直等待。
為什麼不直接在聊天中審閱規格?
在聊天中你只能引用一段文字,代理可能改寫半份檔案,而你看不出改了什麼。在 DotMD 中,每則註解都綁定一段文字,修正以 diff 顯示在旁邊,檔案的每個版本也都會保留。
如何看出代理除了我要求的之外還改了什麼?
開啟 Review 面板。沒有任何註解要求的修改,會列在 Other changes 下;用 Version History 可以還原單一區塊或整份檔案。
哪些代理可以送文件給我?
任何 MCP 用戶端:Claude Code、Codex、Cursor、Visual Studio Code 等。
代理等待時會耗用 token 嗎?
不會。它在單一工具呼叫中等待,直到你按下 Send 或 Approve。
沒有代理要求,我可以自己送出文件嗎?
可以。對任何檔案留言,然後告訴代理:「在 DotMD 讀我的留言並修正。」Review 面板有這段提示,旁邊附有 Copy 按鈕。