// Kullanıcı deneyler, keşifler veya öğreticiler için Jupyter not defterleri (`.ipynb`) oluşturmasını, iskeletini hazırlamasını veya düzenlemesini istediğinde kullanın; birlikte gelen şablonları tercih edin ve temiz bir başlangıç not defteri oluşturmak için yardımcı betik `new_notebook.py`'yi çalıştırın.
[HINT] 下载包含 SKILL.md 和所有相关文件的完整技能目录
| name | jupyter-notebook |
| description | Kullanıcı deneyler, keşifler veya öğreticiler için Jupyter not defterleri (`.ipynb`) oluşturmasını, iskeletini hazırlamasını veya düzenlemesini istediğinde kullanın; birlikte gelen şablonları tercih edin ve temiz bir başlangıç not defteri oluşturmak için yardımcı betik `new_notebook.py`'yi çalıştırın. |
İki birincil mod için temiz, yeniden üretilebilir Jupyter defterleri oluşturun:
Tutarlı yapı ve daha az JSON hatası için paketlenmiş şablonları ve yardımcı betiği tercih edin.
.ipynb defteri sıfırdan oluşturun.experiment seçin.tutorial seçin.export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
Kullanıcı kapsamlı yetenekler $CODEX_HOME/skills altında yüklenir (varsayılan: ~/.codex/skills).
Niyeti kesinleştirin.
Belirleyin defter türünü: experiment veya tutorial.
Hedefi, kitleyi ve "tamamlanmış" durumunun nasıl görüneceğini yakalayın.
Şablondan iskelet oluşturun. Ham notebook JSON'unu elle yazmaktan kaçınmak için yardımcı betiği kullanın.
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
Defteri küçük, çalıştırılabilir adımlarla doldurun. Her kod hücresini tek bir adıma odaklı tutun. Amacı ve beklenen sonucu açıklayan kısa markdown hücreleri ekleyin. Kısa bir özet yeterliyse, büyük ve gürültülü çıktılardan kaçının.
Doğru deseni uygulayın.
Deneyler için şu belgeyi izleyin: references/experiment-patterns.md.
Öğreticiler için şu belgeyi izleyin: references/tutorial-patterns.md.
Mevcut defterlerle çalışırken güvenli düzenleme yapın.
Notebook yapısını koruyun; hücreleri baştan sona akışı iyileştirmiyorsa yeniden sıralamaktan kaçının.
Tam yeniden yazımlardan ziyade hedeflenmiş düzenlemeleri tercih edin.
Ham JSON'u düzenlemeniz gerekiyorsa önce şu belgeyi inceleyin: references/notebook-structure.md.
Sonucu doğrulayın.
Ortam izin verdiğinde defteri baştan sona çalıştırın.
Çalıştırma mümkün değilse bunu açıkça belirtin ve yerel olarak nasıl doğrulanacağını açıklayın.
Son kontrol listesini kullanın: references/quality-checklist.md.
assets/experiment-template.ipynb ve assets/tutorial-template.ipynb dizininde bulunur.Betik yolu:
$JUPYTER_NOTEBOOK_CLI (varsayılan kurulum: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)tmp/jupyter-notebook/ kullanın; işiniz bittiğinde silin.output/jupyter-notebook/ altında yazın.ablation-temperature.ipynb).Bağımlılık yönetimi için uv'yi tercih edin.
Yerel defter çalıştırması için isteğe bağlı Python paketleri:
uv pip install jupyterlab ipykernel
Paketlenmiş iskelet betiği yalnızca Python standart kütüphanesini kullanır ve ek bağımlılık gerektirmez.
Gerekli ortam değişkeni yok.
references/experiment-patterns.md: deney yapısı ve sezgisel kurallar.references/tutorial-patterns.md: öğretici yapısı ve öğretim akışı.references/notebook-structure.md: notebook JSON yapısı ve güvenli düzenleme kuralları.references/quality-checklist.md: son doğrulama kontrol listesi.Feragatname: Bu belge, AI çeviri hizmeti Co-op Translator (https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayın. Belgenin orijinal dilindeki metin yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucunda ortaya çıkabilecek herhangi bir yanlış anlama veya yanlış yorumlamadan sorumlu tutulamayız.