Kurs vibe coding z Claude Code · Moduł 15: Claude Code dla zaawansowanych
Sprawdzian bez nadzoru: /goal, hook Stop i /verify
W tej lekcji8
Rano w nocny-raport.json stoi w polu result: "Gotowe. Wszystkie trasy korzystają z lib/apiErrors.ts, testy przechodzą." Obok czeka gałąź worktree-api-bledy z kilkunastoma zmienionymi plikami, a Ty nie widziałeś ani jednej tury tej pracy. Z lekcji 10_4 wiesz, ile wart jest meldunek bez dowodu. Przy sesji, przy której siedzisz, łapiesz błąd po minucie. Po nocy masz tylko to, co przebieg sam zapisał. Dlatego sprawdzian wbudowujesz w przebieg, zanim wypłynie, a rano porównujesz meldunek z mapą zmian.
Co już umiesz
W lekcji 10_4 poznałeś stopnie rygoru: kryterium w poleceniu, /goal z osobnym modelem, który czyta tylko rozmowę, hook Stop z kodem 2 i /verify, a w lekcji 2_9 /code-review w świeżym subagencie. Z lekcji 14_1 znasz pola raportu claude -p, z lekcji 14_2 pięć pytań przed zostawieniem agenta, z lekcji 14_6 sesje w chmurze i Remote Control, a z lekcji 14_7 nocną wachtę: commit, worktree, sandbox i --max-turns. Tu nie powtarzam, czym są te narzędzia. Pokazuję, jak je ustawić na długi rejs, którego nie oglądasz.
Cel w przebiegu bez Ciebie
/goal działa także w trybie -p: wpisany na początku polecenia prowadzi pętlę do końca w jednym wywołaniu. Działa też w aplikacji desktopowej i przez Remote Control. Ustawienie celu od razu zaczyna pracę, a warunek jest zarazem poleceniem, więc musi mówić, co zrobić i po czym poznać koniec. Dokumentacja ostrzega, że przy zwykłym wyjściu tekstowym długi cel wygląda na zawieszony, dlatego nocny start z lekcji 14_7 zmienia format na strumień. Uruchomisz go dopiero po hooku z następnej sekcji.
Polecenie dla Claude Code (start wachty):
claude -p "/goal Wszystkie trasy w app/api zwracają błędy przez lib/apiErrors.ts i mają testy: grep -rn 'error:' app/api --include=route.ts nic nie wypisuje, a w wyniku find app/api -name 'route*.ts' każdy route.ts ma obok route.test.ts; npm run test -- --run kończy się bez porażek, a npx tsc --noEmit bez błędów; git diff --name-only --diff-filter=MD main -- '*.test.ts' nic nie wypisuje; albo przerwij po 25 turach" \
--worktree api-bledy --permission-mode auto --settings scripts/nocna-wachta.json \
--max-turns 60 --output-format stream-json --verbose > nocny-strumien.jsonlEwaluator niczego nie uruchamia, więc każdy człon warunku nazywa komendę, której wynik Claude musi pokazać w rozmowie. Pusty wynik grep dowodzi, że w trasach nie został żaden ręczny błąd, lista z find pokazuje parę plików przy każdej trasie, testy i tsc dają zaliczone albo nie, a ostatni git diff pilnuje zakazu zmiany testów. Warunek ma do 4000 znaków, więc zmieścisz w nim wszystko, co chcesz rano zobaczyć.
Ten ostatni człon wygląda tak, a nie inaczej, z powodu naszej próby. Postawiliśmy cel z warunkiem git diff --stat -- '*.test.ts' nic nie wypisuje. Claude zameldował, że warunek spełniony, i sam dopisał, że lib/plural.test.ts jest nieśledzony. git diff nie widzi plików nieśledzonych, więc zmieniony test spoza commita przeszedłby niezauważony. --diff-filter=MD main porównuje z gałęzią main i wypisuje tylko pliki zmienione (M) i usunięte (D), także te, które Claude już zacommitował. Nowe testy przechodzą, a stare są chronione, pod warunkiem że przed startem były w commicie.
Limit masz podwójny. Klauzulę "albo przerwij po 25 turach" ocenia ewaluator z rozmowy, więc jest miękka. --max-turns 60 to twardy hamulec programu, liczony w krokach agenta: u nas jeden obieg celu z czterema wywołaniami narzędzi dał num_turns równe 5, więc limit ustawiasz z zapasem. Pętla kończy się sama w trzech przypadkach: gdy ewaluator uzna warunek za spełniony, gdy uzna go za niemożliwy (wtedy zapisze powód) i gdy Claude kilka tur z rzędu odpowiada bez użycia narzędzi. Błąd, który musisz naprawić Ty, na przykład nieudane logowanie albo wyczerpane środki na koncie API, czyści cel i zostawia ostrzeżenie zaczynające się od Goal cleared after an unrecoverable error.
Hook Stop na długą wachtę
Z lekcji 10_4 wiesz, że po ośmiu blokadach z rzędu Claude Code i tak kończy turę. Szczegół ważny w nocy: licznik zeruje się za każdym razem, gdy Claude wywoła narzędzie. Limit blokad nie przerwie więc pętli, w której agent wciąż coś próbuje: chroni tylko przed pustym przepychaniem się. Hamulcem długiego rejsu zostaje --max-turns. Po przekroczeniu limitu Claude Code kończy turę z ostrzeżeniem, a hook może rozpoznać, że już raz odesłał Claude do pracy, po polu stop_hook_active w danych wejściowych.
Zakaz zmiany testów jest zasadą bez wyjątków, więc dostaje hook, ale tylko na noc: w dzień zmieniasz testy celowo i nie chcesz, żeby hook Cię odsyłał.
Polecenie dla Claude Code:
Napisz .claude/hooks/testy-nietkniete.sh: hook Stop, który kończy się kodem 2
i komunikatem na stderr, gdy git diff względem main pokazuje zmieniony albo
usunięty plik *.test.ts lub *.test.tsx. Nowe pliki testów przepuszczaj. Dopisz go
do scripts/nocna-wachta.json obok sandboxa, nie do .claude/settings.json.
Gotowe, gdy skrypt z JSON-em z polem cwd daje 2 dla zmienionego testu i 0 dla nowego.Polecenie podaje zdarzenie, kod wyjścia, miejsce wpisu i sprawdzian, a zakaz dopisywania do .claude/settings.json chroni Twoje dzienne sesje.
Co napisał Claude: hook
Otwórz w Cursorze .claude/hooks/testy-nietkniete.sh:
#!/bin/bash
# testy-nietkniete.sh: hook Stop, który odsyła Claude, gdy zmienił albo usunął test istniejący na main
cd "$(jq -r '.cwd')"
ZMIENIONE=$(git diff --name-only --diff-filter=MD main -- ':(top)*.test.ts' ':(top)*.test.tsx')
if [ -n "$ZMIENIONE" ]; then
echo "Testy z main zmienione albo usunięte: $ZMIENIONE. Przywróć je i popraw kod, nie test." >&2
exit 2
fi
exit 0Pierwsza linia przechodzi do katalogu sesji z pola cwd, które hook dostaje na wejściu, bo w worktree pokładem Claude jest katalog worktree. Dalej stoi ta sama komenda co w warunku celu, tylko teraz sprawdza ją program, a nie model. :(top) każe liczyć ścieżki od katalogu głównego repozytorium. Bez tego hook uruchomiony z podkatalogu u nas nie widział zmienionego testu w lib/ i przepuszczał wszystko. Komunikat idzie na stderr, więc Claude dostaje go jako powód, dla którego nie może skończyć.
W scripts/nocna-wachta.json obok klucza sandbox z lekcji 14_7, po przecinku, doszedł wpis w kształcie znanym z lekcji 14_5:
"hooks": {
"Stop": [
{
"hooks": [
{ "type": "command", "command": "bash", "args": ["${CLAUDE_PROJECT_DIR}/.claude/hooks/testy-nietkniete.sh"] }
]
}
]
}Skrypt, tak jak reguły z lekcji 14_7, musi być w commicie, zanim wypłyniesz. Sprawdź go jak w lekcji 14_5, podając JSON ręcznie: dopisz jedną linię do lib/pins.test.ts i uruchom jq -n --arg cwd "$PWD" '{cwd: $cwd}' | bash .claude/hooks/testy-nietkniete.sh; echo $?. U nas zmieniony test dał komunikat i 2, nowy plik testów 0, a zmiana zacommitowana na gałęzi też 2. Potem przywróć test.
Poranna odprawa: meldunek kontra diff
Zacznij od wyniku przebiegu. Strumień ma wiele linii, a podsumowanie jest w zdarzeniu typu result:
jq -c 'select(.type == "result") | {subtype, is_error, num_turns, odmowy: [.permission_denials[].tool_input]}' nocny-strumien.jsonlsubtype i is_error mówią, czy przebieg skończył się normalnie, czy na limicie, a odmowy pokazują, czego agentowi nie wolno było zrobić. Ten wynik niczego jeszcze nie dowodzi, bo to wciąż słowa samego przebiegu. Dowodem są wyniki komend z warunku: otwórz nocny-strumien.jsonl w Cursorze i wyszukaj Test Files. Ostatnie wystąpienie ma pokazywać zielone testy.
Potem mapa zmian. W terminalu Cursora git diff --stat main...worktree-api-bledy wypisze każdy plik zmieniony na gałęzi, a w Source Control otworzysz je po kolei. Czytasz w dwie strony: każde zdanie meldunku ma swój plik w diffie, a każdy plik w diffie ma swój powód w meldunku. Plik spoza app/api i lib/, na przykład package.json albo coś w .claude/, to pytanie, zanim cokolwiek scalisz.
Na koniec świeże oczy. Otwórz sesję w katalogu worktree (cd .claude/worktrees/api-bledy, potem claude) i wpisz /code-review: bez celu recenzuje commity gałęzi razem z niezacommitowanymi zmianami, w subagencie, który nie widział nocnej rozmowy. Poprawki zamawiasz w tej samej sesji. Dopiero gdy scalisz gałąź do main w głównym katalogu, gdzie masz .env i bazę z npx prisma dev, uruchom /verify: Claude zbuduje aplikację, uruchomi ją i obejrzy wynik. Worktree usuwasz potem komendą git worktree remove.
Pięć pytań jako lista odprawy
Pytania z lekcji 14_2 zadajesz dwa razy: wieczorem przed startem i rano przy odprawie.
| Pytanie | W tym przebiegu | Rano sprawdzasz |
|---|---|---|
| Czy wie, jak wygląda koniec? | warunek /goal | czy w strumieniu jest wynik każdej komendy z warunku |
| Czy może się sprawdzić? | testy, tsc, hook Stop | ostatnie Test Files w strumieniu |
| Czego wolno mu dotykać? | worktree, sandbox, reguły deny | odmowy i pliki spoza zadania w diffie |
| Co go zatrzyma? | --max-turns 60 i klauzula 25 tur | subtype i num_turns |
| Kto zatwierdza wynik? | Ty, po /code-review | scalasz sam, nigdy przebieg |
Przegląd kapitana
- Warunek widać w rozmowie. Każdy człon celu nazywa komendę. Człon w rodzaju "kod jest czytelny" ewaluator oceni na oko.
- Testy nietknięte.
git diff --name-only --diff-filter=MD main...worktree-api-bledy -- '*.test.ts'nic nie wypisuje. - Dowód, a nie zdanie. W
resultalbo w strumieniu stoi komenda i jej wynik, a nie samo "wszystkie testy przechodzą". - Odmowy przeczytane. Każda pozycja w
odmowyjest albo granicą, którą postawiłeś, albo powodem, dla którego część pracy nie powstała.
Typowy błąd agenta: gdy test nie chce przejść, Claude go osłabia albo usuwa, a w meldunku pisze o "uporządkowaniu testów". Rozpoznasz to po literze M albo D przy pliku .test.ts w diffie gałęzi. Hook złapie zmianę i usunięcie, ale nowy, słaby test, na przykład z samym toBeTruthy, przepuści. Ten zobaczysz tylko Ty i /code-review.
Następny krok
Odprawa ma te same kroki co rano, więc zamknij ją w skrypcie, jak recenzję w lekcji 14_1:
Zapisz poranną odprawę jako scripts/odprawa.sh: wynik przebiegu z nocny-strumien.jsonl
przez jq, git diff --stat main...worktree-api-bledy i lista zmienionych albo
usuniętych testów. Skrypt tylko czyta: niczego nie scala i niczego nie usuwa.Potem commit, na przykład "Nocna wachta: hook pilnujący testów i odprawa", i próbny rejs z --max-turns 5, zanim puścisz pełny. W edytorze obok wpiszesz warunek celu, a sprawdzarka wskaże człony, których ewaluator nie zobaczy w rozmowie.
Pamiętaj: dobry kapitan nie wierzy meldunkom, tylko wpisom w dzienniku pokładowym, a dziennik nocnej wachty to wynik komendy i diff gałęzi.
Kod do tej lekcji: App.tsx
// Sprawdzarka warunku /goal: które człony ewaluator zobaczy w rozmowie, a których nie
import { useState } from 'react';
export type Level = 'ok' | 'warn' | 'error';
export interface Finding {
level: Level;
text: string;
}
export const MAX_LENGTH = 4000;
export const COMMANDS = ['npm ', 'npx ', 'git ', 'grep ', 'find ', 'ls ', 'jq ', 'wc ', 'node '];
export const CHECKS = ['npm test', 'npm run test', 'tsc', 'vitest', 'npm run build', 'npm run lint'];
export const VAGUE = ['czyteln', 'ładn', 'spójn', 'sensown', 'porządn', 'dobrze', 'poprawn', 'zepsuł', 'działa'];
export const SAMPLES: Record<string, string> = {
'Meldunek na słowo honoru': '/goal kod tras jest czytelny i spójny; wszystkie testy przechodzą; nic się nie zepsuło',
'Warunek z lekcji 10_4': '/goal npm run test -- --run kończy się bez porażek, npm run lint i npx tsc --noEmit przechodzą, a git diff --stat nie pokazuje zmian w plikach .test.ts ani .test.tsx; albo zatrzymaj się po 15 turach',
'Nocna wachta': "/goal Wszystkie trasy w app/api zwracają błędy przez lib/apiErrors.ts i mają testy: grep -rn 'error:' app/api --include=route.ts nic nie wypisuje, a w wyniku find app/api -name 'route*.ts' każdy route.ts ma obok route.test.ts; npm run test -- --run kończy się bez porażek, a npx tsc --noEmit bez błędów; git diff --name-only --diff-filter=MD main -- '*.test.ts' nic nie wypisuje; albo przerwij po 25 turach",
};
export function stripGoal(text: string): string {
const t = text.trim();
return t.startsWith('/goal') ? t.slice('/goal'.length).trim() : t;
}
export function isTurnClause(clause: string): boolean {
return /po \d+ tur/.test(clause);
}
export function hasCommand(clause: string): boolean {
const c = clause + ' ';
return COMMANDS.some((k) => c.includes(k));
}
export function clauses(condition: string): string[] {
return condition.split(';').map((c) => c.trim()).filter((c) => c.length > 0);
}
export function check(text: string): Finding[] {
const condition = stripGoal(text);
if (condition === '') return [{ level: 'error', text: 'Pusty warunek: /goal bez warunku pokazuje tylko stan celu.' }];
const out: Finding[] = [];
if (condition.length > MAX_LENGTH) {
out.push({ level: 'error', text: 'Warunek ma ' + condition.length + ' znaków, a /goal przyjmuje najwyżej ' + MAX_LENGTH + '.' });
}
for (const c of clauses(condition)) {
if (isTurnClause(c)) continue;
const short = c.length > 60 ? c.slice(0, 60) + '...' : c;
if (hasCommand(c)) {
out.push({ level: 'ok', text: '"' + short + '": nazywa komendę, której wynik Claude pokaże w rozmowie.' });
} else if (VAGUE.some((v) => c.toLowerCase().includes(v))) {
out.push({ level: 'error', text: '"' + short + '": ocena na oko. Ewaluator nie uruchamia komend i nie czyta plików, więc nie ma czego sprawdzić.' });
} else {
out.push({ level: 'warn', text: '"' + short + '": bez komendy. Dopisz, czym Claude ma to udowodnić.' });
}
}
const lower = condition.toLowerCase();
if (!CHECKS.some((k) => lower.includes(k))) {
out.push({ level: 'warn', text: 'Brak sprawdzianu, który zalicza albo nie: testów, tsc, lintu albo builda.' });
}
if (!lower.includes('.test.')) {
out.push({ level: 'warn', text: 'Nic nie pilnuje testów. Dopisz git diff --name-only --diff-filter=MD main -- *.test.ts albo hook Stop.' });
} else if (lower.includes('git diff') && !lower.includes('--diff-filter=md main')) {
out.push({ level: 'warn', text: 'Ten git diff nie widzi plików nieśledzonych ani zmian już zacommitowanych przez Claude. Porównaj z main: git diff --name-only --diff-filter=MD main.' });
}
if (!clauses(condition).some(isTurnClause)) {
out.push({ level: 'warn', text: 'Brak klauzuli w rodzaju "albo przerwij po 25 turach". Twardy limit i tak daje dopiero --max-turns.' });
}
return out.filter((f, i) => out.findIndex((g) => g.text === f.text) === i);
}
const LEVEL_CLASS: Record<Level, string> = {
ok: 'text-emerald-400',
warn: 'text-amber-400',
error: 'text-rose-400',
};
export default function App() {
const [text, setText] = useState(SAMPLES['Meldunek na słowo honoru']);
const findings = check(text);
const problems = findings.filter((f) => f.level !== 'ok').length;
return (
<div className="min-h-screen space-y-4 bg-slate-950 p-4 text-slate-100">
<h1 className="text-xl font-bold">Czy ewaluator to zobaczy?</h1>
<div className="flex flex-wrap gap-2 text-sm">
{Object.keys(SAMPLES).map((name) => (
<button key={name} type="button" className="rounded bg-slate-800 px-2 py-1 hover:bg-slate-700" onClick={() => setText(SAMPLES[name])}>
{name}
</button>
))}
</div>
<label className="block text-sm">
Warunek celu
<textarea className="mt-1 h-32 w-full rounded bg-slate-900 p-2 font-mono text-xs" value={text} onChange={(e) => setText(e.target.value)} />
</label>
<p className="text-xs text-slate-400">{stripGoal(text).length} / {MAX_LENGTH} znaków</p>
<p role="status" className="text-sm font-semibold">
{problems === 0 ? 'Każdy człon da się potwierdzić wynikiem komendy.' : 'Do poprawy: ' + problems}
</p>
<ul className="space-y-1 text-sm">
{findings.map((f) => (
<li key={f.text} className={LEVEL_CLASS[f.level]}>{f.level}: {f.text}</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. Który warunek /goal ewaluator potwierdzi w nocnym przebiegu bez zgadywania?
2. Dlaczego warunek "git diff --stat -- '*.test.ts' nic nie wypisuje" może przepuścić zmieniony test?
To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w pionie
Uporządkuj kroki porannej odprawy po nocnym przebiegu w worktree:
- Układanie w poziomie
Ułóż komendę, która podaje hookowi JSON z katalogiem sesji i wypisuje jego kod wyjścia: