Competenze Jupyter Notebook

Crea notebook Jupyter puliti e riproducibili per due modalità principali:

• Esperimenti e analisi esplorativa
• Tutorial e percorsi didattici

Preferisci i template inclusi e lo script di supporto per una struttura coerente e meno errori nel JSON.

Quando usare

• Crea un nuovo notebook .ipynb da zero.
• Converti appunti grezzi o script in un notebook strutturato.
• Refattorizza un notebook esistente per renderlo più riproducibile e facile da scorrere.
• Crea esperimenti o tutorial che saranno letti o rieseguiti da altre persone.

Albero decisionale

• Se la richiesta è esplorativa, analitica o guidata da ipotesi, scegli experiment.
• Se la richiesta è istruttiva, passo-passo o specifica per un pubblico, scegli tutorial.
• Se stai modificando un notebook esistente, trattalo come una refattorizzazione: preserva l'intento e migliora la struttura.

Percorso di competenza (impostalo una volta)

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

Le skill a livello utente si installano sotto $CODEX_HOME/skills (default: ~/.codex/skills).

Flusso di lavoro

1. Definisci l'intento. Identifica il tipo di notebook: experiment o tutorial. Registra l'obiettivo, il pubblico e cosa significa 'fatto'.

2. Crea la struttura a partire dal template. Usa lo script di supporto per evitare di scrivere manualmente il JSON grezzo del notebook.

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