Naudokite, kai vartotojas prašo sukurti, paruošti arba redaguoti Jupyter užrašų knygeles (`.ipynb`) eksperimentams, tyrimams arba pamokoms; teikite pirmenybę pridedamiems šablonams ir paleiskite pagalbinį scenarijų `new_notebook.py`, kad sugeneruotumėte švarų pradinį užrašų knygelę.
Kurti tvarkingas, reprodukuojamas Jupyter užrašų knygeles dviem pagrindiniais režimais:
Teikite pirmenybę pridedamiems šablonams ir pagalbiniam skriptui dėl nuoseklios struktūros ir mažiau JSON klaidų.
.ipynb užrašų knygelę nuo pradžių.experiment.tutorial.export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
Vartotojo lygio įgūdžiai įdiegiami po $CODEX_HOME/skills (numatytasis: ~/.codex/skills).
Užfiksuokite ketinimą.
Nustatykite užrašų knygelės tipą: experiment arba tutorial.
Apibrėžkite tikslą, auditoriją ir kaip atrodytų "užbaigta".
Sukurkite karkasą iš šablono. Naudokite pagalbinį skriptą, kad išvengtumėte rankinio notebook JSON rašymo.
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
Užpildykite užrašų knygelę mažais, paleidžiamais žingsniais. Kiekvieną kodo ląstelę orientuokite į vieną žingsnį. Pridėkite trumpas markdown ląsteles, kurios paaiškina paskirtį ir tikėtiną rezultatą. Venkite didelių, triukšmingų išvesčių, kai pakanka trumpo santraukos.
Taikykite tinkamą modelį.
Eksperimentams vadovaukitės references/experiment-patterns.md.
Pamokoms vadovaukitės references/tutorial-patterns.md.
Redaguokite saugiai dirbdami su esamomis užrašų knygelėmis.
Išsaugokite užrašų knygelės struktūrą; venkite ląstelių pertvarkymo, nebent tai pagerina pasakojimą nuo viršaus žemyn.
Teikite pirmenybę tiksliems redagavimams, o ne pilniems perrašymams.
Jei privalote redaguoti neapdorotą JSON, pirmiausia peržiūrėkite references/notebook-structure.md.
Patikrinkite rezultatą.
Paleiskite užrašų knygelę nuo pradžios iki pabaigos, kai aplinka leidžia.
Jei vykdyti neįmanoma, aiškiai apie tai praneškite ir nurodykite, kaip patikrinti vietoje.
Naudokite galutinį patikros sąrašą references/quality-checklist.md.
assets/experiment-template.ipynb ir assets/tutorial-template.ipynb.Script path:
$JUPYTER_NOTEBOOK_CLI (įdiegtas numatytasis: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)tmp/jupyter-notebook/ tarpinėms byloms; ištrinkite pabaigus.output/jupyter-notebook/ dirbant šiame repozitorijoje.ablation-temperature.ipynb).Pirmenybę skirkite uv priklausomybių valdymui.
Pasirenkami Python paketai vietiniam užrašų knygelės vykdymui:
uv pip install jupyterlab ipykernel
Pridėtas šablono skriptas naudoja tik Python standartinę biblioteką ir nereikalauja papildomų priklausomybių.
Nėra privalomų aplinkos kintamųjų.
references/experiment-patterns.md: eksperimento struktūra ir heuristika.references/tutorial-patterns.md: pamokos struktūra ir mokymo eiga.references/notebook-structure.md: užrašų knygelės JSON forma ir saugaus redagavimo taisyklės.references/quality-checklist.md: galutinis patikrinimo sąrašas.Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, atkreipkite dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Dėl svarbios informacijos rekomenduojama kreiptis į profesionalų žmogaus vertimą. Mes neatsakome už jokius nesusipratimus ar neteisingą aiškinimą, kilusius dėl šio vertimo naudojimo.