Files

T

tomasz-syn-grzegorza 287c08ebfc 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

2.6 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
gitnexus-graph	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.	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

Jeśli brak połączenia — najpierw gitnexus-connect
list_repos — potwierdź, że docelowe repo jest zaindeksowane (stats.files > 0)
Pytanie o symbol → context najpierw
Przed refaktoryzacją → impact
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

Oceń, czy zadanie jest relationship-heavy czy proste/lokalne.
Jeśli relationship-heavy i MCP dostępny — GitNexus najpierw.
Po wynikach grafu czytaj tylko najbardziej relevantne pliki lokalnie.
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
Jawne wyszukiwanie: gitnexus-search
Extended docs: one-gateway/coding-agent/35-cursor-gitnexus-mcp-setup.md

2.6 KiB Raw Blame History