cookbook-audit

Umiejętność do audytu notebooków z kolekcji Anthropic Cookbook na podstawie wytycznych stylu i rubryk oceny. Automatycznie weryfikuje strukturę, cele edukacyjne, warunki wstępne i zawartość merytoryczną. Skanuje też kod pod kątem wycieków danych wrażliwych (klucze API, hasła). Generuje raport z oceną i konkretnymi rekomendacjami poprawy. Idealna dla zespołów utrzymujących dokumentację techniczną i notebooki edukacyjne.

1. Zainstaluj umiejętność w swoim środowisku Claude, upewniając się, że masz dostęp do pliku style_guide.md zawierającego wytyczne i szablony oceny.

2. Przygotuj ścieżkę do notebooka, który chcesz sprawdzić. Jeśli nie podasz jej od razu, umiejętność poprosi Cię o wskazanie lokalizacji pliku .ipynb.

3. Uruchom automatyczną walidację, wykonując polecenie python3 validate_notebook.py <ścieżka>. Skrypt automatycznie skanuje kod pod kątem hardkodowanych kluczy API i poświadczeń, porównując wyniki z bazą linii bazowej.

4. Przejrzyj wygenerowany plik markdown w folderze tmp/. Zawiera on kod notebooka w czytelnej formie (bez wyników wykonania), co ułatwia ocenę bez utraty kontekstu.

5. Przeprowadź ręczną ocenę, czytając markdown i porównując zawartość z wytycznymi z style_guide.md. Zwróć uwagę na strukturę wprowadzenia, cele edukacyjne (TLO i ELO), warunki wstępne, organizację treści i wnioski.

6. Oceń każdy wymiar zgodnie z rubryką, a następnie wygeneruj raport audytu z konkretnym wynikiem i rekomendacjami poprawy dla autora notebooka.