mcp-tool-selection

Ta umiejętność uczy Cię, kiedy użyć zaawansowanego semantic search (MCP Qdrant-Indexer) zamiast tradycyjnych narzędzi grep czy odczytu plików. Dowiesz się, że do eksploracji kodu, debugowania i odpowiadania na pytania "gdzie/dlaczego" powinieneś sięgać po semantic search — zwraca on wyniki posortowane i kontekstowe. Grep i odczyt plików przydają się tylko do potwierdzenia dokładnych literałów lub gdy już wiesz, czego szukasz. Skill zawiera konkretne reguły decyzyjne: szukasz symbolu? Użyj symbol_graph. Chcesz zrozumieć architekturę? Użyj search z naturalnym językiem. Potrzebujesz struktury projektu? Użyj qdrant_status. Zamiast tracić czas na błędne narzędzia, nauczysz się wybierać to właściwe za pierwszym razem.

1. Zainstaluj umiejętność w swoim środowisku agenta, dodając ścieżkę do repozytorium Context-Engine-AI/Context-Engine (branch test, folder .skills/mcp-tool-selection).

2. Zapamiętaj główną zasadę: semantic search (MCP Qdrant-Indexer) jest domyślnym wyborem do eksploracji kodu, debugowania i pytań architektonicznych; grep i odczyt plików używaj tylko do potwierdzenia dokładnych ciągów znaków.

3. Gdy zaczynacie eksplorację nieznanego fragmentu kodu, zamiast otwierać plik lub szukać grep-em, użyjcie komendy search — automatycznie rozpozna Waszą intencję i skieruje do właściwego narzędzia specjalistycznego.

4. Do konkretnych zadań stosujcie reguły: szukanie definicji lub importerów symbolu → symbol_graph lub search_callers_for; pytania o relacje i wzorce w kodzie → search z naturalnym językiem; przeglądanie struktury projektu → qdrant_status z flagą list_all=true.

5. Grep i Read File zarezerwujcie wyłącznie na potwierdzenie istnienia dokładnego literału (np. REDIS_HOST) lub do edycji pliku, który już zlokalizowaliście za pomocą MCP.

6. Unikajcie anty-wzorców: nie uruchamiajcie grep -r na ogólne pojęcia (np. "auth") — to marnotrawstwo czasu. Zamiast tego sformułujcie pytanie naturalnym językiem w search i pozwólcie MCP zwrócić kontekstowe, posortowane wyniki.