Jupyter Notebook

ជំនាញ Jupyter Notebook

បង្កើតកំណត់ត្រា Jupyter ដែលស្អាត និងអាចសែតឡើងវិញសម្រាប់របៀបធ្វើការចម្បងពីរការ៖

• ការសាកល្បង និងវិភាគស្វែងរក
• មេរៀន និងដំណើរការណែនាំសម្រាប់បង្រៀន

ផ្តល់អាទិភាពដល់ទំរង់ដែលភ្ជាប់មក និងស្គ្រីបជំនួយសម្រាប់រចនាសម្ព័ន្ធមានតុល្យភាព និងកំហុស JSON តិចជាង។

ពេលណាដែលត្រូវប្រើ

• បង្កើតកំណត់ត្រាថ្មី .ipynb ពីចន្លោះសូន្យ។
• បម្លែងកំណត់សម្គាល់មាំមួនឬស្គ្រីបទៅជាកំណត់ត្រាមានរចនាសម្ព័ន្ធ។
• ប្ដូររៀបចំកំណត់ត្រាដែលមានស្រាប់ ដើម្បីឲ្យអាចអង្កកឡើងវិញបាន និងអានបានយ៉ាងស្រួល។
• ស្ថាបនាការសាកល្បងឬមេរៀនដែលនឹងត្រូវបានអាន ឬអនុវត្តឡើងវិញដោយមនុស្សផ្សេងទៀត។

ដំណើរការសម្រេចចិត្ត

• បើសំណើមានលក្ខណៈស្វែងរក វិភាគ ឬដឹកនាំដោយសន្មត់ យក experiment។
• បើសំណើមានលក្ខណៈបណ្តុះបណ្តាល ជាជំហានៗ ឬផ្តោតលើប្រិយមិត្ត យក tutorial។
• បើកំពុងកែសម្រួលកំណត់ត្រាដែលមានស្រាប់ សូមប្រព្រឹត្តទៅដូចជា refactor: រក្សាចេតនា និងធ្វើឱ្យរចនាសម្ព័ន្ធប្រសើរឡើង។

គន្លងជំនាញ (កំណត់ម្តង)

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).

ដំណើរការ

1. កំណត់គោលបំណង. Identify the notebook kind: experiment or tutorial. Capture the objective, audience, and what "done" looks like.

2. ដាក់ស៊្គេឡេតពីទំរង់. 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

3. បំពេញកំណត់ត្រាទៅដោយជំហានតូចៗដែលអាចរត់បាន. រក្សាឲ្យប្រអប់កូដមួយនីមួយៗផ្ដោតលើជំហានតែមួយ។ បន្ថែមកោសិកាតំណភាសាខ្លីៗដែលពន្យល់ពីគោលដៅ និងលទ្ធផលរំពឹងទុក។ ជៀសវាងលទ្ធផលធំៗដែលមានសំឡេងពុម្ពពិសេសពេលដែលសេចក្តីសង្ខេបខ្លីគ្រាន់គឺបានជួយ។

4. អនុវត្តលំនាំត្រឹមត្រូវ។ សម្រាប់ការសាកល្បង, អនុយោគទៅ references/experiment-patterns.md។ សម្រាប់មេរៀន, អនុយោគទៅ references/tutorial-patterns.md។

5. កែសម្រួលយ៉ាងមានសុវត្ថិភាពเมื่อធ្វើការជាមួយកំណត់ត្រាដែលមានស្រាប់។ រក្សាសម្ព័ន្ធកំណត់ត្រា; ជៀសវាងការប្តូរលំដាប់កូសិកុំនៅពេលដែលវាមិនធ្វើឱ្យរឿងរ៉ាវពីលើទៅក្រោមប្រសើរឡើយ។ ផ្ដល់អាទិភាពចំពោះការកែប្រែចំណុចជាក់លាក់ជាងការសរសេរឡើងវិញទាំងមូល។ បើអ្នកចាំបាច់ត្រូវកែ JSON ដើម សូមពិនិត្យ references/notebook-structure.md មុន។

