- El mode de planificació proporciona un entorn estructurat i de només lectura per investigar, dissenyar i esbossar plans d'implementació abans de modificar cap codi.
- El mode es regeix per un motor de polítiques flexible, habilitats d'agent i hooks, cosa que permet una personalització profunda de les regles de seguretat, l'accés a les eines i els fluxos de treball d'arxivament.
- Gemini encamina automàticament models Pro d'alt raonament per a la planificació i models Flash ràpids per a l'execució, optimitzant la qualitat i el rendiment en totes les fases.
- El mode de planificació s'integra amb la direcció interactiva, les canalitzacions no interactives i extensions com ara Conductor per donar suport a tot, des de tasques ràpides fins a projectes complexos de diversos passos.
El mode de planificació a la CLI de Gemini és essencialment una cabina segura i de només lectura on podeu pensar en canvis complexos abans de tocar una sola línia de codi. En comptes de començar directament les edicions, tu i l'agent feu la recerca, el disseny i la planificació junts, mentre Gemini revisa la base de codi, les eines i la documentació, alhora que manté el projecte protegit de modificacions accidentals.
Aquest mode està dissenyat per a desenvolupadors que volen estructura, seguretat i claredat abans que comenci la implementació, sense sacrificar la velocitat ni la flexibilitat. Podeu utilitzar-lo per planificar migracions de bases de dades, noves funcions, refactoritzacions o auditories, tot aprofitant models d'alt raonament, polítiques personalitzades, habilitats d'agent i fins i tot fluxos de treball sense capçalera en CI/CD. Penseu-hi com un espai de proves de planificació on tot és deliberat i rastrejable.
Què és el mode de planificació a la CLI de Gemini?
El mode de planificació és un mode operatiu de només lectura a la CLI de Gemini que limita l'agent a un conjunt restringit d'eines segures. Mentre està actiu, Gemini pot explorar el vostre repositori, inspeccionar fitxers, cercar patrons i llegir documentació, però no pot canviar els fitxers del vostre projecte ni executar ordres arbitràries que podrien alterar l'estat. Els únics fitxers que pot escriure són els seus propis artefactes de pla intern.
La idea principal darrere del Mode Planificació és separar el pensament de l'acció. Primer, Gemini se centra en entendre la vostra sol·licitud, analitzar la base de codi, les dependències i l'entorn, i elaborar un pla detallat. Només després d'aprovar explícitament aquest pla, la CLI passa a un mode d'edició o d'execució per realitzar els canvis.
El mode de planificació està habilitat per defecte per als nous usuaris de la CLI de Gemini, cosa que significa que la majoria de fluxos de treball ja comencen amb una mentalitat centrada en la recerca. Sempre podeu desactivar-ho o eliminar-ho del flux de treball, però el comportament per defecte és tractar la planificació com una fase de primera classe, especialment per a canvis grans o arriscats.
El mode també està estretament integrat amb altres funcions de Gemini, com ara les habilitats d'agent, el motor de polítiques, les eines MCP i la direcció de models. Això el converteix no només en un mecanisme de seguretat, sinó també en un entorn potent per dissenyar solucions robustes i ben raonades.
Com habilitar i entrar en el mode de planificació
El mode de planificació normalment està activat de fàbrica, però podeu controlar com i quan s'inicia la CLI de Gemini en aquest mode. Hi ha diverses maneres de configurar o entrar en el mode de planificació, depenent de si el voleu com a comportament per defecte o només per a sessions específiques.
Si voleu que la CLI de Gemini s'iniciï sempre en mode de planificació, podeu modificar la configuració des de la CLI. executar el / settings comanda, localitzeu l'opció anomenada "Mode d'aprovació per defecte" i configureu-la a PlaA partir d'aquest moment, cada nova sessió començarà en aquest entorn de planificació de només lectura.
Per a sessions puntuals on voleu iniciar directament el mode de planificació, podeu utilitzar un indicador de línia d'ordres. Inicia la CLI amb bessons –mode-aprovació=pla i l'agent operarà immediatament sota les restriccions del mode de planificació sense que hàgiu d'activar res de forma interactiva.
Quan ja esteu dins de la CLI de Gemini, hi ha diverses maneres de canviar al mode de planificació sobre la marxa. Podeu prémer Maj + Tab per anar pels modes d'aprovació disponibles (Per defecte → Edició automàtica → Planifica), utilitzeu la tecla / pla ordre, o simplement demanar en llenguatge natural a l'agent que "iniciï un pla per a..." un objectiu determinat. Darrere de les escenes, Bessons invoca el introduir_mode_planificació eina per canviar de mode.
L'ordre /plan també permet proporcionar un objectiu en línia, cosa que és útil quan es vol canviar de mode i començar a planificar immediatament. Per exemple, escrivint /planifica l'autenticació de l'implementació posa Gemini en mode de planificació i envia instantàniament la vostra sol·licitud sobre el disseny d'autenticació, iniciant la investigació i l'anàlisi immediatament.
Flux de treball principal: recerca, disseny, esborrany, aprovació
El mode de planificació estructura la teva feina en un flux senzill però potent: defineix l'objectiu, investiga, dissenya, esborra un pla i, a continuació, aprova o itereix. Cada fase està separada intencionadament per tal que pugueu mantenir el control i evitar edicions inesperades o accions arriscades.
Primer, proporciones un objectiu clar. Podríeu dir "planifiqueu un nou servei de notificacions amb Redis" o "investigueu com migrar aquesta base de dades". Gemini utilitza aquest objectiu per entrar en el mode de planificació (si encara no està actiu) i comença a explorar les parts rellevants de la vostra base de codi, infraestructura i documentació de manera estrictament de només lectura.
Durant la fase de recerca, Gemini utilitza eines com el llistat de fitxers, el globalització, la cerca d'estil grep i altres funcions de només lectura per construir un mapa mental del sistema. En alguns casos, pot dependre de subagents especialitzats com ara un investigador_de_codebase o activar habilitats d'agent adaptades a dominis específics per entendre millor les dependències i l'arquitectura.
Un cop l'agent té prou context, passa a la fase de disseny i discussió. Aquí, Gemini proposa estratègies, planteja compromisos i et pot fer preguntes aclaridores utilitzant el pregunta_a_l'usuari eina. Aquest intercanvi ajuda a assegurar-se que l'enfocament escollit s'alinea amb les vostres preferències, restriccions i convencions existents.
Després d'acordar verbalment una direcció, Gemini esborra un pla d'implementació formal com a fitxer Markdown emmagatzemat al directori de plans dedicat. Aquest artefacte és detallat i estructurat: enumera tasques, passos, dependències, riscos potencials i, de vegades, opcions alternatives. El podeu llegir, editar o anotar abans que s'executi res.
El pas final del flux és l'aprovació explícita. La CLI de Gemini presentarà el pla i oferirà opcions com ara "Sí, acceptar edicions automàticament" o "Sí, acceptar edicions manualment" per iniciar la implementació. Si alguna cosa no està bé, podeu rebutjar-ho amb comentaris, editar el fitxer del pla vosaltres mateixos o simplement cancel·lar el pla amb Esc i provar un enfocament diferent.
Col·laboració en el pla: debat, edicions i comentaris
Un dels avantatges més destacats del mode Pla és que tracta el pla com un artefacte compartit que tu i Gemini podeu coeditar. Aquesta col·laboració pot ser més precisa i ràpida que descriure canvis complexos purament amb indicacions en llenguatge natural.
Quan Gemini acaba un esborrany i presenta el pla per a la seva revisió, el podeu obrir directament al vostre editor extern preferit. Premsa Ctrl + X des de la CLI i el pla Markdown s'obrirà a VS Code, Vim o qualsevol editor que hàgiu configurat. No cal buscar fitxers manualment.
Dins de l'editor, podeu modificar el pla com vulgueu. Podeu reordenar els passos per adaptar-los millor al vostre canal de desplegament, reescriure certes accions per a més claredat, eliminar tasques que considereu innecessàries o ampliar seccions que necessiten més detall. També podeu afegir comentaris en línia com ara "Hauríem de reutilitzar la classe Logger existent aquí?" o "Verifiqueu-ho amb els SLO actuals".
Un cop deseu i tanqueu l'editor, la CLI de Gemini detecta automàticament els canvis i comentaris. Analitza el document actualitzat, incorpora els vostres comentaris i refina la seva comprensió interna de l'estratègia. L'agent genera una versió polida del pla perquè la pugueu revisar de nou.
Aquest bucle d'editar → refinar → revisió es pot repetir tantes vegades com calgui fins que estigueu satisfets amb el pla. Quan estigueu a punt, doneu una aprovació clara i només llavors Gemini surt del mode de planificació per començar les edicions reals o l'execució d'ordres basades en els passos acordats.
Sortir del mode de planificació i canviar els modes d'aprovació
Podeu sortir del mode de planificació en qualsevol moment, tant si heu acabat de planificar com si simplement voleu tornar a un altre mode d'aprovació. No cal finalitzar ni aprovar un pla abans de deixar aquest entorn.
La manera més habitual com acaba el mode Planificació és quan aproves un pla finalitzat. Tan bon punt confirmeu que Gemini ha d'iniciar la implementació, la CLI surt automàticament del mode de planificació i passa a un mode més permissiu on es permeten edicions i crides d'eines que canvien d'estat, segons la vostra configuració d'aprovació.
Si només voleu canviar a un altre mode sense aprovar res, podeu utilitzar la mateixa drecera de teclat que feu servir per entrar al mode Plan. Premsa Maj + Tab per tornar del Pla a l'opció Per defecte o a l'edició automàtica, segons el que preferiu per al treball de desenvolupament actiu.
Les ordres en llenguatge natural també funcionen per a les transicions de mode. Podeu escriure frases com ara "sortir del mode de planificació" o "aturar la planificació" i Gemini cridarà l'eina de canvi de mode corresponent per restaurar el comportament anterior. Això facilita l'entrada i la sortida del context de planificació a mesura que evoluciona el flux de treball.
Model de seguretat i eines permeses en mode de planificació
Sota el capó, el mode de planificació s'aplica a polítiques de seguretat estrictes que garanteixen que el projecte es mantingui en un estat de només lectura durant la planificació. El mode està recolzat pel motor de polítiques de la CLI de Gemini i un fitxer de configuració dedicat anomenat pla.toml, que defineix quines eines estan permeses i com es comporten.
La política integrada per al mode de planificació es considera una política de nivell 1 i sempre se centra en la prevenció d'escriptures o accions destructives. Per defecte, només es permeten eines inherentment segures, com ara la lectura, la cerca o la llista de fitxers. Qualsevol cosa que pugui mutar fitxers, executar ordres o alterar sistemes externs es bloqueja tret que anul·leu explícitament les regles.
El motor de polítiques tracta les regles que no especifiquen modes com a globalment actives, és a dir, que també s'aplicaran durant el mode de planificació. Si voleu que una regla s'apliqui només en altres modes i no en el mode de planificació, heu d'enumerar explícitament els modes de destinació en aquesta regla. Per exemple, si voleu prova npm perquè es permeti en els modes Per defecte i Edició automàtica però mai en el mode Plan, l'hauríeu de configurar amb una llista de modes que exclogués el Plan.
Una altra característica de seguretat important és la manera com es delimiten les aprovacions d'eines persistents. Les aprovacions concedides en modes més permissius (com ara Per defecte o Edició automàtica) no es transfereixen automàticament al mode de planificació. Això impedeix que les eines en què confieu per a la implementació s'executin silenciosament mentre encara esteu en la fase de recerca. Tanmateix, les aprovacions concedides durant el mode de planificació es tracten com a deliberades i es poden aplicar globalment a altres modes posteriorment.
En general, el mode de planificació és segur per defecte, però encara és altament personalitzable. Podeu personalitzar quines eines estan disponibles, com requereixen aprovació i quin tipus de ganxos o registre voleu al voltant de la creació del pla i les transicions d'execució.
Polítiques personalitzades, eines MCP i hooks
Més enllà de les polítiques de nivell 1 integrades, podeu adaptar encara més el mode de planificació a la vostra organització o flux de treball personal afegint els vostres propis fitxers de polítiques. Aquests viuen a la ~/.gemini/polítiques/ directori i es consideren de nivell 2, de manera que poden refinar o ampliar el comportament per defecte definit a pla.toml.
Un cas d'ús comú és controlar com es comporten les eines del Protocol de context de model (MCP) de només lectura durant el mode de planificació. Per defecte, Gemini pot requerir la confirmació de l'usuari abans d'invocar aquestes eines, fins i tot quan no són destructives. Amb einaAnotacions i la Nom del mcp comodí, podeu definir patrons o conjunts d'eines específics que s'aproven automàticament o que requereixen menys indicacions, cosa que facilita la planificació en entorns que depenen en gran mesura de serveis externs.
També podeu adjuntar ganxos que es desencadenen quan el mode de planificació passa a la implementació. Per exemple, si la vostra organització necessita un registre d'auditoria de cada pla aprovat, podeu afegir un AfterTool hook que copia els artefactes del pla finalitzats a Google Cloud Storage o a un altre sistema d'arxiu sempre que Gemini surt del mode de planificació per començar a executar canvis.
Un hook típic pot ser un script com ara ~/.gemini/hooks/archive-plan.sh, que rep context sobre la sessió i el fitxer de pla. Això us permet fer complir els requisits de compliment i traçabilitat sense canviar el flux de treball manual: cada vegada que s'aprova un pla, es fa una còpia de seguretat automàtica per a la seva revisió o anàlisi d'incidents posteriors.
Combinant polítiques i hooks personalitzats, els equips poden codificar les seves pròpies metodologies directament en el mode de planificació. Tant si voleu aprovacions més estrictes, registre obligatori o restriccions d'eines específiques de l'entorn, el motor de polítiques us ofereix els controls que necessiteu.
Habilitats dels agents i fluxos de treball de planificació especialitzats
Les habilitats de l'agent són un mecanisme clau per adaptar la manera com la CLI de Gemini planifica categories específiques de treball mentre es manté dins del mode de planificació. Una habilitat inclou instruccions especialitzades, passos procedimentals i heurístiques que guien com l'agent investiga, dissenya i estructura una tasca concreta.
Per exemple, una habilitat de "Migració de bases de dades" podria imposar que cada pla inclogui estratègies de còpia de seguretat, comprovacions de validació de dades i procediments de reversió. En comptes de recordar tots aquests detalls cada vegada, podeu confiar en l'habilitat per assegurar-vos que cada pla de migració sigui segur i coherent amb els vostres estàndards.
De la mateixa manera, una habilitat d'"Auditoria de seguretat" podria impulsar Gemini a buscar activament vulnerabilitats o configuracions incorrectes durant l'exploració de la base de codi. Pot indicar a l'agent que escanegi valors per defecte no segurs, comprovacions d'autenticació que falten o secrets no xifrats i, a continuació, que resumeixi les troballes i els passos de correcció dins de l'artefacte del pla.
Al front-end, una habilitat de "Disseny Front-end" pot dirigir l'agent cap a biblioteques de components d'IU i directrius d'accessibilitat específiques. Els plans generats amb aquesta habilitat farien referència automàtica al vostre sistema de disseny, a les pràctiques ARIA o a les restriccions de rendiment, cosa que ajudaria a mantenir la interfície d'usuari coherent i inclusiva.
Per utilitzar una habilitat en mode de planificació, podeu demanar explícitament a la CLI de Gemini que "utilitzi la "habilitat per planificar..." o simplement descriviu la vostra tasca de manera que permeti a l'agent activar una habilitat rellevant de manera autònoma. Un cop activa, l'habilitat remodela el comportament de les fases de planificació, des de les prioritats de recerca fins a l'estructura del pla final de Markdown.
Com que les habilitats s'integren perfectament amb el model de seguretat del mode de planificació, fins i tot els fluxos de treball altament especialitzats es beneficien de les garanties de només lectura i les portes d'aprovació. Obteniu una planificació profunda i conscient del domini sense exposar el vostre entorn a efectes secundaris no desitjats.
Enrutament de models: Pro per a la planificació, Flash per a l'execució
La CLI de Gemini inclou l'encaminament automàtic de models que aprofita el mode de planificació per equilibrar la qualitat del raonament i la velocitat d'execució. Quan feu servir una configuració de model automàtic, la CLI tria diferents models Gemini segons si us trobeu en la fase de planificació o d'implementació.
Mentre esteu en mode de planificació, les sol·licituds es dirigeixen a un model Pro d'alt raonament, com ara Gemini 3.1 Pro. Aquest model està optimitzat per a anàlisis complexes, decisions arquitectòniques, raonament a llarg termini i redacció de plans complexos. L'objectiu és maximitzar la qualitat i la robustesa del pla en si, fins i tot si això requereix més càlcul.
Un cop s'aprova un pla i sortiu del mode de pla, la CLI detecta que s'ha iniciat una fase d'implementació i canvia automàticament a un model Flash d'alta velocitat. Aquí, la prioritat és la capacitat de resposta i l'eficiència en termes de costos: l'agent executa principalment passos ben definits en lloc de prendre grans decisions estratègiques, de manera que un model més ràpid sol ser suficient.
Aquest comportament per defecte ofereix un compromís intel·ligent: lent i atent a l'hora de dissenyar, ràpid i eficient a l'hora de construir. Si per alguna raó preferiu una configuració diferent, podeu desactivar el canvi automàtic a la configuració i configurar manualment models específics per a cada mode.
Els models més nous com el Gemini 2.5 Flash i el Gemini 2.5 Flash-Lite continuen millorant aquest equilibri. Amb millors capacitats d'ús d'eines, menor latència i un seguiment d'instruccions millorat, poden executar els passos del pla de manera més fiable, alhora que mantenen l'ús de tokens i els costos sota control.
Directoris de retenció de sessions, neteja i plans personalitzats
Per mantenir l'entorn de desenvolupament ordenat, la CLI de Gemini gestiona automàticament les dades de sessió i els fitxers de pla associats. Per defecte, cada sessió (inclosos els seus plans i seguiments de tasques) es conserva durant 30 dies abans de ser netejada.
Podeu canviar aquest període de retenció mitjançant l'ordre /settings o editant directament la configuració de settings.json. Busqueu l'opció "Retenció de sessió" i ajusteu-la segons les vostres necessitats; per a projectes de llarga durada, és possible que vulgueu una finestra més llarga, mentre que per a experiments efímers, és possible que preferiu una retenció més curta.
A més de la neteja automàtica, podeu activar l'eliminació manual de sessions en qualsevol moment. Des de la línia d'ordres, utilitzeu gemini –delete-sessió per eliminar una sessió específica i els seus artefactes. Alternativament, obriu el Navegador de sessions amb /resumeix, navegueu per la interfície i premeu x per eliminar la sessió seleccionada.
Si heu configurat un directori de plans personalitzats, és important tenir en compte que l'eliminació automàtica no elimina aquests fitxers de pla. Sou responsable de gestionar aquest directori manualment, cosa que pot ser un avantatge si voleu tractar els plans com a documentació permanent o emmagatzemar-los al control de versions juntament amb el vostre codi.
Aquest enfocament us ofereix flexibilitat: feu servir plans de curta durada quan només us interessa l'execució immediata o manteniu un arxiu curat de plans estratègics per a futures consultes i compliment.
Fluxs de treball no interactius i de CI/CD amb el mode de planificació
El mode de planificació no és només per a sessions de terminal interactives; també funciona bé amb entorns no interactius com ara scripts i pipelines de CI/CD. En aquests escenaris, el motor de polítiques està configurat per aprovar certes eines de planificació automàticament, de manera que el flux de treball no s'atura esperant l'entrada de l'usuari.
Concretament, quan la CLI de Gemini detecta un context no interactiu, aprova automàticament les eines enter_plan_mode i exit_plan_mode. Això significa que el vostre pipeline pot activar la planificació mitjançant programació, deixar que Gemini generi un pla i després passar a l'execució sense diàlegs de confirmació manuals.
Una altra diferència clau en els fluxos de treball no interactius és què passa després que finalitzi el mode de planificació i comenci la implementació. En lloc de passar al mode per defecte estàndard, la CLI canvia a Mode YOLO, que està dissenyat per executar passos automàticament sense quedar-se encallat en les aprovacions d'eines interactives.
Aquest comportament fàcil d'automatitzar permet crear fluxos de treball completament basats en scripts on la planificació i l'execució s'executen de principi a fi. Encara us beneficiareu de la fase de planificació estructurada, però el procés pot avançar a velocitat de màquina un cop el pla estigui a punt i aprovat d'acord amb les vostres polítiques.
Direcció del model dins del mode Planificació
La direcció del model us permet impulsar Gemini en temps real mentre investiga o esborra un pla, cosa que pot estrènyer significativament el bucle de retroalimentació i ajudar. mitigar les al·lucinacions del model. En comptes d'esperar que es completi un cicle complet, podeu inserir pistes o correccions mentre les eines s'executen.
Imagineu-vos que comenceu amb un missatge com ara "/plan Vull implementar un nou servei de notificacions amb Redis". Gemini entra en mode de planificació, comença a escanejar la base de codi i comença a explorar directoris. Mentre observeu les crides de l'eina (potser que llisten els camins incorrectes), podeu escriure alguna cosa com ara "No us oblideu de comprovar els paquets/cues/comuns per a la configuració de Redis existent".
Fins i tot mentre la ruleta està activa, Gemini pot incorporar aquesta pista a la seva investigació actual. Aleshores, veureu com inspecciona el directori suggerit al següent torn i ajusta la seva comprensió d'on hauria de residir el nou servei.
La direcció del model és igual d'útil durant la fase d'esborrany. Si el pla inicial s'inclina cap a una arquitectura de cua simple però preferiu un patró Pub/Sub, podeu dir "Utilitzem un patró Publisher/Subscriber en lloc d'una cua simple per a aquest servei". Gemini farà una pausa, reconsiderarà el disseny i començarà a esborrar una nova versió del pla d'acord amb les vostres preferències.
Per treure el màxim profit de la direcció, intenta ser específic i intervenir aviat. Instruccions clares com ara "feu servir la classe Logger existent a src/utils" o "tenim previst desaprovar aquest mòdul el mes que ve" proporcionen un context que pot no ser evident només a partir de l'anàlisi estàtica de codi.
Extensibilitat amb Conductor i fluxos de treball complexos
Per a projectes grans o de diversos passos, l'extensió Conductor mostra com el mode de planificació pot convertir-se en l'eix vertebrador de fluxos de treball més avançats. Conductor està dissenyat per al desenvolupament basat en context, actuant com a orquestrador que us guia a través de migracions complexes, desplegaments de funcions o refactoritzacions.
Aprofitant el mode Plan, Conductor pot executar comprovacions prèvies al vol completes i passos de recerca profunds en un entorn completament segur. Divideix les tasques grans en fites, utilitza el pregunta_a_l'usuari eina per validar les decisions crítiques en cada etapa i garanteix que l'agent mai no precipiti els canvis sense la vostra aprovació d'alt nivell.
Al llarg d'aquest procés, Conductor es basa en els principis de només lectura i la planificació estructurada del mode Planificació per generar subtasques i passos detallats. A cada punt de control, confirma les suposicions, recopila informació que falta i actualitza la trajectòria general perquè la implementació final sigui completa i estigui alineada amb la vostra estratègia.
El disseny del mode Plan amb eines com enter_plan_mode i exit_plan_mode es va fer deliberadament extensible perquè solucions com Conductor puguin construir-hi a sobre. L'objectiu no és només donar-vos un interruptor de planificació segur, sinó una base que podeu utilitzar per a les vostres pròpies capes d'orquestració personalitzades i metodologies de desenvolupament.
L'equip de Gemini CLI està treballant per apropar Conductor a l'experiència bàsica com a mode integrat, difuminant encara més la línia entre planificació, orquestració i execució. Aquesta direcció destaca la importància central del mode de planificació per al futur del desenvolupament estructurat i assistit per IA.
En general, el mode de planificació a la CLI de Gemini és més que un simple interruptor de seguretat; és un entorn de planificació complet que combina exploració de només lectura, col·laboració rica, polítiques personalitzables, models d'alt raonament i un comportament amigable amb l'automatització. Si adopteu aquest mode per a la vostra propera gran funció, migració o auditoria, us doneu un espai clar per pensar, qüestionar i iterar abans que es produeixi cap canvi de codi, cosa que en última instància porta a implementacions més netes i menys sorpreses desagradables.
