Mode Edit Inspector (Cakupan Sesi)
RuleMembuat Mode Pengeditan Inspector cakupan sesi stateful untuk pemeliharaan bersama komponen React dan inspector pengembangan terisolasi yang sesuai tanpa kontaminasi lintas sesi.
Login untuk mengakses aturan ini
Login dengan Profil Developer Google Anda untuk melihat dan menyalin aturan lengkap yang digunakan dalam seri Build It!.
Profil Developer Diperlukan
Anda tidak memenuhi syarat untuk profil developer. Minta administrator Workspace Anda untuk mengaktifkan fitur ini.
Buat Profil Developer
Buat Profil Developer Google gratis untuk mengakses semua keterampilan, aturan, perintah, dan artefak Build It!
Bergabunglah dengan Builder Central untuk Membuka Akses
Klaim badge langganan Builder gratis Anda dengan sekali klik untuk membuka semua keterampilan, aturan, perintah, dan artefak Build It!
Cara Kerja Mode Edit Pemeriksa Cakupan Sesi
Saat Anda melakukan iterasi pada komponen UI dengan Component Inspector terbuka, Anda ingin pengeditan komponen memperbarui tampilan inspector yang cocok pada giliran yang sama, tanpa memaksa pengeditan inspector secara permanen di sesi mendatang. Aturan ini menyelesaikan masalah tersebut menggunakan file penanda cakupan percakapan:
- NONAKTIF secara default untuk setiap sesi baru: Percakapan baru dimulai dalam Mode Normal sehingga pengeditan rutin hanya memengaruhi file yang Anda minta.
- Masuk ke Mode Pengeditan Inspektur: Ucapkan "Masuk ke mode pengeditan inspektur" (atau "Aktifkan mode inspektur"). Agen membuat file penanda cakupan sesi di
<appDataDir>/brain/<conversation-id>/inspector-mode.active, membacasrc/dev/registry.ts, dan mencantumkan setiap komponen terdaftar yang tercakup untuk sesi ini. - Pemeliharaan bersama otomatis: Saat aktif, setiap perubahan yang Anda minta pada komponen terdaftar akan memperbarui komponen terlebih dahulu dan segera menyinkronkan
src/dev/inspectors/[ComponentName]Inspector.tsxyang cocok menggunakan alur kerja Component Inspector Updater, menjalankannpx tsc --noEmit, dan memberi stempel pada respons dengan chip konfirmasi. - Keluar dengan aman kapan saja: Ucapkan "Exit inspector editing mode" untuk menghapus file penanda dan kembali ke pengeditan target tunggal normal. Mengaktifkan mode ini dalam satu sesi tidak akan memengaruhi sesi paralel atau sesi mendatang.
Cara Menginstal di Google Antigravity
Tempatkan aturan ini di ruang kerja Google Antigravity Anda bersama dengan dua keterampilan Component Inspector Episode 9:
- Buat folder
.agents/rules/di ruang kerja project Anda (atau buka Google Antigravity Customizations > Rules untuk menambahkan aturan ruang kerja). - Simpan aturan Markdown lengkap di bawah sebagai
inspector-editing-mode.mddi dalam.agents/rules/. - Instal skill pendamping Component Inspector Generator dan Component Inspector Updater agar agen Anda memiliki alur kerja scaffolding dan sinkronisasi yang dirujuk oleh aturan ini.
Definisi Aturan Mode Edit Inspector
Salin definisi aturan lengkap ini ke ruang kerja Anda sebagai 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.