Kurs vibe coding z Claude Code · Moduł 3: Klon Twittera

Oko drugiego oficera: czytanie diffu i /code-review

7 min czytania ·
W tej lekcji11

Szczur z lekcji 2_8 przeszedł przez build, przez lint i przez Twój przegląd bo zmiana miała kilka znaków i stała w diffie obok znaczka, o który prosiłeś. Ty czytałeś ten kod przez pryzmat rozmowy, w której prosiłeś o znaczek, i Claude też. Dokumentacja Claude Code ma na to radę: niech kod obejrzy ktoś, kto go nie pisał. Komenda /code-review uruchamia recenzenta w świeżym subagencie, który nie widział Waszej rozmowy, więc nie ulega rozumowaniu, z którego kod powstał. Dziś przeprowadzisz przez taki przegląd nową funkcję formularza, zanim trafi do commita.

Funkcja na osobnej gałęzi

Kapitan pisze dużo, więc chce wysyłać wpis z klawiatury, bez sięgania po mysz. Zaczynasz od czystej listy w Source Control i nowej gałęzi z lekcji 1_5: poproś Claude o gałąź feature/ctrl-enter, a w prośbie o zgodę zobaczysz git switch -c feature/ctrl-enter. Na main zostaje wersja, która działa, a gałąź przyda się też recenzentowi, o czym za chwilę.

Polecenie dla Claude Code:

W @components/Feed.tsx: Ctrl+Enter (na Macu także Cmd+Enter) w polu
wpisu wysyła wpis tak samo jak przycisk Wyślij. Zwykły Enter dalej
łamie linię. Nic poza tym nie zmieniaj. Na koniec npm run build
i npm run lint.

Polecenie nazywa plik, zachowanie i granicę. Zdanie o zwykłym Enterze chroni to, co gracze już znają, a "nic poza tym" będzie miarą przy czytaniu diffu.

Co napisał Claude

W components/Feed.tsx pole <textarea> dostało obsługę klawiatury:

onKeyDown={(e) => {
  if (e.key === "Enter" && (e.ctrlKey || e.metaKey)) {
    e.preventDefault();
    e.currentTarget.form?.requestSubmit();
  }
}}

onKeyDown reaguje na wciśnięcie klawisza. e.ctrlKey i e.metaKey mówią, czy razem z Enterem trzymasz Ctrl albo Cmd, a preventDefault() blokuje nową linię w polu. requestSubmit() wysyła formularz tak, jakby ktoś kliknął przycisk wysyłania, więc uruchamia ten sam handleSubmit. Znak ?. jest tu uczciwy, bo pole tekstowe nie musi leżeć w formularzu i wtedy form jest puste.

Czytanie diffu w Cursorze

Otwórz Source Control. Diff czytasz od góry: najpierw lista plików, potem każdy plik osobno. Lista mówi o zakresie, zanim przeczytasz choć jedną linię: prosiłeś o zmianę w jednym pliku, a na liście stoją dwa, Feed.tsx i LikeButton.tsx. Kliknij drugi:

-      className="mt-3 text-sm text-gray-500 hover:text-red-600"
+      className="mt-3 text-sm font-semibold text-gray-500 hover:text-red-600"

Claude "przy okazji" pogrubił przycisk polubień, pewnie żeby pasował do przycisku Wyślij. Zmiana wygląda niewinnie, ale nie wynika z zadania: miesza dwie sprawy w jednym commicie i zmienia wygląd, o który nikt nie prosił. W każdym pliku z listy szukasz trzech rzeczy: linii, których zadanie nie wymaga, usuniętych linii, których się nie spodziewałeś, i sztuczek z lekcji 2_8, takich jak eslint-disable. Te same zmiany pokaże też komenda /diff w sesji.

Odrzuć zmianę spoza zakresu

/rewind cofnąłby całe polecenie, także obsługę Ctrl+Enter. Tu potrzebujesz liny na jeden plik, znanej z lekcji 1_5:

! git restore components/LikeButton.tsx

git restore odrzuca zmiany w pliku, których nie dodałeś jeszcze do commita, a wykrzyknik uruchamia komendę prosto z sesji. Na liście w Source Control zostaje sam Feed.tsx. Możesz też napisać Claude "Cofnij zmianę w LikeButton.tsx, nie była w zadaniu" i zobaczyć tę samą komendę w prośbie o zgodę. Zapamiętaj: Claude lubi poprawiać okolice, a im węższe polecenie, tym łatwiej to wyłapać.

/code-review: świeże oczy

