Prüfmodus (sitzungsbezogen)
RegelRichtet einen zustandsorientierten, auf Sitzungsebene geltenden Inspector-Bearbeitungsmodus ein, um React-Komponenten und die zugehörigen isolierten Entwicklungs-Inspectors gemeinsam zu verwalten, ohne dass es zu sitzungsübergreifenden Konflikten kommt.
Melden Sie sich an, um auf diese Regel zuzugreifen
Melden Sie sich mit Ihrem Google-Entwicklerprofil an, um die vollständige Regel aus der „Build It!“-Reihe anzusehen und zu kopieren.
Entwicklerprofil erforderlich
Sie sind nicht berechtigt, ein Entwicklerprofil zu erstellen. Bitten Sie Ihren Workspace-Administrator, diese Funktion zu aktivieren.
Entwicklerprofil erstellen
Erstellen Sie ein kostenloses Google-Entwicklerprofil, um alle Build It!-Fähigkeiten, ‑Regeln, ‑Prompts und ‑Artefakte freizuschalten.
Builder Central beitreten, um freizuschalten
Sichern Sie sich mit nur einem Klick Ihr kostenloses Builder-Mitglieder-Badge, um alle Build It!-Skills, ‑Regeln, ‑Prompts und ‑Artefakte freizuschalten.
Funktionsweise des Bearbeitungsmodus für den sitzungsbezogenen Inspector
Wenn Sie UI-Komponenten bei geöffnetem Komponenten-Inspektor iterieren, möchten Sie, dass die Komponentenänderungen die entsprechende Inspektoransicht im selben Schritt aktualisieren, ohne dass Inspektoränderungen in zukünftigen Sitzungen dauerhaft erzwungen werden. Diese Regel löst das Problem mithilfe einer Markierungsdatei, die auf die Unterhaltung beschränkt ist:
- Standardmäßig für jede neue Sitzung deaktiviert: Neue Unterhaltungen beginnen im normalen Modus, sodass bei routinemäßigen Änderungen nur die von Ihnen angeforderten Dateien bearbeitet werden.
- Bearbeitungsmodus für den Inspector aufrufen: Sagen Sie „Bearbeitungsmodus für den Inspector aufrufen“ (oder „Inspector-Modus aktivieren“). Der Agent erstellt eine Markierungsdatei auf Sitzungsebene unter
<appDataDir>/brain/<conversation-id>/inspector-mode.active, liestsrc/dev/registry.tsund listet alle registrierten Komponenten auf, die für diese Sitzung abgedeckt sind. - Automatische Co-Wartung: Wenn diese Option aktiv ist, wird bei jeder Änderung, die Sie an einer registrierten Komponente anfordern, zuerst die Komponente aktualisiert und dann sofort die entsprechende
src/dev/inspectors/[ComponentName]Inspector.tsxüber den Workflow Component Inspector Updater synchronisiert. Außerdem wirdnpx tsc --noEmitausgeführt und die Antwort mit einem Bestätigungs-Chip versehen. - Jederzeit sauber beenden: Sagen Sie „Exit inspector Bearbeitungsmodus“, um die Markierungsdatei zu entfernen und zur normalen Bearbeitung eines einzelnen Ziels zurückzukehren. Wenn Sie den Modus in einer Sitzung aktivieren, hat das keine Auswirkungen auf parallele oder zukünftige Sitzungen.
Installation in Google Antigravity
Platzieren Sie diese Regel in Ihrem Google Antigravity-Arbeitsbereich zusammen mit den beiden Component Inspector-Skills aus Folge 9:
- Erstellen Sie den Ordner
.agents/rules/in Ihrem Projektarbeitsbereich oder öffnen Sie in Google Antigravity Anpassungen > Regeln, um eine Arbeitsbereichsregel hinzuzufügen. - Speichern Sie die vollständige Markdown-Regel unten als
inspector-editing-mode.mdin.agents/rules/. - Installieren Sie die Companion-Skills Component Inspector Generator und Component Inspector Updater, damit Ihr Agent sowohl die Gerüst- als auch die Synchronisierungsworkflows hat, auf die in dieser Regel verwiesen wird.
Regeldefinition für den Bearbeitungsmodus des Inspectors
Kopieren Sie diese vollständige Regeldefinition als inspector-editing-mode.md in Ihren Arbeitsbereich.
# 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.