Умение за Jupyter Notebook

Създавайте чисти, възпроизводими Jupyter бележници за два основни режима:

• Експерименти и изследователски анализ
• Уроци и ръководства, ориентирани към обучение

Предпочитайте вградените шаблони и помощния скрипт за последователна структура и по-малко грешки в JSON.

Кога да използвате

• Създайте нов .ipynb бележник от нулата.
• Конвертирайте неполни бележки или скриптове в структуриран бележник.
• Рефакторирайте съществуващ бележник, за да бъде по-възпроизводим и лесен за преглед.
• Създавайте експерименти или уроци, които ще бъдат прочетени или преизпълнени от други хора.

Дърво на решенията

• Ако заявката е изследователска, аналитична или хипотетично-ориентирана, изберете experiment.
• Ако заявката е инструктивна, стъпка по стъпка или насочена към конкретна аудитория, изберете tutorial.
• Ако редактирате съществуващ бележник, третирайте го като рефакториране: запазете намерението и подобрете структурата.

Път на умението (за настройка веднъж)

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

Потребителските умения се инсталират под $CODEX_HOME/skills (по подразбиране: ~/.codex/skills).

Работен процес

1. Lock the intent. Identify the notebook kind: experiment or tutorial. Capture the objective, audience, and what "done" looks like.

2. Scaffold from the template. Use the helper script to avoid hand-authoring raw notebook JSON.

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