Teraz recenzja. Wpisz w sesji:

/code-review

Bez argumentu /code-review sprawdza commity Twojej gałęzi, których nie ma jeszcze w jej odpowiedniku na GitHubie, oraz zmiany niezapisane w commicie. Gałąź feature/ctrl-enter nie ma jeszcze odpowiednika, więc Claude porównuje ją z main: recenzja obejmie tylko Twoją niezapisaną zmianę. Na main z kilkoma niewysłanymi commitami objęłaby je wszystkie. W terminalu recenzja biegnie w tle, w subagencie z własnym kontekstem, a wyniki przychodzą do rozmowy, gdy będą gotowe. Recenzent szuka błędów w działaniu, czyta Twój CLAUDE.md i bez flagi --fix niczego nie zmienia, tylko składa raport. Recenzję Claude może też uruchomić sam, gdy zwyczajnie poprosisz: "zrób przegląd moich zmian".

Co znalazł recenzent

Twój raport będzie miał inne słowa, ale podobny kształt:

components/Feed.tsx: Ctrl+Enter omija limit 280 znaków.
requestSubmit() wysyła formularz także wtedy, gdy przycisk Wyślij
jest wyłączony, a handleSubmit sprawdza tylko pusty wpis. Wpis
dłuższy niż 280 znaków trafi na oś.

Znalezisko to hipoteza, jak w lekcji 2_8, więc sprawdzasz je, zanim uwierzysz. Wklej do pola ponad 280 znaków: licznik świeci na czerwono, a przycisk jest wyłączony. Naciśnij Ctrl+Enter, a za długi wpis i tak wyląduje na osi. Przycisk był tylko zamkiem na drzwiach, a skrót klawiszowy wszedł oknem. Znalezisko potwierdzone.

Poprawka znaleziska

Poprawkę zamawiasz w rozmowie, jednym wąskim poleceniem:

Popraw znalezisko z recenzji: handleSubmit w @components/Feed.tsx
ma odrzucać wpis pusty i dłuższy niż MAX_LENGTH, tak jak przycisk.
Nic więcej. Potem npm run lint i npx tsc --noEmit.

Diff ma jedną zmienioną linię na początku handleSubmit:

if (!draft.trim() || draft.length > MAX_LENGTH) return;

Zasada "pusty albo za długi wpis nie przechodzi" mieszka teraz tam, gdzie formularz naprawdę się wysyła, a wyłączony przycisk zostaje podpowiedzią dla oka. Powtórz próbę z 300 znakami: Ctrl+Enter nic nie dodaje, a krótki wpis wysyła się z klawiatury jak trzeba.

Dlaczego nie /code-review --fix? Z tą flagą recenzent sam wprowadza poprawki, a gdy działa w tle, jego edycje omijają checkpointy sesji: /rewind cofnie tylko pliki, które Claude zmieniał wcześniej w rozmowie, a resztę cofniesz już tylko Gitem. Na początek polecam drogę z raportem: czytasz znaleziska, sprawdzasz je i zamawiasz poprawki po jednej.

/simplify to nie /code-review

Obok recenzji jest druga komenda o podobnym brzmieniu. /simplify przegląda zmieniony kod pod kątem porządków: powtórzeń, rzeczy do uproszczenia, wydajności i poziomu abstrakcji, i od razu wprowadza poprawki. Błędów w działaniu nie szuka; dokumentacja odsyła po nie do /code-review. W starszych poradnikach obie nazwy się mieszają, bo dawniej /simplify nazywała się dzisiejsza recenzja. Przed commitem funkcji potrzebujesz łowcy błędów, czyli /code-review.

Kiedy commitować

Commit robisz, gdy na każde z tych pytań odpowiesz "tak":

  1. Na liście w Source Control są tylko pliki z zadania.
  2. Przeczytałeś diff każdego z nich.
  3. Każde znalezisko recenzji jest poprawione albo świadomie odrzucone, z powodem.
  4. npm run build, npm run lint i npx tsc --noEmit przechodzą, a wyniki widziałeś sam.
  5. Funkcja działa w przeglądarce, także w przypadku, który wskazał recenzent.

Potem jedno polecenie, znane z lekcji 1_8: commit z opisem w rodzaju "Ctrl+Enter wysyła wpis, limit 280 także w handleSubmit", wlanie feature/ctrl-enter do main i git push, z komendami pokazanymi przed uruchomieniem.

Przegląd kapitana

