tomasz-syn-grzegorza
287c08ebfc
Consolidate connect, graph, and search workflows with mobile endpoint defaults and shared installation docs. Co-authored-by: Cursor <cursoragent@cursor.com>
94 lines
3.1 KiB
Markdown
94 lines
3.1 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).
|
||
|
||
**Przed pierwszym użyciem:** jeśli brak połączenia lub MCP Error — przeczytaj [`gitnexus-connect`](../gitnexus-connect/SKILL.md).
|
||
|
||
## Ścieżki
|
||
|
||
```bash
|
||
SKILLS_ROOT="${SKILLS_ROOT:-$HOME/Pulpit/cursor/skills}"
|
||
SEARCH_SCRIPT="$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py"
|
||
```
|
||
|
||
## 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 "$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py" \
|
||
<repo> "<prompt>"
|
||
```
|
||
|
||
Opcjonalnie: `--limit N`, `--json`, `--server URL`.
|
||
|
||
## 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`) | 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`](../gitnexus-connect/SKILL.md)
|
||
- Graph workflow: [`gitnexus-graph`](../gitnexus-graph/SKILL.md)
|
||
- Skrypt: [`scripts/gitnexus-search.py`](scripts/gitnexus-search.py)
|
||
- Hermes: `one-gateway/docs/hermes/GITNEXUS-CLIENT.md`
|
||
- Indeks skilli: [`../README.md`](../README.md)
|