Codex 有了計畫。把它放進可審閱的檔案。
Codex 把計畫提在聊天裡,一捲動就看不到了。請它寫成檔案,你就能逐行加註解,並讓 Codex 修正你標出的地方。
需要 macOS 14 或以上版本。閱讀免費;編輯與審閱為一次付費。
快速解答
在 Codex 輸入 /plan 即可切換到計畫模式,也可以接著寫需求,例如 /plan Propose a migration plan for this service。計畫會出現在聊天中。請 Codex 把它存成 plans/<name>.md,並在 DotMD 送給你:你對各步驟加註解,Codex 修正後會等你核准。Codex 也可以審閱 Claude Code 寫的計畫。
Codex 的 /plan 在做什麼
/plan 指令會把 Codex 切換到計畫模式。Codex 不會立刻開始寫程式,而是先提出執行計畫。你可以在指令後面輸入需求:/plan Propose a migration plan for this service。Codex 已在處理其他事情時無法使用這個指令,所以請在任務一開始就用。
為什麼計畫應該是檔案
在計畫模式中,計畫是以聊天訊息的形式回傳。OpenAI 的文件沒有提到任何計畫檔案。聊天訊息很難審閱:它會被捲走,你無法指向某一步,其他人也讀不到。
檔案能解決這三個問題。你可以對單獨一行加註解、與前一個版本比較、提交,並交給另一個代理。所以請在你選定的資料夾中,以檔案形式要求計畫。
有效的提示
Codex 提出計畫之後,或在同一次要求中,這樣說:
Write the plan to plans/<name>.md and send it to me in DotMD for review.
Codex 會寫出檔案並呼叫 DotMD 的 request_review。檔案會出現在側邊欄的 Needs You 之下,Codex 開始等待。你閱讀渲染後的計畫,選取一個步驟,按 ⌥⌘M 加註解,再按 Send。Codex 收到你的註解、修正計畫,並把每則註解送回。你逐項接受或重新開啟,內容正確後按下 Approve。
如果 Codex 去專案裡找註解,而不是從 DotMD 讀取,請在要求中提到 DotMD,或在 AGENTS.md 加一行:請見 CLAUDE.md 與 AGENTS.md。
只需連接 Codex 一次
在 DotMD 的 Settings → MCP 開啟 MCP 伺服器,然後把 DotMD 加進 ~/.codex/config.toml:
[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600
tool_timeout_sec 讓 Codex 在你閱讀時繼續等待。沒有它的話,Codex 大約一分鐘後就不等了。加入後請重新啟動 Codex。App、CLI 與 IDE 擴充功能共用同一份設定;Codex 指南也示範了 App 的做法。
檢查 Codex 計畫時看什麼
計畫改起來很便宜,實作則不然,所以帶著幾個問題讀一遍:
- 缺步驟嗎?測試、migration、文件、回滾。
- 順序對嗎?需要後面步驟結果的步驟,就是計畫的錯誤。
- 範圍對嗎?找找你沒要求 Codex 動的檔案或區域。
把每項意見作為註解放在它所指的步驟上,並說明要改什麼。Codex 只看得到你的註解與檔案,所以「這裡用現有的 helper」比「這裡不對」有用。DotMD 也會把你沒有要求的更動列在 Other changes 之下,讓你看出某項修正是否改得太多。