Add shared workspace skills for Cursor and Hermes.

Introduce gitnexus-search skill with REST CLI for remote GitNexus queries by repo name and prompt. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-01 13:31:03 +00:00
commit fa48844fb3
3 changed files with 308 additions and 0 deletions
@@ -0,0 +1,82 @@
+---
+name: gitnexus-search
+description: >-
+  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).
+disable-model-invocation: true
+---
+
+# gitnexus-search
+
+Jawne wyszukiwanie w zdalnym GitNexus (`https://gitnexus.mobile.agency-ai.dev`). Działa w **Cursor** (MCP) i **Hermes** (REST).
+
+## Format wejścia
+
+```text
+gitnexus-search <repo> <prompt...>
+```
+
+- Pierwszy token po nazwie skilla = **repo**
+- **Cała reszta linii** = prompt wyszukiwania (może zawierać spacje)
+
+Przykłady:
+
+```text
+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:
+
+1. `list_repos` — potwierdź, że repo istnieje i ma `stats.files > 0`
+2. `query` z argumentami:
+   - `search_query`: prompt użytkownika
+   - `repo`: znormalizowana nazwa (lub ścieżka bezwzględna z tabeli)
+   - `limit`: 10
+3. 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:
+
+```bash
+python3 /home/test-user/cursor/skills/gitnexus-search/scripts/gitnexus-search.py \
+  <repo> "<prompt>"
+```
+
+Opcjonalnie: `--limit N`, `--json`.
+
+## Format odpowiedzi
+
+1. **Nagłówek:** repo + prompt (echo)
+2. **Tabela** top 5–10 trafień: rank, filePath, score, kluczowe symbole/nodeIds
+3. **Synteza:** 1–2 zdania — co wyniki sugerują w architekturze
+4. **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`) | Wskazówka: re-index (`gitnexus-index-remote.py` w projekcie) |
+| MCP Error / brak narzędzi | REST przez `gitnexus-search.py` |
+| HTTP / timeout | `curl -fsS $GITNEXUS_SERVER_URL/api/health` |
+
+## Powiązane
+
+- Skrypt: [`scripts/gitnexus-search.py`](scripts/gitnexus-search.py)
+- Hermes: [`one-gateway/docs/hermes/GITNEXUS-CLIENT.md`](../../one-gateway/docs/hermes/GITNEXUS-CLIENT.md)
+- Workspace skills: [`../README.md`](../README.md)