Modalità di modifica di Inspector (con ambito sessione)
RegolaStabilisce una modalità di modifica dell'Inspector stateful basata sulle sessioni per la manutenzione congiunta dei componenti React e dei relativi inspector di sviluppo isolati corrispondenti senza contaminazione tra sessioni.
Accedi per accedere a questa regola
Accedi con il tuo Profilo sviluppatore Google per visualizzare e copiare la regola completa utilizzata nella serie Build It!.
Profilo sviluppatore richiesto
Non hai l'idoneità per un profilo sviluppatore. Chiedi all'amministratore di Workspace di attivare questa funzionalità.
Crea un Profilo sviluppatore
Crea un Profilo sviluppatore Google senza costi per sbloccare tutte le competenze, le regole, i prompt e gli artefatti di Build It!
Iscriviti a Builder Central per sbloccare
Richiedi il tuo badge per gli abbonati Builder senza costi con un clic per sbloccare tutte le skill, le regole, i prompt e gli artefatti di Build It!
Come funziona la modalità di modifica di Inspector con ambito sessione
Quando esegui l'iterazione sui componenti UI con un Component Inspector aperto, vuoi che le modifiche ai componenti aggiornino la visualizzazione corrispondente dell'inspector nello stesso turno, senza forzare in modo permanente le modifiche dell'inspector nelle sessioni future. Questa regola risolve il problema utilizzando un file di indicatori con ambito di conversazione:
- Disattivata per impostazione predefinita per ogni nuova sessione: le nuove conversazioni iniziano in modalità normale, quindi le modifiche di routine interessano solo i file esatti richiesti.
- Attiva la modalità di modifica di Inspector: di' "Attiva la modalità di modifica di Inspector" (o "Attiva la modalità Inspector"). L'agente crea un file di indicatore basato sulle sessioni in
<appDataDir>/brain/<conversation-id>/inspector-mode.active, leggesrc/dev/registry.tsed elenca ogni componente registrato coperto per questa sessione. - Manutenzione congiunta automatica: quando è attiva, qualsiasi modifica richiesta a un componente registrato aggiorna prima il componente e sincronizza immediatamente il
src/dev/inspectors/[ComponentName]Inspector.tsxcorrispondente utilizzando il workflow Component Inspector Updater, eseguenpx tsc --noEmite contrassegna la risposta con un chip di conferma. - Esci in qualsiasi momento: di' "Esci dalla modalità di modifica dell'inspector" per rimuovere il file del marker e tornare alla normale modifica di un singolo target. L'attivazione della modalità in una sessione non influisce mai sulle sessioni parallele o future.
Come installare in Google Antigravity
Inserisci questa regola nel tuo workspace Google Antigravity insieme alle due skill di Component Inspector della puntata 9:
- Crea la cartella
.agents/rules/nell'area di lavoro del progetto (o apri Google Antigravity Customizations > Rules per aggiungere una regola dell'area di lavoro). - Salva la regola Markdown completa di seguito come
inspector-editing-mode.mdall'interno di.agents/rules/. - Installa le skill complementari Component Inspector Generator e Component Inspector Updater in modo che l'agente disponga sia dei workflow di scaffolding sia di quelli di sincronizzazione a cui fa riferimento questa regola.
Regola di definizione della modalità di modifica di Inspector
Copia questa definizione completa della regola nel tuo workspace come inspector-editing-mode.md.
# Inspector Editing Mode (Session-Scoped)
This rule establishes a stateful, session-scoped **Inspector Editing Mode** for co-maintaining React components and their corresponding isolated development inspectors (`src/dev/inspectors/[ComponentName]Inspector.tsx`).
---
## 1. Scope & Isolation Model
* **Session-Scoped**: The on/off state of this mode is strictly scoped to the current conversation session (`<conversation-id>`).
* **Default State**: Every new conversation session begins with Inspector Editing Mode **OFF** by default.
* **State Marker**:
- Activation is tracked at `<appDataDir>/brain/<conversation-id>/inspector-mode.active`.
- If this file exists for the active session's conversation ID, Inspector Editing Mode is **ON**.
- If this file does NOT exist, Inspector Editing Mode is **OFF**.
* **Zero Cross-Session Contamination**: Turning this mode on in one conversation has no effect on any other parallel or future conversation sessions.
---
## 2. Trigger Commands & State Transitions
### A. Entering Inspector Mode
* **Trigger Phrases**:
- *"Enter inspector editing mode"*
- *"Start inspector editing mode"*
- *"Turn on inspector mode"*
- *"Inspector mode on"*
* **Agent Action**:
1. Create the marker file at `<appDataDir>/brain/<conversation-id>/inspector-mode.active`.
2. Read `src/dev/registry.ts` to identify all currently registered components.
3. Respond confirming:
- Inspector Editing Mode is now **ACTIVE** for this session.
- Any subsequent changes to registered components will automatically update both the component and its dev inspector.
- List the currently registered components covered by this mode.
### B. Exiting Inspector Mode
* **Trigger Phrases**:
- *"Exit inspector editing mode"*
- *"Stop inspector editing mode"*
- *"Turn off inspector mode"*
- *"Inspector mode off"*
* **Agent Action**:
1. Remove the marker file at `<appDataDir>/brain/<conversation-id>/inspector-mode.active` if present.
2. Respond confirming that Inspector Editing Mode is now **DEACTIVATED** for this session and normal single-target editing has resumed.
### C. Status Query
* **Trigger Phrases**:
- *"Is inspector mode active?"*
- *"Inspector mode status"*
- *"What mode am I in?"*
* **Agent Action**:
- Check for the existence of `<appDataDir>/brain/<conversation-id>/inspector-mode.active`.
- Report whether the current session is in **Inspector Mode** or **Normal Mode**.
---
## 3. Co-Maintenance Behavior While Mode is ACTIVE
Whenever the user requests changes, fixes, or refactors to ANY component registered in `src/dev/registry.ts`:
1. **Step 1: Update the Core Component**
- Apply the requested code changes, props modifications, or behavioral logic in `src/components/.../[ComponentName].tsx` (or `src/views/.../[ComponentName].tsx`).
- Update any relevant unit tests in `scripts/` or `__tests__/`.
2. **Step 2: Automatically Synchronize the Dev Inspector**
- Locate the matching inspector at `src/dev/inspectors/[ComponentName]Inspector.tsx`.
- Apply the `component-inspector-updater` workflow:
- **Props & State**: Reconcile any new, altered, or deleted props into the *Editable State* or *Props State* categories.
- **Computed State**: Update derived `useMemo` metrics if underlying rules or formulas changed.
- **Test Verification Cards**: Synchronize the plain-English test fixtures at the bottom of the inspector with the new behavior, updating click handlers so `[Load Test Fixture]` accurately reflects the new state.
- **Preserve Custom Presets**: Keep all existing scenario presets (e.g. week overhauls, superset pairs, edge cases) intact, adapting their shapes to new prop signatures.
- **Advance Timestamp Chip**: Advance `const GENERATED_AT = 'YYYY-MM-DD HH:MM [TIMEZONE]';` to the current local timestamp.
- **No Auto-Scroll**: Ensure all internal scrolling is scoped strictly to element containers (`containerRef.current.scrollTop = containerRef.current.scrollHeight`) with zero page-level scrolling.
3. **Step 3: Verify Types**
- Run `npx tsc --noEmit` to ensure type alignment between the component and its inspector.
- **DO NOT** run raw `npm run build` while a local dev server is active to prevent wiping out `.next/` chunk manifests.
4. **Step 4: Badge Confirmation in Response**
- Include an explicit status chip in your response header or summary:
`[Inspector Mode: Synced <ComponentName> & Dev Inspector]`
---
## 4. Behavior While Mode is INACTIVE (Default)
* When the mode is OFF, the agent performs only the exact requested file modifications.
* Do NOT edit `src/dev/inspectors/` unless the user explicitly requests an inspector update or instructs the agent to create a brand new inspector route.