// ユーザーが実験、探索、またはチュートリアル用の Jupyter ノートブック（`.ipynb`）を作成、スキャフォールド、または編集するよう依頼したときに使用します。バンドルされたテンプレートを優先し、ヘルパースクリプト `new_notebook.py` を実行してクリーンな開始ノートブックを生成してください。
[HINT] تحميل مجلد المهارة الكامل بما في ذلك SKILL.md وجميع الملفات المرتبطة
| name | jupyter-notebook |
| description | ユーザーが実験、探索、またはチュートリアル用の Jupyter ノートブック（`.ipynb`）を作成、スキャフォールド、または編集するよう依頼したときに使用します。バンドルされたテンプレートを優先し、ヘルパースクリプト `new_notebook.py` を実行してクリーンな開始ノートブックを生成してください。 |
クリーンで再現可能な Jupyter ノートブックを、主に次の2つのモード向けに作成します:
同梱のテンプレートとヘルパースクリプトを使うことで、一貫した構造を保ち、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）。
インテントを確定する。
ノートブックの種類（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
ノートブックには、実行可能な小さなステップを記述してください。 各コードセルは、1つのステップに焦点を絞ってください。 目的と期待される結果を説明する短いマークダウンセルを追加してください。 短い要約で済む場合は、長くて冗長な出力は避けてください。
適切なパターンを適用します。
実験については、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標準ライブラリのみを使用しており、追加の依存関係は不要です。
必須の環境変数はありません。
references/experiment-patterns.md: 実験の構成と経験則。references/tutorial-patterns.md: チュートリアルの構成と教育的な流れ。references/notebook-structure.md: ノートブックJSONの構造と安全な編集ルール。references/quality-checklist.md: 最終検証チェックリスト。免責事項： 本書はAI翻訳サービス「Co-op Translator」を使用して翻訳されました。正確さには努めていますが、自動翻訳には誤りや不正確な箇所が含まれる可能性があります。原文（原言語の文書）を正本としてご参照ください。重要な情報については、専門の人間による翻訳を推奨します。本翻訳の利用により生じたいかなる誤解や解釈の相違についても、当社は責任を負いません。