Tryb edycji inspektora (ograniczony do sesji)
Rule (Reguła)Ustanawia stanowy, ograniczony do sesji tryb edycji inspektora na potrzeby wspólnego utrzymywania komponentów React i odpowiadających im odizolowanych inspektorów programistycznych bez zanieczyszczenia między sesjami.
Zaloguj się, aby uzyskać dostęp do tej reguły
Zaloguj się za pomocą profilu dewelopera w Google Play, aby wyświetlić i skopiować pełną regułę używaną w serii Build It!
Wymagany jest profil dewelopera
Nie kwalifikujesz się do utworzenia profilu dewelopera. Poproś administratora Workspace o włączenie tej funkcji.
Utwórz profil dewelopera
Utwórz bezpłatny profil dewelopera w Google, aby odblokować wszystkie umiejętności, reguły, prompty i artefakty w Build It!
Dołącz do Builder Central, aby odblokować
Odbierz bezpłatną plakietkę wspierającego, aby jednym kliknięciem odblokować wszystkie umiejętności, reguły, prompty i artefakty w Build It!
Jak działa tryb edycji inspektora ograniczony do sesji
Gdy iterujesz komponenty UI z otwartym inspektorem komponentów, chcesz, aby zmiany komponentów aktualizowały pasujący widok inspektora w tej samej turze, bez trwałego wymuszania zmian inspektora w przyszłych sesjach. Ta reguła rozwiązuje ten problem za pomocą pliku znacznika o zakresie rozmowy:
- Domyślnie wyłączony w każdej nowej sesji: nowe rozmowy rozpoczynają się w trybie normalnym, dzięki czemu rutynowe zmiany dotyczą tylko tych plików, o które prosisz.
- Włączanie trybu edycji inspektora: powiedz „Włącz tryb edycji inspektora” (lub „Włącz tryb inspektora”). Agent tworzy plik znacznika ograniczony do sesji w
<appDataDir>/brain/<conversation-id>/inspector-mode.active, odczytujesrc/dev/registry.tsi wyświetla listę wszystkich zarejestrowanych komponentów objętych tą sesją. - Automatyczna współkonserwacja: gdy ta funkcja jest aktywna, każda zmiana, o którą poprosisz w przypadku zarejestrowanego komponentu, najpierw aktualizuje komponent, a następnie natychmiast synchronizuje pasujący element
src/dev/inspectors/[ComponentName]Inspector.tsxza pomocą przepływu pracy Component Inspector Updater, uruchamianpx tsc --noEmiti oznacza odpowiedź elementem potwierdzenia. - W każdej chwili możesz wyjść z trybu edycji: powiedz „Exit inspector editing mode” (Wyjdź z trybu edycji inspektora), aby usunąć plik znacznika i powrócić do normalnego trybu edycji pojedynczego celu. Włączenie trybu w jednej sesji nigdy nie wpływa na sesje równoległe ani przyszłe.
Jak zainstalować w Google Antigravity
Umieść tę regułę w obszarze roboczym Google Antigravity obok 2 umiejętności inspektora komponentów z odcinka 9:
- Utwórz folder
.agents/rules/w obszarze roboczym projektu (lub otwórz Google Antigravity Dostosowania > Reguły, aby dodać regułę obszaru roboczego). - Zapisz pełną regułę Markdown poniżej jako
inspector-editing-mode.mdw folderze.agents/rules/. - Zainstaluj umiejętności towarzyszące Component Inspector Generator i Component Inspector Updater, aby agent miał zarówno przepływy pracy dotyczące szkieletu, jak i synchronizacji, do których odwołuje się ta reguła.
Definicja reguły trybu edycji inspektora
Skopiuj tę pełną definicję reguły do obszaru roboczego jako 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.