Biblioteka promptów

Diagnoza błędu w aplikacji krok po kroku

Uporządkowana diagnostyka błędu bez zgadywania i z testami potwierdzającymi przyczynę.

Prompt – 6 zmiennych do uzupełnienia

Pomóż zdiagnozować błąd w aplikacji.
Technologia i wersje: [STACK / WERSJE]
Oczekiwane zachowanie: [OCZEKIWANE]
Rzeczywiste zachowanie: [RZECZYWISTE]
Kroki odtworzenia: [KROKI]
Komunikat błędu i istotny kod: [LOGI / KOD]
Co już sprawdziłem: [DOTYCHCZASOWE PRÓBY].

Najpierw wskaż najbardziej prawdopodobne przyczyny i poziom pewności. Następnie zaproponuj najmniejszy test, który odróżni te przyczyny. Nie podawaj dużej przebudowy jako pierwszego rozwiązania. Jeśli brakuje danych, zadaj maksymalnie 3 konkretne pytania. Po ustaleniu przyczyny zaproponuj poprawkę i test regresji. Nie twierdź, że uruchomiłeś kod, jeśli go faktycznie nie uruchomiłeś.

Kiedy użyć tego promptu

Gdy aplikacja działa inaczej, niż powinna, a pierwsze próby naprawy nie pomogły. Prompt prowadzi diagnozę jak doświadczony programista: najpierw najbardziej prawdopodobne przyczyny z poziomem pewności, potem najmniejszy test, który je rozróżni – zamiast od razu przepisywać połowę kodu.

Przykład

Przykładowe dane do uzupełnienia:

  • STACK / WERSJE: PHP 8.2, Laravel 11, MySQL 8, kolejki na Redisie
  • OCZEKIWANE: mail z potwierdzeniem zamówienia wysyła się w ciągu minuty
  • RZECZYWISTE: część maili przychodzi po kilku godzinach, część wcale
  • KROKI: złożenie zamówienia w sklepie testowym, sprawdzenie skrzynki
  • LOGI / KOD: fragment logu kolejki z błędem timeout i kod zadania wysyłającego maila
  • DOTYCHCZASOWE PRÓBY: restart workera kolejki, sprawdzenie danych SMTP

Czego się spodziewać: Model wskaże np. przyczyny w kolejności prawdopodobieństwa (worker kolejki zatrzymuje się po błędzie, limit połączeń SMTP, zadania ponawiane bez końca), zaproponuje najmniejszy test do ich rozróżnienia, zada maksymalnie 3 pytania i – po ustaleniu przyczyny – poprawkę oraz test regresji.

Jak dopasować prompt do siebie

  • Błąd w WordPressie: dodaj listę wtyczek i motyw – często przyczyną jest konflikt.
  • Błąd tylko na produkcji: dodaj różnice między środowiskami (wersje, konfiguracja, dane).
  • Błąd w aplikacji mobilnej: dodaj system, wersję aplikacji i urządzenie.

Wskazówki

  • Usuń z logów hasła, klucze i dane osobowe przed wklejeniem.
  • Testuj jedną hipotezę naraz i zapisuj wyniki.
  • Po naprawie dodaj test, który złapie ten błąd, gdyby wrócił.

Najczęstsze błędy

  • Wprowadzanie kilku zmian naraz – nie wiadomo, co pomogło.
  • Opis „nie działa” bez kroków odtworzenia i komunikatu błędu.

Co dalej – dopytaj model

Gdy dostaniesz odpowiedź, możesz pójść krok dalej tym poleceniem:

Ułóż komendy diagnostyczne do wykonania po kolei i wyjaśnij, jak interpretować każdy możliwy wynik.