Jupyter Notebook įgūdis

Kurti tvarkingas, reprodukuojamas Jupyter užrašų knygeles dviem pagrindiniais režimais:

• Eksperimentai ir tyrinėjamoji analizė
• Pamokos ir mokymui skirtos žingsnis po žingsnio instrukcijos

Teikite pirmenybę pridedamiems šablonams ir pagalbiniam skriptui dėl nuoseklios struktūros ir mažiau JSON klaidų.

Kada naudoti

• Sukurti naują .ipynb užrašų knygelę nuo pradžių.
• Paversti užrašus ar skriptus į struktūrizuotą užrašų knygelę.
• Refaktorizuoti esamą užrašų knygelę, kad ji būtų labiau reprodukuojama ir lengvai peržvelgiama.
• Kurti eksperimentus ar pamokas, kurias skaitys ar vėl paleis kiti žmonės.

Sprendimų medis

• Jei užklausa yra tyrinėjamoji, analitinė arba grindžiama hipoteze, pasirinkite experiment.
• Jei užklausa yra instruktyvinė, žingsnis po žingsnio arba skirta konkrečiai auditorijai, pasirinkite tutorial.
• Redaguodami esamą užrašų knygelę, traktaukite tai kaip refaktoringą: išsaugokite paskirtį ir pagerinkite struktūrą.

Įgūdžio kelias (nustatyti vieną kartą)

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

Vartotojo lygio įgūdžiai įdiegiami po $CODEX_HOME/skills (numatytasis: ~/.codex/skills).

Darbo eiga

1. Užfiksuokite ketinimą. Nustatykite užrašų knygelės tipą: experiment arba tutorial. Apibrėžkite tikslą, auditoriją ir kaip atrodytų "užbaigta".

2. Sukurkite karkasą iš šablono. Naudokite pagalbinį skriptą, kad išvengtumėte rankinio notebook JSON rašymo.

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