Wyjaśnij mi kod (AI jako osobisty tutor programowania)

1. Przegląd koncepcji i zastosowanie

Gdy początkujący zaczyna naukę programowania lub przypadkiem natrafi na plik skryptu na GitHubie, widzi ścianę niezrozumiałych symboli: async, await, map(), lambda x: x*2, klamry i strzałki. Standardowe podręczniki często napisane są jeszcze bardziej złożonym, akademickim językiem, który zniechęca do dalszej nauki.

Sztuczna inteligencja to najcierpliwszy na świecie nauczyciel programowania. Nie wstydź się zadać najbardziej banalnego pytania, AI nigdy nie irytuje się, gdy pytasz po raz dziesiąty, i potrafi wyjaśnić nawet algorytmy kwantowe za pomocą przepisów na naleśniki czy zasad gry w piłkę nożną.

W praktyce inżynierskiej jest to najszybszy sposób na zrozumienie cudzego kodu w 5 minut bez lęku przed technicznym żargonem.

2. Trzy poziomy wyjaśnienia tego samego kodu

Zobacz, jak za pomocą różnych promptów można wyjaśnić prostą funkcję:

const adults = users.filter(user => user.age >= 18);

┌─────────────────────────────────────────────────────────────┐
│                 POZIOMY WYJAŚNIEŃ DLA POCZĄTKUJĄCEGO        │
├─────────────────────────────────────────────────────────────┤
│ 👶 Poziom 1: Analogia z życia (dla 10-latka):               │
│    «Wyobraź sobie, że ochroniarz stoi przy wejściu do klubu.│
│     Sprawdza dowód osobisty każdego gościa. Jeśli gościowi  │
│     jest 18 lat, wpuszcza go do środka tańczyć».            │
├─────────────────────────────────────────────────────────────┤
│ 📝 Poziom 2: Analiza składni linia po linii:                │
│    • `const adults`: tworzymy nową pustą listę.             │
│    • `users.filter()`: bierzemy listę wszystkich osób i      │
│      włączamy sito (filtr).                                 │
│    • `user.age >= 18`: reguła selekcji (wiek od 18 lat).    │
├─────────────────────────────────────────────────────────────┤
│ 💡 Poziom 3: Dlaczego napisano to właśnie tak (Architektura):│
│    «Tutaj zastosowano metodę deklaratywną zamiast pętli for. │
│     Dzięki temu kod jest krótszy i chroni przed mutacją     │
│     oryginału».                                             │
└─────────────────────────────────────────────────────────────┘

3. Top-3 najbardziej przydatne prompty do analizy kodu

01. Analiza skomplikowanego cudzego skryptu

Gdy kolega przesyła Ci plik bez komentarzy:

„Wyjaśnij mi ten kod. Podziel wyjaśnienie na 3 bloki: 1. Co ten skrypt robi ogólnie (główny cel). 2. Jakie dane przyjmuje na wejściu i co zwraca na wyjściu. 3. Stwórz tabelę: każdy wiersz kodu ➔ wyjaśnienie ludzkim językiem”.

02. Wykrywanie ukrytych przypadków brzegowych (Edge Cases)

Sprawdź, gdzie Twój kod może się zawiesić:

„Przeanalizuj tę funkcję. Co się stanie, jeśli użytkownik wprowadzi pusty ciąg znaków, liczbę ujemną lub kliknie przycisk dwukrotnie? Jak zabezpieczyć aplikację przed awarią?”

03. Tłumaczenie kodu z jednego języka na inny dla lepszego zrozumienia

Jeśli znasz nieco Pythona, ale musisz zrozumieć TypeScript:

„Oto kod w TypeScript. Przepisz go na prosty Python i przedstaw równolegle: która konstrukcja w Pythonie odpowiada każdemu wierszowi w TypeScript.”