- 計劃模式提供了一個結構化的唯讀環境，用於在修改任何程式碼之前研究、設計和起草實施計劃。
- 此模式由靈活的策略引擎、代理技能和鉤子控制，允許對安全規則、工具存取和歸檔工作流程進行深度自訂。
- Gemini 會自動分配用於規劃的高推理 Pro 模型和用於執行的快速 Flash 模型，從而優化各個階段的品質和性能。
- 規劃模式與互動式控制、非互動式管道以及 Conductor 等擴充功能集成，以支援從快速任務到複雜的多步驟專案的一切需求。
Gemini CLI 中的計劃模式本質上是一個安全的唯讀駕駛艙，您可以在其中仔細思考複雜的更改，然後再觸碰一行程式碼。 您不會直接開始編輯，而是與代理商一起進行研究、設計和規劃，Gemini 會仔細檢查您的程式碼庫、工具和文檔，同時保護您的專案免受意外修改。
此模式專為希望在實施開始前獲得結構、安全性和清晰度，同時又不犧牲速度或靈活性的開發人員而設計。 你可以利用它來規劃資料庫遷移、新功能開發、重構或審計，同時還能藉助高推理模型、自訂策略、代理技能，甚至在 CI/CD 中實現無頭工作流程。你可以把它想像成一個規劃沙箱，其中所有操作都經過精心設計且可追溯。
Gemini CLI 中的計劃模式是什麼？
計劃模式是 Gemini CLI 中的一種唯讀操作模式，它將代理限制為一組受限的安全工具。 Gemini 運行時可以瀏覽您的程式碼倉庫、檢查文件、搜尋模式並讀取文檔，但它無法更改您的專案文件或執行任何可能改變專案狀態的命令。它唯一可以寫入的檔案是自己的內部計劃工件。
計劃模式背後的主要理念是將思考與行動分開。 首先，Gemini 會專注於理解您的請求，分析程式碼庫、依賴項和環境，並制定詳細的計劃。只有在您明確批准該計劃後，CLI 才會進入編輯或執行模式來執行變更。
Gemini CLI 的新用戶預設啟用規劃模式，這意味著大多數工作流程都以研究為先的思維方式開始。 您隨時可以將其關閉或從工作流程中移除，但預設行為是將計劃視為首要階段，尤其是對於重大或風險較大的變更。
此模式也與其他 Gemini 功能緊密整合，例如代理技能、策略引擎、MCP 工具和模型控制。 這不僅使它成為一種安全機制，而且還為建立穩健、合理的解決方案提供了一個強大的環境。
如何啟用和進入計劃模式
計劃模式通常預設為開啟，但您可以控制 Gemini CLI 在此模式下的啟動方式和時間。 根據您希望將其設為預設行為還是僅用於特定會話，有幾種方法可以配置或進入計劃模式。
如果您希望 Gemini CLI 始終以計劃模式啟動，您可以從 CLI 內部調整設定。 跑過 /設定 在命令中，找到名為「預設審批模式」的選項，並將其設為 計劃從那時起，每個新會議都將在這個唯讀的計畫環境中開始。
對於需要直接啟動計劃模式的一次性會話，可以使用命令列標誌。 使用以下命令啟動 CLI 雙子座 –審核模式=計劃 代理將立即在計劃模式的限制下運行，而無需您進行任何互動式切換。
當您已進入 Gemini CLI 時，有多種方法可以隨時切換到計劃模式。 你可以按 Shift + Tab鍵 若要在可用的審核模式（預設 → 自動編輯 → 排程）之間切換，請使用下列方法： /計劃 命令，或直接用自然語言要求智能體「啟動一個實現…目標的計畫」。在後台，Gemini 會呼叫… 進入計劃模式 用於切換模式的工具。
/plan 命令還允許您直接提供目標，這在您想要切換模式並立即開始規劃時非常方便。 例如，輸入 /計劃實施身份驗證 將 Gemini 置於計劃模式，並立即提交您關於身份驗證設計的請求，立即啟動研究和分析。
核心工作流程：研究、設計、草擬、審批
計劃模式將您的工作組織成一個簡單而強大的流程：定義目標、研究、設計、起草計劃，然後批准或迭代。 每個階段都經過精心劃分，以便您可以保持控制，避免意外的修改或冒險的操作。
首先，你要設定一個明確的目標。 你可以說「使用 Redis 規劃一個新的通知服務」或「研究如何遷移這個資料庫」。 Gemini 會根據這個目標進入規劃模式（如果尚未啟動），並以嚴格的唯讀方式開始探索你的程式碼庫、基礎設施和文件的相關部分。
在研究階段，Gemini 使用檔案清單、通配符、grep 式搜尋和其他唯讀功能等工具來建立系統的心理地圖。 在某些情況下，它可能依賴專門的子代理人，例如 程式碼庫調查員 或啟動針對特定領域客製化的代理技能，以便更好地了解依賴關係和架構。
一旦代理掌握了足夠的背景信息，它就會進入設計和討論階段。 在這裡，雙子座會提出策略，指出各種權衡取捨，並可能使用以下方式向您提出澄清問題： 詢問用戶 工具。這種反覆溝通有助於確保所選方法符合您的偏好、限制和現有慣例。
在你們口頭達成一致方向後，Gemini 會起草一份正式的實施計劃，該計劃以 Markdown 文件的形式儲存在你們的專用計劃目錄中。 這份文件內容詳盡且結構清晰：它列舉了任務、步驟、依賴關係、潛在風險，有時還列出了替代方案。在執行任何操作之前，您可以閱讀、編輯或新增註釋。
流程的最後一步是明確批准。 Gemini CLI 將顯示計劃並提供「是，自動接受編輯」或「是，手動接受編輯」等選項以開始實施。如果感覺有任何不妥之處，您可以提供回饋、自行編輯計畫文件，或直接取消計畫。 ESC 嘗試另一種方法。
共同製定計劃：討論、修改和評論
計劃模式的一個突出優點是，它將計劃視為您和 Gemini 可以共同編輯的共享文件。 這種協作方式比單純用自然語言提示來描述複雜的變化更加精確、快速。
當 Gemini 完成草稿並提交計劃以供審核時，您可以直接在您喜歡的外部編輯器中開啟它。 媒體中心 按Ctrl + X 在命令列介面 (CLI) 中，Markdown 計劃將在 VS Code、Vim 或您配置的任何編輯器中開啟。無需手動查找文件。
在編輯器中，您可以根據自己的喜好修改方案。 您可以重新排列步驟以更好地適應部署流程，重寫某些操作以提高清晰度，刪除您認為不必要的任務，或擴展需要更多細節的部分。您也可以新增內嵌註釋，例如「我們是否應該在此處重複使用現有的 Logger 類別？」或「根據目前的 SLO 驗證這一點」。
儲存並關閉編輯器後，Gemini CLI 會自動偵測您的變更和註解。 它會解析更新後的文檔，整合您的回饋，並完善其對策略的內部理解。然後，代理商會重新產生一份完善後的排程版本，供您再次審核。
這種編輯→完善→審查的循環可以重複多次，直到您對方案滿意為止。 準備好後，您給予明確的批准，只有這樣，Gemini 才會退出計劃模式，開始根據商定的步驟進行實際編輯或命令執行。
退出計劃模式並切換審批模式
無論您是否已完成計劃，或者只是想切換回其他審批模式，您都可以隨時退出計劃模式。 離開此環境前無需最終確定或批准計劃。
計劃模式最常見的結束方式是批准最終計劃。 一旦您確認 Gemini 應該開始實施，CLI 將自動退出計劃模式，並過渡到更寬鬆的模式，在該模式下，根據您的審批設置，允許進行編輯和調用更改狀態的工具。
如果您只想切換到另一種模式而無需批准任何內容，可以使用與進入計劃模式相同的鍵盤快捷鍵。 媒體中心 Shift + Tab鍵 根據您在進行積極開發工作時的偏好，在「計畫」和「預設」或「自動編輯」之間循環切換。
自然語言指令也適用於模式轉換。 您可以輸入「退出排程模式」或「停止排程」之類的短語，Gemini 會呼叫對應的模式切換工具來恢復您先前的操作。這樣，隨著工作流程的演變，您可以輕鬆地在計劃模式和退出計劃模式之間切換。
安全模型和計劃模式下的允許工具
在底層，規劃模式透過嚴格的安全策略來確保您的專案在規劃期間保持唯讀狀態。 此模式由 Gemini CLI 策略引擎和一個名為「Gemini CLI」的專用設定檔提供支援。 計劃.toml它定義了允許使用哪些工具以及這些工具如何運作。
計劃模式的內建策略被視為一級策略，始終專注於防止寫入或破壞性操作。 預設情況下，僅允許使用本質上安全的工具，例如檔案讀取、搜尋或清單。任何可能修改檔案、執行命令或更改外部系統的操作都會被阻止，除非您明確地覆寫這些規則。
策略引擎將未指定模式的規則視為全域激活，這意味著它們在計劃模式下也將適用。 如果您希望某條規則僅在其他模式下生效，而不在計畫模式下生效，則必須在該規則中明確列出目標模式。例如，如果您希望 npm 測試 若要允許在預設模式和自動編輯模式下運行，但絕不允許在計劃模式下運行，您需要配置一個排除計劃模式的模式清單。
另一個重要的安全特性是持久工具審核的範圍界定方式。 在較為寬鬆的模式（例如預設模式或自動編輯模式）下授予的權限不會自動延續到計劃模式。這可以防止您信任的實施工具在您仍在研究階段時悄悄運作。然而，在計劃模式下授予的權限將被視為有意授予，並且可以隨後全域應用於其他模式。
整體而言，計劃模式預設安全，但仍具有高度可自訂性。 您可以自訂哪些工具可用、如何審核以及在計劃建立和執行轉換過程中需要哪些類型的鉤子或日誌記錄。
自訂策略、MCP 工具和鉤子
除了內建的一級策略之外，您還可以透過新增自己的策略文件，進一步調整計畫模式以適應您的組織或個人工作流程。 它們生活在 ~/.gemini/policies/ 目錄被視為第二層級，因此它們可以改進或擴展在目錄中定義的預設行為。 計劃.toml.
一個常見的用例是控制只讀模型上下文協定 (MCP) 工具在計劃模式下的行為。 預設情況下，即使這些工具不具破壞性，Gemini 也可能要求使用者在呼叫它們之前進行確認。 工具註釋 和 mcpName 使用通配符，您可以定義自動批准或需要較少提示的特定模式或工具集，從而在嚴重依賴外部服務的環境中使規劃更加順暢。
您也可以新增鉤子，以便在計劃模式過渡到實施模式時觸發。 例如，如果您的組織需要對每個已批准的計劃進行審計跟踪，您可以添加一個 AfterTool 當 Gemini 退出計劃模式開始執行變更時，此鉤子會將最終的計劃工件複製到 Google Cloud Storage 或其他歸檔系統。
典型的鉤子可能是一個腳本，例如 ~/.gemini/hooks/archive-plan.sh，它接收有關會話和計劃文件的上下文。 這樣，您就可以在不改變手動工作流程的情況下強制執行合規性和可追溯性要求——每次計劃獲得批准時，都會自動備份以供以後審查或事件分析。
透過結合自訂策略和鉤子，團隊可以將自己的方法直接編碼到計劃模式中。 無論您需要更嚴格的審批、強制日誌記錄或特定環境的工具限制，策略引擎都能提供您所需的控制選項。
代理人技能和專業規劃工作流程
代理技能是 Gemini CLI 在計劃模式下調整特定類別工作規劃方式的關鍵機制。 技能包包含專門的指令、程序步驟和啟發式方法，指導智能體如何研究、設計和建構特定任務。
例如，「資料庫遷移」技能可能會強制要求每個計畫包含備份策略、資料驗證檢查和回溯程序。 與其每次都記住所有這些細節，不如依靠這項技能來確保每個遷移計劃都是安全且符合您的標準的。
同樣，「安全審計」技能可以促使 Gemini 在程式碼庫探索過程中主動查找漏洞或錯誤配置。 它可以指示代理程式掃描不安全的預設設定、缺失的身份驗證檢查或未加密的金鑰，然後在計劃工件中總結調查結果和補救步驟。
在前端方面，「前端設計」技能可以引導代理程式使用特定的 UI 元件庫和可存取性指南。 使用此技能產生的方案將自動參考您的設計系統、ARIA 實踐或效能限制，有助於維持使用者介面的一致性和包容性。
要在計劃模式下使用技能，您可以明確地要求 Gemini CLI “使用具備規劃技能…」或簡單地描述你的任務，以便智能體能夠自主啟動相關的技能。 一旦激活，該技能將改變規劃階段的運作方式，從研究重點到最終 Markdown 計劃的結構。
由於技能與 Plan Mode 的安全模型無縫集成，即使是高度專業化的工作流程也能從唯讀保證和審批門中受益。 您可以獲得深入的、領域感知的規劃，而不會使您的環境受到意想不到的副作用的影響。
模型路由：Pro 用於規劃，Flash 用於執行
Gemini CLI 包含自動模型路由功能，利用規劃模式來平衡推理品質和執行速度。 當您使用自動模型配置時，CLI 會根據您處於規劃階段還是實施階段選擇不同的 Gemini 模型。
在計劃模式下，請求會被路由到高推理能力的專業模型，例如 Gemini 3.1 Pro。 該模型針對複雜分析、架構決策、長上下文推理和複雜方案的製定進行了最佳化。其目標是最大限度地提高方案本身的品質和穩健性，即使這需要更多的計算資源。
一旦計劃獲得批准並退出計劃模式，CLI 就會偵測到實施階段已經開始，並自動切換到高速 Flash 模型。 在這裡，優先考慮的是反應速度和成本效益：代理主要執行定義明確的步驟，而不是做出重大的策略決策，因此速度更快的模型通常就足夠了。
這種預設行為提供了一種巧妙的權衡：設計時緩慢而深思熟慮，建造時快速而有效率。 如果您出於任何原因更喜歡不同的設置，您可以在設置中停用自動切換，並手動為每種模式配置特定型號。
像 Gemini 2.5 Flash 和 Gemini 2.5 Flash‑Lite 這樣的新型號繼續改進這種平衡。 憑藉更強大的工具使用能力、更低的延遲和更完善的指令執行能力，他們可以更可靠地執行計劃步驟，同時控制代幣使用和成本。
會話保留、清理和自訂計畫目錄
為了保持開發環境整潔，Gemini CLI 會自動管理會話資料和相關的計畫文件。 預設情況下，每個會話（包括其計劃和任務追蹤器）都會保留 30 天，然後被清理。
您可以使用 /settings 指令來變更此保留期限，也可以直接編輯 settings.json 配置。 找到「會話保留」設置，並根據您的需求進行調整；對於長期項目，您可能需要更長的視窗期，而對於短暫的實驗，您可能會喜歡較短的保留期。
除了自動清理之外，您還可以隨時手動刪除會話。 從命令列使用 gemini –刪除會話 若要刪除特定會話及其相關文件，或者，開啟會話瀏覽器。 /總結使用介面進行導航，然後按 x 刪除選定的會話。
如果您配置了自訂計劃目錄，請注意，自動刪除不會刪除這些計劃檔案。 您需要手動管理該目錄，如果您想將計劃視為永久文件或將其與程式碼一起儲存在版本控制系統中，這將是一個優勢。
這種方法賦予你靈活性：當你只關心立即執行時，可以使用短期計劃；或者，你可以維護一個精心整理的戰略計劃檔案，以供將來參考和遵守。
具有計劃模式的非互動式和 CI/CD 工作流程
計劃模式不僅適用於互動式終端會話；它也能很好地與腳本和 CI/CD 管道等非互動式環境配合使用。 在這些情況下，策略引擎被配置為自動批准某些規劃工具，這樣工作流程就不會因為等待使用者輸入而停滯。
具體來說，當 Gemini CLI 偵測到非互動式上下文時，它會自動批准 enter_plan_mode 和 exit_plan_mode 工具。 這意味著您的流程可以以程式方式觸發規劃，讓 Gemini 產生計劃，然後無需手動確認對話方塊即可進入執行階段。
非互動式工作流程的另一個關鍵差異在於規劃模式結束後、實施開始後會發生什麼。 CLI 沒有切換到標準的預設模式，而是切換到了其他模式。 YOLO模式它旨在自動執行步驟，而不會卡在互動式工具審批環節。
這種便於自動化的行為使得建立完全腳本化的工作流程成為可能，其中規劃和執行可以端到端地運行。 您仍然可以從結構化的規劃階段中受益，但一旦計劃準備就緒並根據您的政策獲得批准，流程就可以以機器速度進行。
模型轉向在計劃模式下
模型控制功能可讓您在 Gemini 進行研究或製定計劃時即時對其進行微調，這可以顯著縮短反饋週期並提供幫助。 減輕模式幻覺. 無需等待整個週期完成，您可以在工具運行時插入提示或修正。
想像一下，你以這樣的提示開始：“/plan 我想使用 Redis 實現一個新的通知服務。” Gemini 進入計劃模式，開始掃描程式碼庫，並開始探索目錄。當您觀察工具呼叫時—也許它列出了錯誤的路徑—您可以輸入類似「別忘了檢查 packages/common/queues 中是否存在 Redis 配置」這樣的語句。
即使旋轉的指針處於活躍狀態，Gemini 也能將線索融入目前的研究中。 然後，你會看到它在下一步檢查建議的目錄，並調整它對新服務應該位於何處的理解。
模型轉向在設計階段同樣非常有用。 如果初始方案傾向於簡單的隊列架構，但您更喜歡發布/訂閱模式，您可以說：「我們為這項服務使用發布/訂閱模式，而不是簡單的隊列。」Gemini 會暫停，重新考慮設計，並開始起草符合您偏好的新版本方案。
為了充分發揮轉向功能，盡量做到精準操控並及早介入。 諸如「使用 src/utils 中現有的 Logger 類別」或「我們計劃下個月棄用此模組」之類的明確說明，提供了僅從靜態程式碼分析可能無法明顯看出的上下文。
透過 Conductor 實現可擴展性並支援複雜的工作流程
對於大型或多步驟項目，Conductor 擴充展示了規劃模式如何成為更高階工作流程的支柱。 Conductor 專為上下文驅動開發而設計，它充當協調器，引導您完成複雜的遷移、功能發布或重構。
利用計劃模式，Conductor 可以在完全安全的環境下進行全面的飛行前檢查和深入的研究。 它將大型任務分解成里程碑，並使用 詢問用戶 該工具用於驗證每個階段的關鍵決策，並確保代理人不會在沒有您的高層批准的情況下倉促進行更改。
在整個過程中，Conductor 依靠計劃模式的唯讀原則和結構化規劃來產生子任務和詳細步驟。 在每個檢查點，它都會確認假設，收集缺失的信息，並更新整體軌跡，以便最終的實施既徹底又符合您的戰略。
Plan Mode 的設計，以及 enter_plan_mode 和 exit_plan_mode 等工具，都特意使其具有可擴展性，以便 Conductor 等解決方案可以基於它進行構建。 我們的目標不僅是為您提供一個安全的規劃開關，而且還為您提供一個基礎，您可以利用這個基礎來實現您自己的自訂編排層和開發方法。
Gemini CLI 團隊正在努力將 Conductor 作為內建模式更貼近核心體驗，進一步模糊規劃、編排和執行之間的界線。 這一方向凸顯了規劃模式對於未來結構化、人工智慧輔助發展的重要性。
總的來說，Gemini CLI 中的計劃模式不僅僅是一個簡單的安全開關；它是一個完整的計劃環境，融合了只讀探索、豐富的協作、可自訂的策略、高推理模型和自動化友好行為。 在進行下一個重大功能開發、遷移或審計時採用這種模式，可以讓你在任何程式碼變更生效之前，給自己一個清晰的思考、質疑和迭代空間，最終實現更清晰的實現，減少不必要的意外。
