A
add-nodebridge-handler
Dodawaj handlery do NodeBridge i synchronizuj komunikację między UI a Node.js
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill ułatwiający dodawanie nowych handleów do systemu NodeBridge, który zarządza komunikacją między warstwą interfejsu a backendem Node.js. Automatyzuje proces rejestracji handlera w src/nodeBridge.ts, aktualizacji typów w src/nodeBridge.types.ts oraz opcjonalnego testowania za pomocą dedykowanych skryptów. Zawiera konwencje nazewnictwa (notacja punktowa: kategoria.akcja), wzorce obsługi błędów i zwracania danych, a także listę dostępnych kategorii (config, git, mcp, models, project, session, utils i inne).
Jak używać
- Otwórz plik src/nodeBridge.ts i zlokalizuj metodę registerHandlers() w klasie NodeHandlerRegistry — tutaj będziesz rejestrować nowy handler.
- Dodaj implementację handlera, używając notacji punktowej dla nazwy (np. git.status, session.send). Zawsze pobierz kontekst za pomocą await this.getContext(cwd) i zwróć obiekt z polami success oraz data (lub error w przypadku niepowodzenia).
- Przejdź do pliku src/nodeBridge.types.ts i zdefiniuj typy wejściowe (Input) i wyjściowe (Output) dla nowego handlera, umieszczając je w odpowiedniej sekcji kategorii.
- Dodaj nowy handler do typu HandlerMap w tym samym pliku, aby zapewnić pełną typizację.
- Opcjonalnie przetestuj handler za pomocą skryptu scripts/test-nodebridge.ts, aby zweryfikować poprawność implementacji i komunikacji między UI a backendem.
- Upewnij się, że handler obsługuje błędy za pomocą try/catch i zwraca spójny format odpowiedzi — success: true z danymi lub success: false z komunikatem błędu.