jupyter-notebook - SKILL.md Agent Skill

name: jupyter-notebook description: Használható, amikor a felhasználó Jupyter notebookok (`.ipynb`) létrehozását, felépítését vagy szerkesztését kéri kísérletekhez, felfedezésekhez vagy oktatóanyagokhoz; részesítse előnyben a csomagolt sablonokat, és futtassa a segédprogramot `new_notebook.py`, hogy egy tiszta kezdő notebookot generáljon.

Jupyter Notebook készség

Hozzon létre tiszta, reprodukálható Jupyter notebookokat két fő módra:

Kísérletek és feltáró elemzés
Oktató és tanítás-centrikus bemutatók

Használja előnyben a beépített sablonokat és a segédscriptet az egységes felépítéshez és kevesebb JSON-hiba érdekében.

Mikor használjuk

Hozzon létre egy új .ipynb jegyzetfüzetet a semmiből.
Konvertáljon durva jegyzeteket vagy szkripteket strukturált jegyzetfüzetté.
Refaktoráljon egy meglévő jegyzetfüzetet, hogy reprodukálhatóbb és könnyebben átfutható legyen.
Építsen kísérleteket vagy oktatóanyagokat, amelyeket mások el fognak olvasni vagy újra futtatni.

Döntési fa

Ha a kérés feltáró, elemző vagy hipotézis-vezérelt, válassza a experiment módot.
Ha a kérés oktató jellegű, lépésről-lépésre vagy konkrét közönségre szabott, válassza a tutorial módot.
Ha meglévő jegyzetfüzetet szerkeszt, kezelje refaktorálásként: tartsa meg a szándékot és javítsa a szerkezetet.

Készségút (egyszer beállítandó)

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

User-scoped skills install under $CODEX_HOME/skills (default: ~/.codex/skills).

Munkafolyamat

Zárja le a szándékot. Identify the notebook kind: experiment or tutorial. Capture the objective, audience, and what "done" looks like.
Készítse el a vázlatot a sablonból. 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

Töltse fel a jegyzetfüzetet kis, futtatható lépésekkel. Keep each code cell focused on one step. Add short markdown cells that explain the purpose and expected result. Avoid large, noisy outputs when a short summary works.
Alkalmazza a megfelelő mintát. For experiments, follow references/experiment-patterns.md. For tutorials, follow references/tutorial-patterns.md.
Szerkesszen óvatosan, amikor meglévő jegyzetfüzetekkel dolgozik. Preserve the notebook structure; avoid reordering cells unless it improves the top-to-bottom story. Prefer targeted edits over full rewrites. If you must edit raw JSON, review references/notebook-structure.md first.
Érvényesítse az eredményt. Run the notebook top-to-bottom when the environment allows. If execution is not possible, say so explicitly and call out how to validate locally. Use the final pass checklist in references/quality-checklist.md.

Sablonok és segédscript

Templates live in assets/experiment-template.ipynb and assets/tutorial-template.ipynb.
A segédscript betölt egy sablont, frissíti a cím cellát, és kiír egy jegyzetfüzetet.

Script path:

$JUPYTER_NOTEBOOK_CLI (installed default: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)

Ideiglenes és kimeneti konvenciók

Use tmp/jupyter-notebook/ for intermediate files; delete when done.
Write final artifacts under output/jupyter-notebook/ when working in this repo.
Use stable, descriptive filenames (for example, ablation-temperature.ipynb).

Függőségek (telepítse csak ha szükséges)

Prefer uv for dependency management.

Optional Python packages for local notebook execution:

uv pip install jupyterlab ipykernel

A csomagolt vázoló script csak a Python standard könyvtárát használja, és nem igényel további függőségeket.

Környezet

Nincsenek kötelező környezeti változók.

Referencia térkép

references/experiment-patterns.md: kísérleti szerkezet és heurisztikák.
references/tutorial-patterns.md: oktatóanyag szerkezete és tanítási folyamat.
references/notebook-structure.md: a jegyzetfüzet JSON alakja és a biztonságos szerkesztési szabályok.
references/quality-checklist.md: végső érvényesítési ellenőrzőlista.

Felelősségkizárás: Ezt a dokumentumot a Co-op Translator mesterséges intelligencia alapú fordítószolgáltatás (https://github.com/Azure/co-op-translator) segítségével fordították le. Bár törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti, anyanyelvi dokumentum tekintendő a hiteles forrásnak. Fontos információk esetén javasolt hivatásos, emberi fordítást igénybe venni. Nem vállalunk felelősséget az ebből a fordításból eredő félreértésekért vagy téves értelmezésekért.