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.
Twórz czyste, odtwarzalne notatniki Jupyter dla dwóch głównych trybów:
Preferuj dołączone szablony i skrypt pomocniczy dla spójnej struktury i mniejszej liczby błędów JSON.
.ipynb od podstaw.experiment.tutorial.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).
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.
assets/experiment-template.ipynb i assets/tutorial-template.ipynb.Ścieżka skryptu:
$JUPYTER_NOTEBOOK_CLI (domyślnie zainstalowany: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)tmp/jupyter-notebook/ dla plików pośrednich; usuń po zakończeniu.output/jupyter-notebook/ gdy pracujesz w tym repozytorium.ablation-temperature.ipynb).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.
Brak wymaganych zmiennych środowiskowych.
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.