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

3.1 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
gitnexus-search	Przeszukuje zdalny GitNexus po nazwie repo i promptcie użytkownika. Użyj gdy użytkownik wywołuje skill gitnexus-search, @gitnexus-search, lub podaje repo + zapytanie do grafu kodu (search, symbole, flow).	true

gitnexus-search

Jawne wyszukiwanie w zdalnym GitNexus (https://gitnexus.mobile.agency-ai.dev). Działa w Cursor (MCP) i Hermes (REST).

Przed pierwszym użyciem: jeśli brak połączenia lub MCP Error — przeczytaj gitnexus-connect.

Ścieżki

SKILLS_ROOT="${SKILLS_ROOT:-$HOME/Pulpit/cursor/skills}"
SEARCH_SCRIPT="$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py"

Format wejścia

gitnexus-search <repo> <prompt...>

Pierwszy token po nazwie skilla = repo
Cała reszta linii = prompt wyszukiwania (może zawierać spacje)

Przykłady:

gitnexus-search one-gateway gitnexus_workspace_dir
gitnexus-search ai-lawyer-srvr routes_paperless admin flow
gitnexus-search gateway deploy_runner install path

Aliasy repo

Użytkownik wpisuje	Repo GitNexus	Ścieżka MCP (przy konflikcie)
`one-gateway`, `gateway`	`one-gateway`	`/data/gitnexus/repos/one-gateway`
`ai-lawyer-srvr`, `ai-lawyer`	`ai-lawyer-srvr`	`/data/gitnexus/repos/ai-lawyer-srvr`

Nieznane repo → list_repos / GET /api/repos i pokaż dostępne nazwy.

Wykonanie — Cursor (preferowane)

Gdy MCP gitnexus jest Connected:

list_repos — potwierdź, że repo istnieje i ma stats.files > 0
query z argumentami:
- search_query: prompt użytkownika
- repo: znormalizowana nazwa (lub ścieżka bezwzględna z tabeli)
- limit: 10
Jeśli prompt sugeruje impact/zależności — opcjonalnie jeden context lub impact na top symbolu z wyników

Wykonanie — Hermes / fallback

Gdy MCP niedostępny — od razu REST, bez pytania użytkownika:

python3 "$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py" \
  <repo> "<prompt>"

Opcjonalnie: --limit N, --json, --server URL.

Format odpowiedzi

Nagłówek: repo + prompt (echo)
Tabela top 5–10 trafień: rank, filePath, score, kluczowe symbole/nodeIds
Synteza: 1–2 zdania — co wyniki sugerują w architekturze
Następny krok: context/impact (MCP), otwarcie pliku lokalnie, lub doprecyzowanie promptu

Błędy

Sytuacja	Akcja
Repo nieznane	Lista z `/api/repos`
Indeks pusty (`files: 0`)	Operator: re-index na hoście GitNexus (`gitnexus-connect/reference.md`)
MCP Error / brak narzędzi	REST przez `gitnexus-search.py`
HTTP / timeout	`bash "$SKILLS_ROOT/gitnexus-connect/scripts/gitnexus-health.sh"`

Powiązane

Setup: gitnexus-connect
Graph workflow: gitnexus-graph
Skrypt: scripts/gitnexus-search.py
Hermes: one-gateway/docs/hermes/GITNEXUS-CLIENT.md
Indeks skilli: ../README.md

3.1 KiB Raw Blame History Unescape Escape