Jupyter Notebook

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. Закључајте намеру. Идентификујте врсту бележнице: experiment или tutorial. Запишите циљ, публику и шта значи да је задатак завршен.

2. Изградите скелет из шаблона. Користите помоћну скрипту како бисте избегли ручно писање сировог 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

3. Попуните бележницу малим корацима који се могу покренути. Сваку ћелију са кодом усмерите на један корак. Додајте кратке markdown ћелије које објашњавају сврху и очекивани резултат. Избегавајте велике и "шумне" излазе када је довољан кратак резиме.

4. Примените прави образац. За експерименте пратите references/experiment-patterns.md. За туторијале пратите references/tutorial-patterns.md.

5. Уредите безбедно када радите са постојећим бележницама. Сачувајте структуру бележнице; избегавајте мењање редоследа ћелија осим ако то не унапређује причу од врха ка дну. Преферирајте циљане измене уместо потпуних преписивања. Ако морате да уређујете сирови JSON, прво прегледајте references/notebook-structure.md.

6. Верификујте резултат. Покрените бележницу од врха ка дну када окружење то омогућава. Ако извршавање није могуће, наведите то јасно и објасните како верификовати локално. Користите листу за коначан преглед у references/quality-checklist.md.

Шаблони и помоћна скрипта

• Шаблони се налазе у assets/experiment-template.ipynb и assets/tutorial-template.ipynb.
• Помоћна скрипта учитава шаблон, ажурира ћелију са насловом и уписује бележницу.

Пут до скрипте:

• $JUPYTER_NOTEBOOK_CLI (инсталиран подразумевано: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)

Конвенције за привремене и излазне фајлове

• Користите tmp/jupyter-notebook/ за привремене фајлове; обришите када завршите.
• Запишите коначне артефакте у output/jupyter-notebook/ када радите у овом репозиторијуму.
• Користите стабилне, описне називе фајлова (на пример, ablation-temperature.ipynb).

Зависности (инсталирати само када је потребно)

Преферирајте uv за управљање зависностима.

Опционе Python библиотеке за локално извршавање бележнице:

uv pip install jupyterlab ipykernel

Укључена скелетна скрипта користи само Python стандардну библиотеку и не захтева додатне зависности.

Окружење

Нема обавезних променљивих окружења.

Мапа референци

• references/experiment-patterns.md: структура експеримента и хеуристике.
• references/tutorial-patterns.md: структура туторијала и наставни ток.
• references/notebook-structure.md: облик notebook JSON-а и правила безбедног уређивања.
• references/quality-checklist.md: контролна листа за коначну валидацију.

Одрицање одговорности: Овај документ је преведен помоћу сервиса за превођење заснованог на вештачкој интелигенцији Co-op Translator. Иако тежимо тачности, имајте у виду да аутоматски преводи могу да садрже грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати званичним извором. За критичне информације препоручује се професионалан људски превод. Не сносимо одговорност за било какве неспоразуме или погрешне тумачења која произилазе из коришћења овог превода.