Add universal GitNexus skills for Cursor and Hermes.

Consolidate connect, graph, and search workflows with mobile endpoint defaults and shared installation docs. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-01 16:08:15 +02:00
parent fa48844fb3
commit 287c08ebfc
6 changed files with 428 additions and 35 deletions
@@ -0,0 +1,75 @@
+---
+name: gitnexus-graph
+description: >-
+  Preferuj GitNexus przy zrozumieniu architektury, zależności, impact analysis,
+  łańcuchów wywołań, przepływu danych lub refaktoryzacji cross-file.
+  Użyj gdy MCP gitnexus jest dostępny i zadanie zależy od relacji w kodzie.
+disable-model-invocation: true
+---
+
+# gitnexus-graph
+
+Graph-first workflow dla **Cursor** (MCP) i **Hermes** (MCP lub REST fallback).
+
+## Kiedy używać GitNexus
+
+- MCP `gitnexus` jest Connected (lub REST działa — patrz `gitnexus-connect`)
+- użytkownik pyta o architekturę
+- zadanie zależy od zależności lub powiązanych plików
+- potrzebujesz impact analysis przed refaktoryzacją
+- śledzisz łańcuch wywołań lub przepływ danych
+- potrzebujesz kontekstu na poziomie symboli w wielu plikach
+
+## Kiedy NIE wymagać GitNexus
+
+- poprawka literówki
+- edycja jednego oczywistego pliku
+- mechaniczny rename lub formatowanie
+- proste „gdzie jest X?” gdy `rg` wystarczy
+
+## Startup checklist
+
+1. Jeśli brak połączenia — najpierw [`gitnexus-connect`](../gitnexus-connect/SKILL.md)
+2. `list_repos` — potwierdź, że docelowe repo jest zaindeksowane (`stats.files > 0`)
+3. Pytanie o symbol → `context` najpierw
+4. Przed refaktoryzacją → `impact`
+5. Eksploracja otwarta → `query`
+
+## Narzędzia MCP
+
+| Narzędzie | Zastosowanie |
+|-----------|--------------|
+| `list_repos` | Lista zaindeksowanych repo |
+| `query` | Semantyczne wyszukiwanie w grafie |
+| `context` | Kontekst wokół symbolu lub pliku |
+| `impact` | Wpływ zmiany na resztę kodu |
+
+Przy wielu repo podawaj `repo` explicite (nazwa lub ścieżka bezwzględna z indeksu).
+
+## Default workflow
+
+1. Oceń, czy zadanie jest relationship-heavy czy proste/lokalne.
+2. Jeśli relationship-heavy i MCP dostępny — GitNexus najpierw.
+3. Po wynikach grafu czytaj tylko najbardziej relevantne pliki lokalnie.
+4. Fallback na `rg` / Read / SemanticSearch gdy GitNexus niedostępny lub niekompletny.
+
+## Fallback
+
+| MCP niedostępny | Akcja |
+|-----------------|-------|
+| Cursor | `gitnexus-connect` → napraw MCP; lub `gitnexus-search` (REST) |
+| Hermes | REST: `gitnexus-search/scripts/gitnexus-search.py` |
+| Ogólnie | `rg`, Read, SemanticSearch |
+
+## Przykładowe prompty
+
+- „Jak działa ten moduł?”
+- „Które pliki są powiązane z `gitnexus_workspace_dir`?”
+- „Co może się zepsuć, jeśli zmienię `deploy_runner.py`?”
+- „Pokaż impact zmiany ścieżki instalatora.”
+
+## Powiązane
+
+- Setup: [`gitnexus-connect`](../gitnexus-connect/SKILL.md)
+- Jawne wyszukiwanie: [`gitnexus-search`](../gitnexus-search/SKILL.md)
+- Extended docs: `one-gateway/coding-agent/35-cursor-gitnexus-mcp-setup.md`