Mode d'édition de l'outil d'inspection (de portée session)
RègleÉtablit un mode d'édition de l'inspecteur avec état et de portée session pour la maintenance conjointe des composants React et de leurs inspecteurs de développement isolés correspondants, sans contamination entre les sessions.
Connectez-vous pour accéder à cette règle
Connectez-vous avec votre profil de développeur Google pour afficher et copier la règle complète utilisée dans la série "Build It!".
Profil de développeur requis
Vous n'êtes pas éligible à un profil de développeur. Demandez à votre administrateur Workspace d'activer cette fonctionnalité.
Créer un profil de développeur
Créez un profil de développeur Google sans frais pour débloquer toutes les compétences, règles, requêtes et artefacts de Build It!.
Rejoignez Builder Central pour débloquer
Réclamez votre badge de membre Builder sans frais en un clic pour débloquer toutes les compétences, règles, prompts et artefacts de Build It!.
Fonctionnement du mode d'édition de l'inspecteur de portée session
Lorsque vous effectuez des itérations sur des composants d'interface utilisateur avec un inspecteur de composants ouvert, vous souhaitez que les modifications apportées aux composants mettent à jour la vue de l'inspecteur correspondante au même moment, sans forcer définitivement les modifications de l'inspecteur lors des sessions futures. Cette règle résout ce problème à l'aide d'un fichier de repère limité à la conversation :
- Désactivé par défaut pour chaque nouvelle session : les nouvelles conversations démarrent en mode normal, de sorte que les modifications de routine ne concernent que les fichiers exacts que vous demandez.
- Activer le mode Édition de l'inspecteur : dites "Activer le mode Édition de l'inspecteur" (ou "Activer le mode Inspecteur"). L'agent crée un fichier de repère de portée session dans
<appDataDir>/brain/<conversation-id>/inspector-mode.active, litsrc/dev/registry.tset liste tous les composants enregistrés couverts pour cette session. - Co-maintenance automatique : lorsqu'elle est active, toute modification que vous demandez à un composant enregistré met d'abord à jour le composant et synchronise immédiatement son
src/dev/inspectors/[ComponentName]Inspector.tsxcorrespondant à l'aide du workflow Component Inspector Updater, exécutenpx tsc --noEmitet ajoute un chip de confirmation à la réponse. - Quittez proprement à tout moment : dites "Quitter le mode de modification de l'inspecteur" pour supprimer le fichier de repère et revenir à la modification normale d'une seule cible. L'activation du mode dans une session n'affecte jamais les sessions parallèles ou futures.
Installer dans Google Antigravity
Placez cette règle dans votre espace de travail Google Antigravity, à côté des deux compétences de l'inspecteur de composants de l'épisode 9 :
- Créez le dossier
.agents/rules/dans l'espace de travail de votre projet (ou ouvrez Google Antigravity Personnalisations > Règles pour ajouter une règle d'espace de travail). - Enregistrez la règle Markdown complète ci-dessous sous le nom
inspector-editing-mode.mddans.agents/rules/. - Installez les compétences complémentaires Générateur d'inspecteur de composants et Outil de mise à jour de l'inspecteur de composants afin que votre agent dispose des workflows de scaffolding et de synchronisation référencés par cette règle.
Définition de la règle du mode d'édition de l'outil d'inspection
Copiez l'intégralité de cette définition de règle dans votre espace de travail sous le nom 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.