用途:在用户要求创建、搭建或编辑 Jupyter Notebook(.ipynb)时使用,面向实验/探索分析和教程/教学两类主要模式。
主要能力:从零创建新 .ipynb;把粗略笔记或脚本转成结构化笔记本;将已有笔记本重构得更可复现、更易浏览;构建供他人阅读或重跑的实验与教程。
使用方式:先确定类型——探索、分析或假设驱动选 experiment;教学、分步或面向特定读者选 tutorial;编辑已有笔记本按重构处理,保留原意、改进结构。可通过辅助脚本从模板生成,避免手写原始 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 路径设置:export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}";export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"。技能安装在 $CODEX_HOME/skills。填充时保持每个代码单元只做一步,配简短 markdown 说明目的与预期结果,避免冗长输出。
适用场景与限制:模板位于 assets/experiment-template.ipynb 与 assets/tutorial-template.ipynb;参考文档包括 references/experiment-patterns.md、references/tutorial-patterns.md、references/notebook-structure.md、references/quality-checklist.md。临时文件放 tmp/jupyter-notebook/,最终产物放 output/jupyter-notebook/,文件名稳定描述性。需要本地执行时可用 uv pip install jupyterlab ipykernel;脚手架脚本仅用 Python 标准库,无需额外依赖。无必需环境变量。环境允许时应从上到下运行验证,无法执行需明确说明并指出本地验证方法。编辑已有笔记本优先定点修改而非整体重写,如需改原始 JSON 先查阅 notebook-structure.md。其他收费、平台或价格信息暂未提供。