Kurs vibe coding z Claude Code · Moduł 10: Klon TikToka
Twój własny subagent recenzent: video-reviewer
W tej lekcji13
Przejrzyj w pamięci trzy ostatnie przeglądy kapitana. W feedzie szukałeś pause, w nagrywarce getTracks i clearInterval, w edytorze revokeObjectURL. Za każdym razem ta sama lista: czy kamera gaśnie, czy odtwarzacz staje, czy adres nagrania jest zwalniany, czy odmowa dostępu daje komunikat. Takie błędy nie psują wyglądu, więc lint i build ich nie widzą, a Treasure Reels będzie dostawać kolejne komponenty wideo. Zamiast za każdym razem wklejać tę listę do rozmowy, zatrudnisz bosmana, który co wieczór obchodzi olinowanie z tą samą listą w ręku: własnego subagenta.
Czego się nauczysz
- rozpoznać, kiedy własny subagent się opłaca, a kiedy wystarczy zwykłe polecenie;
- zlecić Claude Code plik
.claude/agents/video-reviewer.mdi przeczytać w Cursorze jego frontmatter i instrukcję; - wywołać recenzenta po nazwie i sprawdzić każdy punkt jego raportu samodzielnie;
- odróżnić subagenta od skilla z lekcji 6_1 i od
/code-review.
Subagent w jednym akapicie
Wbudowanego subagenta Explore znasz z lekcji 5_4. Dokumentacja Claude Code opisuje każdego subagenta tak samo: pracuje we własnym oknie kontekstu, z własną instrukcją, z wybranymi narzędziami i z osobnymi uprawnieniami. Startuje z czystym kontekstem, więc nie widzi Waszej rozmowy ani plików, które Claude już przeczytał, a do głównej rozmowy wraca tylko jego podsumowanie. Własnego subagenta dokumentacja radzi napisać wtedy, gdy raz po raz wysyłasz tego samego pomocnika z tymi samymi instrukcjami. To dokładnie nasza lista z trzech przeglądów.
Kiedy się opłaca
Własny subagent ma sens, gdy spełnione są trzy warunki naraz:
- Powtarzalność. Ta sama kontrola wraca przy każdej zmianie w komponentach wideo.
- Wąski zakres. Pięć konkretnych pytań, a nie "znajdź wszystkie błędy".
- Własny kontekst. Recenzent czyta kilka długich plików, a do rozmowy wraca krótki raport.
Jednorazowe pytanie zadajesz zwykłym poleceniem. Procedurę, którą chcesz uruchamiać jako komendę w swojej rozmowie, zapisujesz jako skill. Subagent to osobny członek załogi z własną kajutą i własną listą.
Polecenie dla Claude Code
Plik agenta możesz napisać ręcznie, ale prościej go zlecić. W starszych poradnikach zobaczysz kreator pod komendą /agents. Według dokumentacji w obecnej wersji ta komenda tylko przypomina, żeby poprosić Claude o agenta albo edytować pliki w .claude/agents/, więc prosisz:
Utwórz subagenta projektu .claude/agents/video-reviewer.md.
Ma tylko czytać kod: narzędzia Read, Grep i Glob, model sonnet.
Sprawdza pliki z video, audio, getUserMedia, MediaRecorder
i createObjectURL: czy kamera, nagrywanie, interwały i adresy
obiektów są zwalniane przy odmontowaniu, czy play() ma obsługę
odrzucenia i czy odmowa dostępu daje komunikat. Raport po polsku,
każde znalezisko jako plik:linia, co jest nie tak, czym grozi,
jak to sprawdzić. Niczego nie poprawiaj, pokaż mi tylko plik.Co napisał Claude: frontmatter
Otwórz w Cursorze .claude/agents/video-reviewer.md. Na górze stoi frontmatter, czyli ustawienia między liniami ---, w tym samym zapisie co w skillu z lekcji 6_1:
---
name: video-reviewer
description: Recenzent komponentów wideo, kamery i dźwięku w Treasure Reels. Sprawdza, czy kamera, odtwarzacz, nagrywanie i adresy obiektów są zwalniane przy odmontowaniu oraz czy odmowa dostępu daje komunikat. Używaj po każdej zmianie w plikach z video, audio, getUserMedia, MediaRecorder albo createObjectURL.
tools: Read, Grep, Glob
model: sonnet
---Według dokumentacji wymagane są tylko dwa pola. name to nazwa, po której wołasz agenta. description czyta Claude, gdy decyduje, komu oddać zadanie, dlatego opis mówi, co agent sprawdza i kiedy go używać. Dokumentacja radzi dopisać zwrot w rodzaju "use proactively", czyli "używaj proaktywnie", jeśli chcesz, żeby Claude sięgał po agenta sam.
tools to przepustka: subagent dostaje tylko wymienione narzędzia. Read czyta plik, Grep szuka tekstu w plikach, Glob szuka plików po nazwie. Bez pola tools agent dziedziczy wszystkie narzędzia dostępne subagentom, także edycję plików i Bash. model jest opcjonalny: bez niego agent pracuje na tym samym modelu co rozmowa, a sonnet to alias modelu Sonnet. U nas zapis przebiegu pokazał dwa modele: główną sesję na modelu z ustawień konta i recenzenta na Sonnecie.
Co napisał Claude: instrukcja
Pod frontmatterem stoi treść. Dokumentacja mówi wprost, że to cała instrukcja systemowa subagenta: dostaje ją razem z podstawowymi danymi o środowisku, ale bez instrukcji systemowej Claude Code. Dlatego lista musi być konkretna:
1. Kamera i mikrofon: każdy strumień z getUserMedia ma stop() na każdej ścieżce
(getTracks) w sprzątaniu efektu, przy podmianie strumienia i przy odmontowaniu,
także gdy komponent zniknie, zanim użytkownik da zgodę.
2. Nagrywanie: MediaRecorder zatrzymywany przy odmontowaniu tylko gdy state nie
jest "inactive"; każdy setInterval i setTimeout ma clearInterval lub clearTimeout.To dwa z pięciu punktów: pozostałe pytają o play() i pause(), o revokeObjectURL oraz o komunikat przy NotAllowedError i NotFoundError. Każdy punkt to błąd, który znalazłeś w lekcjach 9_1 do 9_3, a nie ogólnik w rodzaju "sprawdź jakość". Ostatni akapit instrukcji ustala format raportu i każe zakończyć go zdaniem, których znalezisk agent nie jest pewien.
Wywołanie po nazwie
Dokumentacja podaje dwie drogi. Możesz napisać zwykłe zdanie z nazwą agenta albo wpisać @ i wybrać agenta z podpowiedzi. Claude może też sięgnąć po niego sam, gdy zadanie pasuje do opisu. Jeśli folder .claude/agents/ powstał w trakcie sesji, dokumentacja każe ją uruchomić ponownie: /exit, potem claude -c.
Jedno ograniczenie wynika z przepustki. Recenzent bez Basha nie uruchomi git diff ani testów, więc wskazujesz mu pliki. Tak wyglądało nasze wywołanie po dodaniu przycisku "Obróć kamerę":
Użyj subagenta video-reviewer i przejrzyj @components/VideoRecorder.tsx
po zmianie z ostatniego commita (przełącznik kamery). Gdy skończy,
przepisz mi jego raport, a pod nim napisz, których punktów nie da się
potwierdzić samym czytaniem kodu.Na tej gałęzi celowo usunęliśmy efekt, który gasił kamerę, bo dokładnie tak agent potrafi zgubić sprzątanie przy okazji innej zmiany. Lint i npx tsc --noEmit przeszły, a test z lekcji 9_2 padł z nazwą wyłącza kamerę po wyjściu ze strony. Test mówi jednak tylko tyle, że kamera świeci po wyjściu.
Co przyniósł recenzent
Puściliśmy to polecenie w trybie bez okna, claude -p, który poznasz w lokacji 13. Przebieg trwał około dwóch i pół minuty, a zapis potwierdził jedno wywołanie video-reviewer. Raport zaczynał się tak (skrócone):
1. VideoRecorder.tsx:102-110 (`switchCamera`) - poprzedni strumień nigdy nie
dostaje `stop()`. `setStream(media)` tylko podmienia stan, więc stara kamera
i mikrofon działają dalej.
2. VideoRecorder.tsx:137-141 (`disableCamera`) - `setStream(null)` nie zatrzymuje
ścieżek, nie ma też `getTracks().forEach(stop)`.
3. VideoRecorder.tsx:88-100 (sprzątanie przy odmontowaniu) - strumień z `stream`
nie jest zatrzymywany przy odmontowaniu.Raport miał 11 punktów, a kończył się zdaniem: "Nie uruchamiałem kodu ani testów." Recenzent nie przyniósł wyroku, tylko listę hipotez z adresami.
Jak czytać raport
Każdy punkt sprawdzasz tak samo jak raport /security-review w lekcji 8_7: otwierasz plik w Cursorze, idziesz do wskazanej linii i szukasz dowodu.
- Wspólna przyczyna. U nas punkty 1, 2 i 3 miały jedną przyczynę: brak efektu, który woła
stop()na ścieżkach przy każdej zmianie strumienia. Jedna poprawka zamyka trzy punkty. - Prawdziwy, ale osobny. Punkt o braku
try/catchwswitchCamerabył trafny: odmowa przy obracaniu kamery nie dawała komunikatu. - Uwagi, nie błędy. Ostatnie trzy punkty to drobiazgi i opisy tego, co działa. Długi raport męczy, więc w kolejnym wywołaniu dopisz "najwyżej 5 znalezisk, tylko błędy" albo popraw instrukcję w pliku agenta.
- Szczegóły do sprawdzenia. Główna sesja w swoim komentarzu napisała "React 18", choć projekt ma React 19. Wersję sprawdzasz w
package.json, nie w raporcie.
Poprawka i drugi przebieg
Poprawka idzie jednym wąskim poleceniem, jak w lekcji 8_7: "W @components/VideoRecorder.tsx przywróć efekt, który zatrzymuje ścieżki przy zmianie strumienia, a w switchCamera dodaj try/catch z cameraErrorMessage i sprawdzenie mountedRef. Nic poza tym. Potem lint, typy i testy." U nas przeszły wszystkie 32 testy. Drugi przebieg puściliśmy przez claude --agent video-reviewer, czyli całą sesję jako ten agent, z dopiskiem "najwyżej 5 znalezisk, tylko błędy". Trwał 34 sekundy, wycieku kamery już nie zgłosił, za to podał trzy nowe, mniejsze punkty, a jeden sam oznaczył jako niepewny. Każdy z nich ocenisz jak poprzednie: poprawka, notatka TODO albo odrzucenie z uzasadnieniem.
Subagent, skill czy /code-review
Trzy narzędzia wyglądają podobnie, ale robią co innego:
/code-reviewz lekcji 2_9 to ogólna recenzja błędów w działaniu w świeżym subagencie. Bez--fixtylko raportuje, ale nie dostaje Twojej listy spraw wideo.- Skill z lekcji 6_1 to przepis, który Claude wczytuje do Twojej rozmowy, gdy wpiszesz komendę albo gdy pasuje do zadania. Działa w Twojej rozmowie i w jej kontekście.
video-reviewerto stały członek załogi: własny kontekst, Twoja wąska lista i przepustka tylko do czytania.
Moja rada: zaczynaj od /code-review. Gdy po raz trzeci wklejasz tę samą listę kontrolną, zapisz ją jako subagenta.
Wspólny plik dla załogi
Plik .claude/agents/video-reviewer.md leży w projekcie, więc jedzie w repozytorium jak .claude/settings.json z lekcji 8_4. Dokumentacja radzi trzymać agentów projektu w systemie kontroli wersji, żeby załoga mogła ich używać i ulepszać. Agentów tylko dla siebie trzymasz w ~/.claude/agents/, a przy tej samej nazwie wygrywa agent projektu. Pamiętaj też o rachunku z lekcji 5_10: według dokumentacji wywołania subagentów liczą się do tych samych limitów co główna rozmowa.
Następny krok
Poproś o commit, na przykład "Subagent video-reviewer i poprawka przełącznika kamery". Do mentora wyślesz zrzut działającego Treasure Reels, raport video-reviewer i jedno zdanie o tym, co poprawiłeś po przeglądzie.
W edytorze poniżej czeka raport recenzenta na komponencie z wyciekiem. Przy każdym punkcie zajrzyj do wskazanej linii, oceń go jako trafny albo fałszywy, a potem przełącz komponent na wersję po poprawce i sprawdź lampkę kamery.
Zapamiętaj: bosman z dobrą listą obejdzie olinowanie szybciej niż cała załoga, ale to kapitan sprawdza każdą linę, którą bosman wskazał, zanim każe ją wymienić.
Kod do tej lekcji: App.jsx
// Raport subagenta video-reviewer w miniaturze: sprawdź każde znalezisko w kodzie.
// Recenzent ma tylko Read, Grep i Glob, więc wskazuje linie, ale niczego nie zmienia.
import { useState } from 'react';
const BUGGY = [
'export function VideoRecorder() {',
' const [stream, setStream] = useState(null);',
' const [facing, setFacing] = useState("user");',
'',
' async function switchCamera() {',
' const next = facing === "user" ? "environment" : "user";',
' const media = await navigator.mediaDevices.getUserMedia({',
' video: { facingMode: next },',
' });',
' setFacing(next);',
' setStream(media);',
' }',
'',
' function disableCamera() {',
' setStream(null);',
' }',
' // ...podgląd i przyciski',
'}',
];
const FIXED = [
'export function VideoRecorder() {',
' const [stream, setStream] = useState(null);',
' const [facing, setFacing] = useState("user");',
'',
' useEffect(() => {',
' if (!stream) return;',
' return () => stream.getTracks().forEach((t) => t.stop());',
' }, [stream]);',
'',
' async function switchCamera() {',
' const next = facing === "user" ? "environment" : "user";',
' try {',
' const media = await navigator.mediaDevices.getUserMedia({',
' video: { facingMode: next },',
' });',
' setFacing(next);',
' setStream(media);',
' } catch (err) {',
' setError(cameraErrorMessage(err));',
' }',
' }',
' // ...podgląd i przyciski',
'}',
];
const FINDINGS = [
{ id: 1, line: 11, text: 'switchCamera podmienia strumień bez stop() na starych ścieżkach: stara kamera działa dalej.', real: true,
why: 'Trafny: w linii 11 jest tylko setStream(media), nigdzie nie ma getTracks().' },
{ id: 2, line: 15, text: 'disableCamera ustawia null, ale ścieżki nie dostają stop(): lampka świeci po wyłączeniu.', real: true,
why: 'Trafny: w pliku nie ma efektu ze sprzątaniem, który zatrzymałby ścieżki.' },
{ id: 3, line: 7, text: 'getUserMedia w switchCamera bez try/catch: odmowa dostępu nie daje komunikatu.', real: true,
why: 'Trafny: odrzucona obietnica nie trafia do żadnego komunikatu.' },
{ id: 4, line: 11, text: 'Brak URL.revokeObjectURL dla adresu podglądu: pamięć rośnie z każdym nagraniem.', real: false,
why: 'Fałszywy: w tym pliku nie ma createObjectURL, więc nie ma czego zwalniać. Grep po createObjectURL nic nie znajdzie.' },
];
export default function App() {
const [fixed, setFixed] = useState(false);
const [selected, setSelected] = useState(null);
const [verdicts, setVerdicts] = useState({});
const [mounted, setMounted] = useState(true);
const [liveTracks, setLiveTracks] = useState(0);
const [note, setNote] = useState('');
const lines = fixed ? FIXED : BUGGY;
function enable() {
if (!mounted) return;
setLiveTracks((n) => (fixed ? 1 : n + 1));
}
function switchCam() {
if (!mounted || liveTracks === 0) return;
setLiveTracks((n) => (fixed ? 1 : n + 1));
}
function disable() {
if (fixed) setLiveTracks(0);
}
function toggleMounted() {
if (mounted && fixed) setLiveTracks(0);
setMounted((m) => !m);
}
function changeVersion(next) {
setFixed(next);
setLiveTracks(0);
setMounted(true);
setSelected(null);
}
const lamp = liveTracks > 0;
return (
<div className="min-h-screen bg-gray-950 p-4 text-white flex flex-col gap-4 lg:flex-row">
<section className="lg:w-1/2">
<div className="mb-2 flex gap-2 text-sm">
<button type="button" onClick={() => changeVersion(false)} className={!fixed ? 'rounded bg-red-700 px-3 py-1' : 'rounded bg-gray-700 px-3 py-1'}>Wersja z błędem agenta</button>
<button type="button" onClick={() => changeVersion(true)} className={fixed ? 'rounded bg-green-700 px-3 py-1' : 'rounded bg-gray-700 px-3 py-1'}>Po poprawce</button>
</div>
<p className="text-xs text-gray-400">components/VideoRecorder.tsx (skrót)</p>
<pre className="overflow-x-auto rounded bg-gray-900 p-2 text-xs">
{lines.map((line, i) => (
<div key={i} className={selected === i + 1 ? 'bg-yellow-700' : ''}>
<span className="inline-block w-6 text-gray-500">{i + 1}</span>{line}
</div>
))}
</pre>
</section>
<section className="flex-1 space-y-3 text-sm">
<div>
<p className="font-semibold">Raport video-reviewer (tools: Read, Grep, Glob)</p>
{fixed ? (
<p className="rounded bg-gray-800 p-2">Drugi przebieg: wycieku kamery nie zgłoszono. Sprawdź lampkę, zanim w to uwierzysz.</p>
) : (
<ul className="space-y-2">
{FINDINGS.map((f) => (
<li key={f.id} className="rounded bg-gray-800 p-2">
<p>{f.id}. VideoRecorder.tsx:{f.line} - {f.text}</p>
<div className="mt-1 flex flex-wrap gap-2">
<button type="button" onClick={() => setSelected(f.line)} className="rounded bg-gray-700 px-2 py-1">Pokaż linię</button>
<button type="button" onClick={() => setVerdicts((v) => ({ ...v, [f.id]: true }))} className="rounded bg-gray-700 px-2 py-1">Trafny</button>
<button type="button" onClick={() => setVerdicts((v) => ({ ...v, [f.id]: false }))} className="rounded bg-gray-700 px-2 py-1">Fałszywy</button>
</div>
{f.id in verdicts && (
<p className={verdicts[f.id] === f.real ? 'mt-1 text-green-400' : 'mt-1 text-red-400'}>
{verdicts[f.id] === f.real ? 'Dobrze. ' : 'Sprawdź jeszcze raz. '}{f.why}
</p>
)}
</li>
))}
</ul>
)}
<button
type="button"
onClick={() => setNote('video-reviewer nie ma narzędzia Edit ani Write: tylko czyta. Poprawkę zlecasz w głównej sesji jednym wąskim poleceniem.')}
className="mt-2 rounded bg-amber-600 px-3 py-1 text-black"
>
Poproś recenzenta o poprawkę
</button>
{note && <p className="mt-1 text-amber-300">{note}</p>}
</div>
<div className="rounded bg-gray-900 p-2">
<p className="font-semibold">Udawana kamera</p>
<p>
Lampka kamery: <span className={lamp ? 'text-red-500' : 'text-gray-500'}>{lamp ? '● świeci' : '○ zgaszona'}</span>
{' '}| aktywne strumienie: {liveTracks} | komponent: {mounted ? 'na stronie' : 'odmontowany'}
</p>
<div className="mt-2 flex flex-wrap gap-2">
<button type="button" onClick={enable} className="rounded bg-gray-700 px-2 py-1">Włącz kamerę</button>
<button type="button" onClick={switchCam} className="rounded bg-gray-700 px-2 py-1">Obróć kamerę</button>
<button type="button" onClick={disable} className="rounded bg-gray-700 px-2 py-1">Wyłącz kamerę</button>
<button type="button" onClick={toggleMounted} className="rounded bg-gray-700 px-2 py-1">{mounted ? 'Wyjdź ze strony' : 'Wróć na stronę'}</button>
</div>
</div>
</section>
</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. Czym jest subagent w Claude Code?
2. Jak traktujesz raport subagenta video-reviewer?
To 2 z 6 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w pionie
Ułóż kroki pracy z własnym recenzentem video-reviewer:
- Układanie w poziomie
Ułóż ścieżkę pliku subagenta projektu:
- Klikanie w kolejności
Zbuduj linię, którą trasa oddaje okładkę z b64_json (klikaj po kolei):
- Układanie w pionie
Ułóż kroki trasy POST /api/cover w kolejności z kodu:
Zadania po tej lekcji
- PytanieCzym jest subagent
- Ułóż w kolejnościOd pliku agenta do commita
- PytanieRaport recenzenta to hipotezy
- PytanieNarzędzia recenzenta
- Ułóż w kolejnościPlik agenta w projekcie
- PytanieKlucz do API obrazów
- Kliknij w kolejnościOkładka jako adres data:
- PytaniePole description
- PytanieCzego recenzent nie zrobi
- Ułóż w kolejnościKroki trasy okładek
- Projekt do wysłaniaWyślij Treasure Reels do mentora
- WideoPodsumowanie modułu