| name | jupyter-notebook |
| description | Uporabite, ko uporabnik prosi za ustvarjanje, pripravo ogrodja ali urejanje Jupyterjevih zvezkov (`.ipynb`) za poskuse, raziskovanja ali vadnice; prednost dajte priloženim predlogam in za ustvarjanje čistega začetnega zvezka zaženite pripomočni skript `new_notebook.py`. |
Spretnost Jupyter Notebook
Ustvarjajte čiste, ponovljive Jupyter zvezke za dva glavna načina:
- Eksperimenti in raziskovalna analiza
- Vadnice in učni vodniki
Raje uporabljajte priložene predloge in pomočni skript za dosledno strukturo in manj napak v JSON-u.
Kdaj uporabiti
- Ustvarite nov
.ipynb zvezek iz nič.
- Pretvorite grobe zapiske ali skripte v strukturiran zvezek.
- Refaktorirajte obstoječ zvezek, da bo bolj ponovljiv in lažje pregleden.
- Zgradite eksperimente ali vadnice, ki jih bodo drugi prebrali ali ponovno zagnali.
Drevo odločanja
- Če je zahteva raziskovalna, analitična ali vodena s hipotezo, izberite
experiment.
- Če je zahteva poučevalna, korak-po-koraku ali osredotočena na določeno občinstvo, izberite
tutorial.
- Če urejate obstoječi zvezek, ga obravnavajte kot refaktoriranje: ohranite namen in izboljšajte strukturo.
Pot spretnosti (nastavi enkrat)
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
Spretnosti, omejene na uporabnika, se namestijo pod $CODEX_HOME/skills (privzeto: ~/.codex/skills).
Potek dela
-
Zaklenite namen.
Določite vrsto zvezka: experiment ali tutorial.
Zabeležite cilj, občinstvo in kako izgleda "done".
-
Ustvarite ogrodje iz predloge.
Uporabite pomočni skript, da se izognete ročnemu ustvarjanju surovega JSON-a zvezka.
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
-
Zapolnite zvezek z majhnimi, izvedljivimi koraki.
Naj bo vsaka celica s kodo osredotočena na en korak.
Dodajte kratke markdown celice, ki pojasnijo namen in pričakovani rezultat.
Izogibajte se velikim, hrupnim izhodom, kadar zadostuje kratek povzetek.
-
Uporabite pravi vzorec.
Za eksperimente sledite references/experiment-patterns.md.
Za vadnice sledite references/tutorial-patterns.md.
-
Urejajte varno pri delu z obstoječimi zvezki.
Ohranite strukturo zvezka; izogibajte se prerazporejanju celic, razen če to izboljša zgodbo od zgoraj navzdol.
Raje izberite ciljane popravke kot popolne ponovne zapise.
Če morate urejati surov JSON, najprej preglejte references/notebook-structure.md.
-
Preverite rezultat.
Zaženite zvezek od vrha do dna, ko okolje to omogoča.
Če izvajanje ni mogoče, to izrecno navedite in pojasnite, kako preveriti lokalno.
Uporabite kontrolni seznam zadnjega pregleda v references/quality-checklist.md.
Predloge in pomočni skript
- Predloge se nahajajo v
assets/experiment-template.ipynb in assets/tutorial-template.ipynb.
- Pomožni skript naloži predlogo, posodobi celico z naslovom in zapiše zvezek.
Pot do skripta:
$JUPYTER_NOTEBOOK_CLI (privzeto nameščen: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)
Konvencije začasnih in izhodnih datotek
- Uporabljajte
tmp/jupyter-notebook/ za vmesne datoteke; izbrišite po končanju.
- Zapišite končne artefakte v
output/jupyter-notebook/, ko delate v tem repozitoriju.
- Uporabljajte stabilna, opisna imena datotek (na primer,
ablation-temperature.ipynb).
Odvisnosti (namestite le po potrebi)
Za upravljanje odvisnosti raje uporabljajte uv.
Neobvezni paketi Python za lokalno izvajanje zvezkov:
uv pip install jupyterlab ipykernel
Vgrajeni skript za ogrodje uporablja samo standardno knjižnico Pythona in ne zahteva dodatnih odvisnosti.
Okolje
Ni potrebnih okoljskih spremenljivk.
Zemljevid referenc
references/experiment-patterns.md: struktura eksperimenta in heuristike.references/tutorial-patterns.md: struktura vadnic in potek poučevanja.references/notebook-structure.md: obliko JSON-a zvezka in pravila varnega urejanja.references/quality-checklist.md: kontrolni seznam za končno preverjanje.
Izjava o omejitvi odgovornosti:
Ta dokument je bil preveden z uporabo storitve za prevajanje, ki temelji na umetni inteligenci, Co-op Translator. Čeprav si prizadevamo za natančnost, upoštevajte, da lahko avtomatizirani prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvor‑nem jeziku se šteje za avtoritativni vir. Za kritične informacije priporočamo strokovni človeški prevod. Ne odgovarjamo za morebitne nesporazume ali napačne razlage, ki izhajajo iz uporabe tega prevoda.
