jupyter-notebook

Umiejętność do szybkiego generowania czystych, powtarzalnych notebooków Jupyter w formacie .ipynb. Wybierz między trybem eksperymentalnym (analiza, hipotezy) a tutorialowym (instrukcje krok po kroku), a następnie użyj wbudowanego skryptu pomocniczego, aby automatycznie utworzyć strukturę notebooka. Idealne do badań, dokumentacji i materiałów edukacyjnych, które będą czytane lub uruchamiane przez innych.

1. Ustaw zmienną środowiskową JUPYTER_NOTEBOOK_CLI, wskazującą na skrypt new_notebook.py. Domyślnie umiejętność instaluje się w ~/.codex/skills/jupyter-notebook/scripts/new_notebook.py. Jeśli używasz niestandardowej ścieżki CODEX_HOME, dostosuj ją odpowiednio.

2. Określ cel notebooka: czy będzie to eksperyment (analiza, testowanie hipotez) czy tutorial (instrukcje dla odbiorcy). Ta decyzja wpłynie na strukturę i styl zawartości.

3. Uruchom skrypt pomocniczy z parametrami --kind (experiment lub tutorial), --title (nazwa notebooka) i --out (ścieżka wyjściowa). Na przykład: uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" --kind experiment --title "Porównanie wariantów promptu" --out output/jupyter-notebook/

4. Skrypt wygeneruje czysty, gotowy do użytku notebook JSON, unikając błędów ręcznego formatowania. Notebook będzie zawierać wstępną strukturę komórek dostosowaną do wybranego trybu.

5. Otwórz wygenerowany plik .ipynb w Jupyter Lab lub Jupyter Notebook i uzupełnij zawartość (kod, wyjaśnienia, wyniki). Jeśli edytujesz istniejący notebook, użyj tej umiejętności do refaktoryzacji — zachowaj intencję, popraw strukturę.

6. Jeśli notebook będzie czytany przez innych lub uruchamiany wielokrotnie, upewnij się, że komórki są logicznie pogrupowane i zawierają wyjaśnienia. Umiejętność wspiera ten przepływ poprzez konsekwentne szablony.