規格交給代理寫,在 DotMD 把它改對。
Claude Code、Codex 和 Cursor 幾分鐘就能寫出規格、計畫與設計文件。DotMD 把每一份都變成可以像 pull request 一樣審閱的文件:對確切段落留言、修正直接顯示在檔案中,最後由你核准。
需要 macOS 14 或以上版本。閱讀免費;DotMD Pro 提供 3 天免費試用。
快速解答
透過 MCP 把你的代理連接到 DotMD。它寫完規格或計畫後,會把檔案送給你並等待。你對段落留言,然後按下 Send;代理逐則修正,你在檔案中接受或重新開啟每項修正。最後按 Approve。
為什麼聊天不適合用來審閱
代理一分鐘就能寫好一份規格。仔細讀完並把它改對,仍然是你的工作,而聊天並不適合做這件事。你引用一段、說明想要什麼,代理卻重寫了半個檔案,你看不出它改了什麼。下一輪又從同樣的猜測開始。
改用審閱程式碼的方式來審閱規格。在 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 Pro:附 3 天免費試用的 Yearly,或 Lifetime。閱讀 Markdown 是免費的。請見價格。
- 一個支援 MCP、並已連接 DotMD 的代理。Claude Code 與 Codex 的指南都有一行設定。
關於審閱 AI 規格的問題
為什麼不直接在對話裡審閱?
在對話裡,你引用一段文字,代理卻重寫了半個檔案,而你看不出到底改了什麼。在 DotMD 裡,註解綁定在段落上,修正以差異對照的方式顯示在旁邊,檔案的每個版本也都會保留。這就是針對文件的 code review。
哪些代理可以送文件給我?
任何 MCP 用戶端:Claude Code、Codex、Cursor、Visual Studio Code 等。
代理等待時會耗用 token 嗎?
不會。它在單一工具呼叫中等待,直到你按下 Send 或 Approve。
沒有代理要求,我可以自己送出文件嗎?
可以。對任何檔案留言,然後告訴代理:「在 DotMD 讀我的留言並修正。」Review 面板有這段提示,旁邊附有 Copy 按鈕。