Kurs vibe coding z Claude Code · Moduł 3: Klon Twittera
Oko drugiego oficera: czytanie diffu i /code-review
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.tsxgit 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-reviewBez 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":
- Na liście w Source Control są tylko pliki z zadania.
- Przeczytałeś diff każdego z nich.
- Każde znalezisko recenzji jest poprawione albo świadomie odrzucone, z powodem.
npm run build,npm run lintinpx tsc --noEmitprzechodzą, a wyniki widziałeś sam.- 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:
- 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.
- Pusta recenzja jako dowód. Raport bez znalezisk nie znaczy, że funkcja działa. Dowodem nadal są build, lint i spacer po aplikacji.
- 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. Co sprawdza /code-review wpisane bez argumentu?
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.