6. ផ្ទៀងផ្ទាត់លទ្ធផល។ រត់កំណត់ត្រាពីលើទៅក្រោមនៅពេលដែលបរិស្ថានអនុញ្ញាត។ បើមិនអាចអនុវត្តបាន សូមប្រាប់យ៉ាងច្បាស់ ហើយបង្ហាញវិធីធ្វើផ្ទៀងផ្ទាត់ក្នុងកម្រិតតំបន់។ ប្រើបញ្ជីពិនិត្យលើកចុងក្រោយនៅក្នុង references/quality-checklist.md។

ទម្រង់និងស្គ្រីបជំនួយ

• ទម្រង់រស់នៅក្នុង assets/experiment-template.ipynb និង assets/tutorial-template.ipynb។
• ស្គ្រីបជំនួយនឹងបង្ហាញទំរង់មួយ អាប់ដេតកោសិកា​ចំណងជើង និងសរសេរកំណត់ត្រាមួយ។

Script path:

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

ការកំណត់ថតបណ្ដោះអាសន្ន និងលទ្ធផល

• ប្រើ tmp/jupyter-notebook/ សម្រាប់ឯកសាររវល់; លុបវាយេលប់រួច។
• សរសេររឿងសិល្បៈចុងក្រោយក្រោម output/jupyter-notebook/ នៅពេលធ្វើការ​នៅក្នុងឃ្លាំងនេះ។
• ប្រើឈ្មោះឯកសារដែលមានស្ថិតិភាព និងពិពណ៌នា (ឧទាហរណ៍, ablation-temperature.ipynb)។

ពឹងផ្អែក (ដំឡើងតែពេលចាំបាច់)

ផ្តល់អាទិភាពចំពោះ uv សម្រាប់ការគ្រប់គ្រងការពឹងផ្អែក។

Optional Python packages for local notebook execution:

uv pip install jupyterlab ipykernel

The bundled scaffold script uses only the Python standard library and does not require extra dependencies.

បរិយាកាស

គ្មានអថេរបរិយាកាសចាំបាច់។

ផែនទីយោង

• references/experiment-patterns.md: រចនាសម្ព័ន្ធនៃការសាកល្បង និងការណែនាំវិធីសាស្ត្រ។
• references/tutorial-patterns.md: រចនាសម្ព័ន្ធមេរៀន និងលំហាត់នៃការបង្រៀន។
• references/notebook-structure.md: រូបរាង JSON នៃកំណត់ត្រា និងច្បាប់កែសម្រួលយ៉ាងមានសុវត្ថិភាព។
• references/quality-checklist.md: បញ្ជីពិនិត្យផ្ទៀងផ្ទាត់ចុងក្រោយ។

ការបដិសេធទំនួលខុសត្រូវ: ឯកសារនេះត្រូវបានបកប្រែដោយប្រើសេវាបកប្រែ AI Co-op Translator។ ខណៈពេលដែលយើងខិតខំស្វែងរកភាពត្រឹមត្រូវ សូមយល់ដឹងថាការបកប្រែដោយស្វ័យប្រវត្តិសាច់សោអាចមានកំហុស ឬមិនត្រឹមត្រូវបាន។ ឯកសារដើមក្នុងភាសាម្ចាស់គួរត្រូវបានទទួលស្គាល់ថាជាដើមទុនដែលមានអំណាចដាក់សេចក្តីបញ្ជាក់។ សម្រាប់ព័ត៌មានសំខាន់ៗ យើងសូមណែនាំឲ្យប្រើការបកប្រែដោយមនុស្សជំនាញវិជ្ជាជីវៈ។ យើងមិនទទួលខុសត្រូវចំពោះការយល់ច្រឡំ ឬការបកស្រាយខុសដែលកើតមានពីការប្រើប្រាស់ការបកប្រែនេះឡើយ។