Typowe błędy przy recenzji wyłapiesz po trzech objawach:

  1. Poprawki bez pytań. Claude rzuca się poprawiać każde znalezisko. Recenzent też bywa w błędzie, więc przy wątpliwym znalezisku poproś o kroki, które pokazują problem.
  2. Pusta recenzja jako dowód. Raport bez znalezisk nie znaczy, że funkcja działa. Dowodem nadal są build, lint i spacer po aplikacji.
  3. Commit z balastem. Plik spoza zakresu został na liście, bo nikt nie przeczytał listy plików przed commitem.

Następny krok

Komunikator jest gotowy na pierwszy przegląd mentora: trasy, komponenty, stan, zapis w localStorage, CLAUDE.md z konwencjami i historia małych commitów. Wyślij link do repozytorium w zadaniu na końcu lokacji. W kolejnej lokacji zbudujesz klon Instagrama i każdą jego funkcję przeprowadzisz przez tę samą pętlę, z recenzją przed commitem. W edytorze poniżej czeka formularz z tej lekcji z przełącznikiem poprawki: wklej długi wpis i porównaj, co robi Ctrl+Enter przed recenzją i po niej.

Pamiętaj: drugi oficer, który nie słyszał narady, zobaczy rafę, której kapitan już nie widzi.

Kod do tej lekcji: App.jsx
// Ctrl+Enter (na Macu Cmd+Enter) wysyła wpis.
// Wklej ponad 280 znaków: przycisk Wyślij się wyłączy.
// Bez poprawki z recenzji Ctrl+Enter i tak wyśle za długi wpis.
import { useState } from 'react';

const MAX_LENGTH = 280;

export default function App() {
  const [posts, setPosts] = useState([]);
  const [draft, setDraft] = useState('');
  const [reviewFix, setReviewFix] = useState(false);

  const handleSubmit = (e) => {
    e.preventDefault();
    if (!draft.trim()) return;
    // Poprawka znaleziska z /code-review: limit sprawdzany także tutaj
    if (reviewFix && draft.length > MAX_LENGTH) return;

    setPosts([{ id: String(Date.now()), content: draft.trim() }, ...posts]);
    setDraft('');
  };

  const tooLong = draft.length > MAX_LENGTH;

  return (
    <div className="min-h-screen bg-gray-50 p-6 text-gray-900">
      <h1 className="text-3xl font-bold">Formularz wpisu</h1>

      <label className="mt-4 flex items-center gap-2 text-sm">
        <input type="checkbox" checked={reviewFix} onChange={(e) => setReviewFix(e.target.checked)} />
        Poprawka z recenzji: limit także w handleSubmit
      </label>

      <form onSubmit={handleSubmit} className="mt-4 rounded-lg border border-gray-300 bg-white p-4">
        <textarea
          value={draft}
          onChange={(e) => setDraft(e.target.value)}
          onKeyDown={(e) => {
            if (e.key === 'Enter' && (e.ctrlKey || e.metaKey)) {
              e.preventDefault();
              e.currentTarget.form?.requestSubmit();
            }
          }}
          rows={4}
          placeholder="Napisz wpis i naciśnij Ctrl+Enter"
          className="w-full rounded border border-gray-300 p-2"
        />
        <div className="mt-2 flex items-center justify-between">
          <span className={tooLong ? 'text-sm text-red-600' : 'text-sm text-gray-500'}>
            {draft.length}/{MAX_LENGTH}
          </span>
          <button
            type="submit"
            disabled={!draft.trim() || tooLong}
            className="rounded bg-blue-600 px-4 py-2 font-semibold text-white disabled:opacity-50"
          >
            Wyślij
          </button>
        </div>
      </form>

      <ul className="mt-4 space-y-2">
        {posts.map((post) => (
          <li key={post.id} className="rounded border border-gray-300 bg-white p-3">
            <span className={post.content.length > MAX_LENGTH ? 'font-bold text-red-600' : 'text-gray-500'}>
              {post.content.length} znaków:
            </span>{' '}
            {post.content.slice(0, 60)}
          </li>
        ))}
      </ul>
    </div>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Co sprawdza /code-review wpisane bez argumentu?

  2. 2. Prosiłeś o Ctrl+Enter w Feed.tsx, a w Source Control widzisz też zmienioną klasę w LikeButton.tsx. Co robisz przed commitem?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

  1. PytanieCo recenzuje /code-review bez argumentu
  2. PytanieZmiana poza zakresem w diffie
  3. Pytanie/code-review czy /simplify
  4. Projekt do wysłaniaWyślij Kraken's Call do mentora
  5. WideoPodsumowanie modułu

Przydatne artykuły