tutorial-engineer

Skill, który przekształca skomplikowany kod i funkcje w przystępne materiały edukacyjne. Tworzysz tutoriale ze stopniowym ujawnianiem treści, praktycznymi ćwiczeniami i przewidywaniem typowych błędów. Idealny do przygotowania dokumentacji dla nowych członków zespołu, materiałów onboardingowych, kursów online i artykułów edukacyjnych. Zamiast suchej dokumentacji API, dostajesz lekcje, które uczeń rzeczywiście zrozumie i zapamiętuje.

1. Określ cel edukacyjny – czy chcesz stworzyć przewodnik onboardingowy dla nowego dewelopera, wyjaśnić złożoną funkcję, czy przygotować materiał do kursu online. Zdefiniuj, jakie koncepty chcesz nauczyć i dla kogo (początkujący, średniozaawansowani, eksperccy).

2. Przygotuj materiał źródłowy – dostarcz kod, bibliotekę lub funkcję, którą chcesz przekształcić w tutorial. Dołącz informacje o kontekście: co robi ten kod, jakie problemy rozwiązuje, jakie są wymagania wstępne.

3. Aktywuj skill i wskaż typ materiału – powiedz, czy potrzebujesz przewodnika krok po kroku, dokumentacji nauczającej (nie tylko referencyjnej), czy materiałów do warsztatu. Unikaj użycia tego skilla do tworzenia czystych dokumentów API – do tego służy inny tool.

4. Skill zastosuje praktyki pedagogiczne – będzie rozkładać treść na małe, zrozumiałe kroki, dodawać praktyczne ćwiczenia, przewidywać częste błędy i dostosowywać styl do różnych sposobów uczenia się (wizualny, tekstowy, praktyczny).

5. Zweryfikuj wynik – sprawdź, czy każdy krok jest jasny, czy ćwiczenia rzeczywiście utrwalają wiedzę, czy kolejność nauki ma sens. Jeśli potrzebujesz szczegółowych przykładów implementacji, otwórz plik resources/implementation-playbook.md z repozytorium.

6. Dostosuj i publikuj – edytuj tutorial do swoich potrzeb, dodaj własne przykłady lub kontekst branżowy, a następnie opublikuj na blogu, w dokumentacji, na platformie edukacyjnej lub wyślij zespołowi.