Použite, keď používateľ požiada o vytvorenie, vygenerovanie kostry alebo úpravu Jupyter notebookov (`.ipynb`) pre experimenty, prieskumy alebo tutoriály; uprednostnite zabudované šablóny a spustite pomocný skript `new_notebook.py` na vygenerovanie čistého východiskového notebooku.
Vytvárajte čisté, reprodukovateľné Jupyter notebooky pre dva hlavné režimy:
Uprednostňujte dodávané šablóny a pomocný skript pre konzistentnú štruktúru a menej chýb v JSON.
.ipynb notebook od začiatku.experiment.tutorial.export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
Zručnosti obmedzené na používateľa sa inštalujú do $CODEX_HOME/skills (predvolené: ~/.codex/skills).
Uzamknite zámer.
Určite typ notebooku: experiment alebo tutorial.
Zaznamenajte cieľ, publikum a to, ako vyzerá „hotovo“.
Vytvorte kostru zo šablóny. Použite pomocný skript, aby ste sa vyhli ručnému písaniu surového JSON notebooku.
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
Vyplňte notebook malými, spustiteľnými krokmi. Udržujte každú kódovú bunku zameranú na jeden krok. Pridajte krátke markdown bunky, ktoré vysvetlia účel a očakávaný výsledok. Vyhnite sa veľkým, hlučným výstupom, keď postačuje krátke zhrnutie.
Použite správny vzor.
Pre experimenty postupujte podľa references/experiment-patterns.md.
Pre tutoriály postupujte podľa references/tutorial-patterns.md.
Pri práci s existujúcimi notebookmi upravujte bezpečne.
Zachovajte štruktúru notebooku; vyhnite sa preusporiadaniu buniek, pokiaľ to nezlepší príbeh zhora nadol.
Uprednostňujte cielené úpravy pred úplnými prepismi.
Ak musíte upravovať surový JSON, najprv si prezrite references/notebook-structure.md.
Overte výsledok.
Spustite notebook od začiatku do konca, keď to prostredie umožňuje.
Ak vykonanie nie je možné, uveďte to explicitne a popíšte, ako overiť lokálne.
Použite kontrolný zoznam finálnej kontroly v references/quality-checklist.md.
assets/experiment-template.ipynb a assets/tutorial-template.ipynb.Cesta ku skriptu:
$JUPYTER_NOTEBOOK_CLI (predvolené umiestnenie inštalácie: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)tmp/jupyter-notebook/ pre medzistupňové súbory; po dokončení ich odstráňte.output/jupyter-notebook/ pri práci v tomto repozitári.ablation-temperature.ipynb).Uprednostňujte uv na správu závislostí.
Voliteľné Python balíky pre lokálne spúšťanie notebooku:
uv pip install jupyterlab ipykernel
Dodávaný scaffold skript používa iba štandardnú knižnicu Pythonu a nevyžaduje ďalšie závislosti.
Nie sú potrebné žiadne premenné prostredia.
references/experiment-patterns.md: štruktúra experimentu a heuristiky.references/tutorial-patterns.md: štruktúra tutoriálu a výukový tok.references/notebook-structure.md: tvar JSON notebooku a pravidlá bezpečnej úpravy.references/quality-checklist.md: kontrolný zoznam finálneho overenia.Vyhlásenie o zodpovednosti: Tento dokument bol preložený pomocou AI prekladateľskej služby Co-op Translator. Hoci sa snažíme o presnosť, berte prosím na vedomie, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v jeho pôvodnom jazyku by sa mal považovať za rozhodujúci zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.