jupyter-notebook - SKILL.md Agent Skill

name: jupyter-notebook description: Użyj, gdy użytkownik prosi o utworzenie, przygotowanie szkieletu lub edycję notatników Jupyter (`.ipynb`) do eksperymentów, eksploracji lub samouczków; preferuj dołączone szablony i uruchom skrypt pomocniczy `new_notebook.py`, aby wygenerować czysty notebook początkowy.

Umiejętność Jupyter Notebook

Twórz czyste, odtwarzalne notatniki Jupyter dla dwóch głównych trybów:

Eksperymenty i analiza eksploracyjna
Samouczki i przewodniki skoncentrowane na nauczaniu

Preferuj dołączone szablony i skrypt pomocniczy dla spójnej struktury i mniejszej liczby błędów JSON.

Kiedy używać

Utwórz nowy notatnik .ipynb od podstaw.
Przekształć surowe notatki lub skrypty w uporządkowany notatnik.
Refaktoryzuj istniejący notatnik, aby był bardziej odtwarzalny i łatwiejszy do przeglądania.
Twórz eksperymenty lub samouczki, które będą czytane lub ponownie uruchamiane przez innych.

Drzewo decyzyjne

Jeśli prośba ma charakter eksploracyjny, analityczny lub oparty na hipotezie, wybierz experiment.
Jeśli prośba ma charakter instruktażowy, krok po kroku lub jest skierowana do konkretnej grupy odbiorców, wybierz tutorial.
Jeśli edytujesz istniejący notatnik, traktuj to jako refaktoryzację: zachowaj zamiar i udoskonal strukturę.

Ścieżka umiejętności (ustaw raz)

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"

Umiejętności na poziomie użytkownika instalują się w $CODEX_HOME/skills (domyślnie: ~/.codex/skills).

Przepływ pracy

Ustal zamiar. Określ rodzaj notatnika: experiment lub tutorial. Określ cel, odbiorców i to, jak wygląda „zrobione”.
Rozpocznij od szablonu. Użyj skryptu pomocniczego, aby uniknąć ręcznego tworzenia surowego JSON notatnika.

uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
  --kind experiment \
  --title "Compare prompt variants" \
  --out output/jupyter-notebook/compare-prompt-variants.ipynb

uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
  --kind tutorial \
  --title "Intro to embeddings" \
  --out output/jupyter-notebook/intro-to-embeddings.ipynb

Wypełnij notatnik małymi, uruchamialnymi krokami. Utrzymuj każdą komórkę kodu skoncentrowaną na jednym kroku. Dodaj krótkie komórki Markdown, które wyjaśniają cel i oczekiwany rezultat. Unikaj dużych, hałaśliwych wyników, gdy wystarczy krótkie podsumowanie.
Zastosuj odpowiedni wzorzec. Dla eksperymentów przestrzegaj references/experiment-patterns.md. Dla samouczków przestrzegaj references/tutorial-patterns.md.
Edytuj bezpiecznie podczas pracy z istniejącymi notatnikami. Zachowaj strukturę notatnika; unikaj zmiany kolejności komórek, chyba że poprawia to opowieść od góry do dołu. Preferuj ukierunkowane poprawki zamiast pełnych przeróbek. Jeśli musisz edytować surowy JSON, najpierw przejrzyj references/notebook-structure.md.
Zweryfikuj wynik. Uruchom notatnik od początku do końca, gdy środowisko na to pozwala. Jeśli wykonanie nie jest możliwe, powiedz to wprost i opisz, jak zweryfikować lokalnie. Użyj listy kontrolnej końcowego przeglądu w references/quality-checklist.md.

Szablony i skrypt pomocniczy

Szablony znajdują się w assets/experiment-template.ipynb i assets/tutorial-template.ipynb.
Skrypt pomocniczy ładuje szablon, aktualizuje komórkę z tytułem i zapisuje notatnik.

Ścieżka skryptu:

$JUPYTER_NOTEBOOK_CLI (domyślnie zainstalowany: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)

Konwencje dla plików tymczasowych i wyników

Używaj tmp/jupyter-notebook/ dla plików pośrednich; usuń po zakończeniu.
Zapisuj końcowe artefakty w output/jupyter-notebook/ gdy pracujesz w tym repozytorium.
Używaj stabilnych, opisowych nazw plików (na przykład, ablation-temperature.ipynb).

Zależności (instaluj tylko gdy potrzeba)

Preferuj uv do zarządzania zależnościami.

Opcjonalne pakiety Pythona do lokalnego uruchamiania notatników:

uv pip install jupyterlab ipykernel

Dołączony skrypt szablonowy używa tylko standardowej biblioteki Pythona i nie wymaga dodatkowych zależności.

Środowisko

Brak wymaganych zmiennych środowiskowych.

Mapa odniesień

references/experiment-patterns.md: struktura eksperymentu i heurystyki.
references/tutorial-patterns.md: struktura samouczku i przebieg nauczania.
references/notebook-structure.md: kształt JSON notatnika i zasady bezpiecznej edycji.
references/quality-checklist.md: lista kontrolna końcowej walidacji.

Zastrzeżenie: Niniejszy dokument został przetłumaczony przy użyciu usługi tłumaczeniowej AI Co-op Translator (https://github.com/Azure/co-op-translator). Chociaż dokładamy starań o poprawność, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub niedokładności. Oryginalny dokument w języku źródłowym powinien być traktowany jako dokument wiążący. W przypadku informacji krytycznych zaleca się skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za ewentualne nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia.