Bruges når brugeren beder om at oprette, opsætte eller redigere Jupyter-notebooks (`.ipynb`) til eksperimenter, udforskninger eller vejledninger; foretræk de medfølgende skabeloner og kør hjælpeskriptet `new_notebook.py` for at generere en ren start-notebook.
Opret rene, reproducerbare Jupyter-notebooks til to primære tilstande:
Brug helst de medfølgende skabeloner og hjælpeprogrammet for konsistent struktur og færre JSON-fejl.
.ipynb-notebook fra bunden.experiment.tutorial.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).
Fastlæg intentionen.
Identify the notebook kind: experiment or tutorial.
Capture the objective, audience, and what "done" looks like.
Scaffold fra skabelonen. 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
Fyld notebooken med små, kørbare trin. Hold hver kodecelle fokuseret på ét trin. Tilføj korte markdown-celler, der forklarer formålet og forventet resultat. Undgå store, støjende outputs når et kort sammendrag er tilstrækkeligt.
Anvend det rigtige mønster.
For eksperimenter, følg references/experiment-patterns.md.
For vejledninger, følg references/tutorial-patterns.md.
Rediger forsigtigt når du arbejder med eksisterende notebooks.
Bevar notebook-strukturen; undgå at omarrangere celler medmindre det forbedrer fortællingen fra top til bund.
Foretræk målrettede rettelser frem for fulde omskrivninger.
Hvis du er nødt til at redigere rå JSON, gennemgå references/notebook-structure.md først.
Valider resultatet.
Kør notebooken fra top til bund når miljøet tillader det.
Hvis kørsel ikke er muligt, sig det eksplicit og beskriv hvordan man validerer lokalt.
Brug den endelige tjekliste i references/quality-checklist.md.
assets/experiment-template.ipynb og assets/tutorial-template.ipynb.Scriptsti:
$JUPYTER_NOTEBOOK_CLI (installeret som standard: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)tmp/jupyter-notebook/ til midlertidige filer; slet når du er færdig.output/jupyter-notebook/ når du arbejder i dette repo.ablation-temperature.ipynb).Foretræk uv til afhængighedsstyring.
Valgfrie Python-pakker til lokal notebook-udførelse:
uv pip install jupyterlab ipykernel
Det medfølgende scaffold-script bruger kun Python-standardbiblioteket og kræver ikke ekstra afhængigheder.
Ingen krævede miljøvariabler.
references/experiment-patterns.md: struktur for eksperimenter og heuristikker.references/tutorial-patterns.md: vejledningsstruktur og undervisningsforløb.references/notebook-structure.md: notebookens JSON-form og regler for sikker redigering.references/quality-checklist.md: endelig tjekliste for validering.Ansvarsfraskrivelse: Dette dokument er blevet oversat ved hjælp af AI-oversættelsestjenesten Co-op Translator. Selvom vi bestræber os på nøjagtighed, skal du være opmærksom på, at automatiske oversættelser kan indeholde fejl eller unøjagtigheder. Det oprindelige dokument på originalsproget bør anses for den autoritative kilde. For kritisk information anbefales en professionel menneskelig oversættelse. Vi er ikke ansvarlige for eventuelle misforståelser eller fejltolkninger, der opstår som følge af brugen af denne oversættelse.