tomasz-syn-grzegorza
fa48844fb3
Introduce gitnexus-search skill with REST CLI for remote GitNexus queries by repo name and prompt. Co-authored-by: Cursor <cursoragent@cursor.com>
83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
---
|
||
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)
|