Biblioteka promptów

Zrozumienie cudzego kodu przed zmianą

Mapa nieznanego kodu: co robi, skąd bierze dane, co od niego zależy i gdzie bezpiecznie wprowadzić zmianę.

Prompt – 3 zmienne do uzupełnienia

Pomóż mi zrozumieć kod, który muszę zmienić, a którego nie pisałem.
Co chcę zmienić lub dodać: [PLANOWANA ZMIANA].
Mój poziom w tym języku / frameworku: [MÓJ POZIOM].

Kod (pliki oddzielone nazwą pliku):
[WKLEJ KOD]

Wyjaśnij:
1. co ten kod robi – w 5 zdaniach, bez szczegółów,
2. przepływ danych: skąd przychodzą, jak są przetwarzane, dokąd trafiają,
3. najważniejsze funkcje/klasy i ich rola (tabela),
4. miejsca ryzykowne: efekty uboczne, zmienne globalne, zależności od innych części systemu,
5. gdzie najlepiej wprowadzić moją zmianę i co może przestać działać,
6. czego nie da się ustalić z wklejonego fragmentu (np. brakujące pliki).
Nie przepisuj kodu – najpierw chcę go zrozumieć.

Kiedy użyć tego promptu

Gdy przejmujesz projekt po kimś, poprawiasz starą wtyczkę albo dostajesz zadanie w kodzie, którego nikt nie dokumentował. Zamiast godziny przeskakiwania między plikami dostajesz mapę: co z czym się łączy i gdzie jest najmniejsze ryzyko, że zmiana coś zepsuje.

Przykład

Przykładowe dane do uzupełnienia:

  • PLANOWANA ZMIANA: dodanie numeru NIP do faktury generowanej po zamówieniu
  • MÓJ POZIOM: znam PHP średnio, WordPressa dobrze, tej wtyczki wcale

Czego się spodziewać: Model opisze, że faktura powstaje w hooku po zmianie statusu zamówienia, dane klienta pobiera jedna metoda klasy, a szablon PDF jest w osobnym pliku – i wskaże, że najbezpieczniej dodać pole w metodzie pobierającej dane i w szablonie, bez ruszania logiki numeracji faktur.

Jak dopasować prompt do siebie

  • Bardzo duży projekt: zacznij od wklejenia struktury katalogów i plików konfiguracyjnych, poproś o wskazanie, które pliki przeczytać.
  • Kod w nieznanym języku: poproś o wyjaśnienie składni przy pierwszym wystąpieniu każdej konstrukcji.
  • Przekazanie wiedzy zespołowi: poproś o wersję w formie krótkiej dokumentacji do zapisania w repozytorium.

Wskazówki

  • Usuń z kodu klucze, hasła i dane klientów przed wklejeniem – i sprawdź, czy umowa z klientem pozwala na użycie narzędzi AI.
  • Wklejaj także pliki, które wywołują analizowany kod – inaczej model zgaduje kontekst.
  • Zweryfikuj wnioski: uruchom kod z logowaniem albo debuggerem w miejscach, które model wskazał jako kluczowe.

Najczęstsze błędy

  • Wprowadzanie zmiany w pierwszym pasującym miejscu bez sprawdzenia, co jeszcze z niego korzysta.
  • Prośba o „przepisanie na lepsze” kodu, którego jeszcze nie rozumiesz.

Co dalej – dopytaj model

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

Na podstawie tej analizy napisz plan wprowadzenia mojej zmiany w krokach, z testami, które trzeba wykonać po każdym kroku.