// 사용자가 실험, 탐색 또는 튜토리얼을 위한 Jupyter 노트북(`.ipynb`)을 생성, 스캐폴딩하거나 편집해 달라고 요청할 때 사용합니다; 번들로 제공되는 템플릿을 우선 사용하고 깨끗한 시작 노트북을 생성하기 위해 헬퍼 스크립트 `new_notebook.py`를 실행하는 것을 권장합니다.
[HINT] تحميل مجلد المهارة الكامل بما في ذلك SKILL.md وجميع الملفات المرتبطة
| name | jupyter-notebook |
| description | 사용자가 실험, 탐색 또는 튜토리얼을 위한 Jupyter 노트북(`.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"
사용자 범위 스킬은 $CODEX_HOME/skills에 설치됩니다 (기본값: ~/.codex/skills).
Lock the intent.
Identify the notebook kind: experiment or tutorial.
Capture the objective, audience, and what "done" looks like.
Scaffold from the template. 템플릿으로부터 골격을 만드세요. 원시 노트북 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
Fill the notebook with small, runnable steps. 노트북을 작은 실행 가능한 단계들로 채우세요. 각 코드 셀은 한 단계에 집중되도록 하세요. 목적과 예상 결과를 설명하는 짧은 마크다운 셀을 추가하세요. 짧은 요약으로 충분한 경우 큰 소음이 많은 출력은 피하세요.
Apply the right pattern.
실험의 경우 references/experiment-patterns.md를 따르세요.
튜토리얼의 경우 references/tutorial-patterns.md를 따르세요.
Edit safely when working with existing notebooks.
기존 노트북 작업 시 안전하게 편집하세요.
노트북 구조를 보존하세요; 위에서 아래로의 흐름을 개선하지 않는 한 셀의 순서를 변경하지 마세요.
전체 재작성보다 목표 지향적인 편집을 선호하세요.
원시 JSON을 편집해야 한다면 먼저 references/notebook-structure.md를 검토하세요.
Validate the result.
결과를 검증하세요.
환경이 허용하면 노트북을 위에서 아래로 실행하세요.
실행이 불가능하면 이를 명시적으로 알리고 로컬에서 어떻게 검증할지 안내하세요.
마지막 점검 체크리스트는 references/quality-checklist.md를 사용하세요.
assets/experiment-template.ipynb 및 assets/tutorial-template.ipynb에 있습니다.Script path:
$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 표준 라이브러리만 사용하므로 추가 종속성이 필요하지 않습니다.
필수 환경 변수는 없습니다.
references/experiment-patterns.md: 실험 구조 및 휴리스틱.references/tutorial-patterns.md: 튜토리얼 구조 및 교육 흐름.references/notebook-structure.md: 노트북 JSON 형태 및 안전한 편집 규칙.references/quality-checklist.md: 최종 검증 체크리스트.면책사항: 이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있으나, 자동 번역에는 오류나 부정확성이 포함될 수 있음을 유의하시기 바랍니다. 원래 언어로 된 원문을 권위 있는 출처로 간주해야 합니다. 중요한 정보에 대해서는 전문 번역가에 의한 번역을 권장합니다. 본 번역의 사용으로 인해 발생하는 어떠한 오해나 잘못된 해석에 대해서도 당사는 책임을 지지 않습니다.