// استعمال کریں جب صارف تجربات، تحقیق، یا ٹیوٹوریلز کے لیے جیوپیٹر نوٹ بکس (`.ipynb`) بنانے، ڈھانچہ تیار کرنے، یا ایڈیٹ کرنے کو کہے؛ شامل ٹیمپلیٹس کو ترجیح دیں اور ایک صاف شروعاتی نوٹ بک تیار کرنے کے لیے مددگار اسکرپٹ `new_notebook.py` چلائیں۔
[HINT] 下载包含 SKILL.md 和所有相关文件的完整技能目录
| name | jupyter-notebook |
| description | استعمال کریں جب صارف تجربات، تحقیق، یا ٹیوٹوریلز کے لیے جیوپیٹر نوٹ بکس (`.ipynb`) بنانے، ڈھانچہ تیار کرنے، یا ایڈیٹ کرنے کو کہے؛ شامل ٹیمپلیٹس کو ترجیح دیں اور ایک صاف شروعاتی نوٹ بک تیار کرنے کے لیے مددگار اسکرپٹ `new_notebook.py` چلائیں۔ |
صاف، قابلِ تکرار Jupyter نوٹ بکس بنائیں دو بنیادی طریقوں کے لیے:
ہمیشہ مربوط سانچوں اور ہیلپر اسکرپٹ کو ترجیح دیں تاکہ ساخت مستقل رہے اور JSON کی غلطیاں کم ہوں۔
.ipynb نوٹ بک سکریچ سے بنائیں۔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).
ارادہ طے کریں۔
نوٹ بک کی قسم شناخت کریں: experiment یا tutorial۔
مقصد، سامعین، اور یہ واضح کریں کہ "مکمل" ہونا کیسا دکھتا ہے۔
سانچے سے خاکہ بنائیں۔ ہیلپر اسکرپٹ استعمال کریں تاکہ کچے نوٹ بک 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
نوٹ بک کو چھوٹے، چلانے کے قابل مراحل سے بھریں۔ ہر کوڈ سیل کو ایک ہی قدم تک محدود رکھیں۔ مختصر مارک ڈاؤن سیلز شامل کریں جو مقصد اور متوقع نتیجہ واضح کریں۔ جب مختصر خلاصہ کافی ہو تو بڑے، شور مچانے والے آؤٹ پٹ سے گریز کریں۔
درست پیٹرن اپنائیں۔
تجربات کے لیے، references/experiment-patterns.md کی پیروی کریں۔
ٹیوٹوریلز کے لیے، references/tutorial-patterns.md کی پیروی کریں۔
موجودہ نوٹ بکس پر کام کرتے وقت محفوظ طریقے سے ترمیم کریں۔
نوٹ بک کی ساخت برقرار رکھیں؛ سیلز کو دوبارہ ترتیب دینے سے گریز کریں مگر اگر یہ اوپر سے نیچے کی کہانی بہتر بنائے تو کریں۔
پورے دوبارہ لکھنے کے بجائے ہدف شدہ ترمیمات کو ترجیح دیں۔
اگر آپ کو کچا JSON ایڈٹ کرنا ضروری ہو، تو پہلے references/notebook-structure.md کا جائزہ لیں۔
نتیجہ کی توثیق کریں۔
ماحول اجازت دے تو نوٹ بک کو اوپر سے نیچے تک چلائیں۔
اگر اجرا ممکن نہ ہو تو براہِ راست بتائیں اور مقامی طور پر کیسے تصدیق کریں اس کی رہنمائی دیں۔
references/quality-checklist.md میں موجود فائنل پاس چیک لسٹ استعمال کریں۔
assets/experiment-template.ipynb اور assets/tutorial-template.ipynb میں موجود ہیں۔اسکرپٹ کا راستہ:
$JUPYTER_NOTEBOOK_CLI (انسٹال شدہ ڈیفالٹ: $CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)tmp/jupyter-notebook/ استعمال کریں؛ کام ختم ہونے پر حذف کر دیں۔output/jupyter-notebook/ کے تحت لکھیں۔ablation-temperature.ipynb)۔تدارکی انتظام کے لیے uv کو ترجیح دیں۔
مقامی نوٹ بک اجرا کے لیے اختیاری Python پیکجز:
uv pip install jupyterlab ipykernel
بندل شدہ اسکافولڈ اسکرپٹ صرف Python standard library استعمال کرتا ہے اور اضافی dependencies کی ضرورت نہیں رکھتا۔
کوئی ضروری محیطی متغیرات نہیں ہیں۔
references/experiment-patterns.md: تجربے کی ساخت اور حکمتِ عملی۔references/tutorial-patterns.md: ٹیوٹوریل کی ساخت اور تدریسی بہاؤ۔references/notebook-structure.md: نوٹ بک JSON کی شکل اور محفوظ ترمیم کے اصول۔references/quality-checklist.md: حتمی توثیق کی چیک لسٹ۔دستبرداری: اس دستاویز کا ترجمہ AI ترجمہ سروس Co-op Translator کی مدد سے کیا گیا ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہِ کرم ذہن میں رکھیں کہ خودکار تراجم میں غلطیاں یا عدمِ درستیاں ہو سکتی ہیں۔ اصل دستاویز کو اس کی مادری زبان میں ہی معتبر ماخذ سمجھا جانا چاہیے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ تجویز کیا جاتا ہے۔ ہم اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تعبیر کے لیے ذمہ دار نہیں ہیں۔