وضع التعديل في أداة الفحص (على مستوى الجلسة)
القاعدةيُنشئ "وضع تعديل الفاحص" (Inspector Editing Mode) المستند إلى الحالة على مستوى الجلسة، وذلك للصيانة المشتركة لمكوّنات React وفاحصي التطوير المعزولين المقابلين لها بدون تداخل بين الجلسات.
يُرجى تسجيل الدخول للوصول إلى هذه القاعدة
سجِّل الدخول باستخدام ملفك الشخصي للمطوّر على Google للاطّلاع على القاعدة الكاملة المستخدَمة في سلسلة Build It! ونسخها.
يجب تحديد ملف شخصي للمطوّر
لست مؤهلاً لإنشاء ملف شخصي للمطوّر. يُرجى إبلاغ مشرف Workspace بتفعيل هذه الميزة.
إنشاء ملف شخصي كمطوّر
أنشِئ ملفًا شخصيًا للمطوّر على Google مجانًا للاستفادة من جميع المهارات والقواعد والطلبات والقطع الأثرية في Build It!.
انضم إلى Builder Central للاستفادة من المزايا
احصل على شارة عضوية "صانع" مجانية بنقرة واحدة للاستفادة من جميع مهارات وقواعد وطلبات ومصادر Build It!.
طريقة عمل وضع التعديل في "المفتّش" على مستوى الجلسة
عند تكرار مكوّنات واجهة المستخدم مع فتح "فاحص المكوّنات"، يجب أن تؤدي تعديلات المكوّنات إلى تعديل طريقة عرض الفاحص المطابقة في الجولة نفسها، بدون فرض تعديلات الفاحص بشكل دائم في الجلسات المستقبلية. تحلّ هذه القاعدة هذه المشكلة باستخدام ملف علامة على مستوى المحادثة:
- إيقاف الميزة تلقائيًا لكل جلسة جديدة: تبدأ المحادثات الجديدة في "الوضع العادي"، ما يضمن أنّ التعديلات الروتينية تؤثر فقط في الملفات التي تطلبها تحديدًا.
- الدخول إلى وضع تعديل المفتّش: قُل "الدخول إلى وضع تعديل المفتّش" (أو "تفعيل وضع المفتّش"). ينشئ الوكيل ملف علامة على مستوى الجلسة في
<appDataDir>/brain/<conversation-id>/inspector-mode.active، ويقرأsrc/dev/registry.ts، ويسرد كل مكوّن مسجَّل تم تناوله في هذه الجلسة. - الصيانة المشتركة التلقائية: عندما تكون هذه الميزة مفعّلة، فإنّ أي تغيير تطلبه على مكوّن مسجَّل يؤدي إلى تعديل المكوّن أولاً ومزامنة
src/dev/inspectors/[ComponentName]Inspector.tsxالمطابق له على الفور باستخدام سير عمل أداة تحديث أداة فحص المكوّنات، وتشغيلnpx tsc --noEmit، وإضافة شريحة تأكيد إلى الردّ. - الخروج من الوضع بسهولة في أي وقت: قُل "الخروج من وضع التعديل في أداة الفحص" لإزالة ملف العلامة والعودة إلى التعديل العادي لهدف واحد. ولا يؤثر تفعيل هذا الوضع في جلسة معيّنة على الجلسات الموازية أو المستقبلية.
كيفية التثبيت في Google Antigravity
ضَع هذه القاعدة في مساحة عمل Google Antigravity إلى جانب مهارتَي Episode 9 Component Inspector:
- أنشئ المجلد
.agents/rules/في مساحة عمل مشروعك (أو افتح Google Antigravity التخصيصات > القواعد لإضافة قاعدة مساحة عمل). - احفظ قاعدة Markdown الكاملة أدناه باسم
inspector-editing-mode.mdداخل.agents/rules/. - ثبِّت المهارات المرافقة Component Inspector Generator وComponent Inspector Updater لكي يتوفّر للوكيل كل من مهام سير العمل الخاصة بالبنية الأساسية والمزامنة التي تشير إليها هذه القاعدة.
تعريف قاعدة وضع التعديل في أداة الفحص
انسخ تعريف القاعدة الكامل هذا إلى مساحة العمل باسم 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.